{ "description": "Search the TikTok DSA ad library in 33 European markets and/or the global Creative Center Top Ads. No login, cookies or proxy setup needed.", "properties": { "adIds": { "default": [], "description": "Direct list of TikTok ad IDs. Skips search and opens each ad's detail page. (mode=library)", "editor": "stringList", "prefill": [], "title": "Ad IDs", "type": "array" }, "adStatus": { "default": "active", "description": "Active ads are still being shown; inactive ads have stopped. (mode=library)", "editor": "select", "enum": [ "all", "active", "inactive" ], "enumTitles": [ "All statuses", "Active", "Inactive" ], "prefill": "active", "title": "Ad status", "type": "string" }, "adType": { "default": "all", "description": "Filter by creative type. (mode=library)", "editor": "select", "enum": [ "all", "video", "image", "text" ], "enumTitles": [ "All ad types", "Video", "Image", "Text" ], "prefill": "all", "title": "Ad type", "type": "string" }, "advertiserId": { "description": "Optional TikTok business ID (`adv_biz_ids`) to disambiguate an advertiser search. Use it with the exact advertiser name. (mode=library)", "editor": "textfield", "title": "Advertiser business ID", "type": "string" }, "advertiserName": { "description": "Exact advertiser name as shown in the library, e.g. `NIKE Retail B.V.`. If the exact search finds nothing, the actor retries it as a keyword. (mode=library)", "editor": "textfield", "title": "Exact advertiser name", "type": "string" }, "age": { "default": [], "description": "Only ads targeted at any of these age groups: `13-17`, `18-24`, `25-34`, `35-44`, `45-54`, `55+`. Leave empty for all ages. (mode=library)", "editor": "stringList", "prefill": [], "title": "Audience age", "type": "array" }, "ccCountry": { "default": "US", "description": "Creative Center market. (mode=creativeCenter or both)", "editor": "select", "enum": [ "AR", "AU", "BR", "CA", "CO", "FR", "DE", "ID", "IT", "JP", "MY", "MX", "NL", "PK", "PH", "RO", "SA", "SG", "ZA", "KR", "ES", "SE", "TH", "TR", "AE", "GB", "US", "VN" ], "enumTitles": [ "Argentina", "Australia", "Brazil", "Canada", "Colombia", "France", "Germany", "Indonesia", "Italy", "Japan", "Malaysia", "Mexico", "Netherlands", "Pakistan", "Philippines", "Romania", "Saudi Arabia", "Singapore", "South Africa", "South Korea", "Spain", "Sweden", "Thailand", "Turkey", "United Arab Emirates", "United Kingdom", "United States", "Vietnam" ], "prefill": "US", "title": "Top Ads country", "type": "string" }, "ccIncludeDetails": { "default": true, "description": "Fetch each ad's landing page, comment and share counts. (mode=creativeCenter or both)", "prefill": false, "title": "Fetch Top Ads details", "type": "boolean" }, "ccIndustry": { "default": "all", "description": "Creative Center industry filter. 258 industries are available; leave `all` to sweep without an industry. (mode=creativeCenter or both)", "editor": "select", "enum": [ "all", "label_11105000000", "label_18110000000", "label_25300000000", "label_22000000000", "label_24118000000", "label_23113000000", "label_23124000000", "label_20112000000", "label_24112000000", "label_18101000000", "label_19105000000", "label_14105000000", "label_20104000000", "label_27104000000", "label_25302000000", "label_12104000000", "label_15101000000", "label_24113000000", "label_18107000000", "label_23130000000", "label_26000000000", "label_15000000000", "label_17106000000", "label_19100000000", "label_23102000000", "label_25303000000", "label_19102000000", "label_23127000000", "label_13111000000", "label_14101000000", "label_24100000000", "label_26107000000", "label_23128000000", "label_20109000000", "label_24103000000", "label_20101000000", "label_13110000000", "label_25308000000", "label_21999000000", "label_22109000000", "label_20999000000", "label_27101000000", "label_28101000000", "label_13108000000", "label_23107000000", "label_11999000000", "label_23133000000", "label_21104000000", "label_11107000000", "label_16102000000", "label_15106000000", "label_24119000000", "label_18100000000", "label_13101000000", "label_11110000000", "label_22112000000", "label_24117000000", "label_26100000000", "label_28000000000", "label_23112000000", "label_10000000000", "label_10100000000", "label_12101000000", "label_23100000000", "label_25304000000", "label_23132000000", "label_30000000000", "label_11109000000", "label_14100000000", "label_18000000000", "label_11104000000", "label_11106000000", "label_23122000000", "label_10104000000", "label_12109000000", "label_20108000000", "label_26113000000", "label_15107000000", "label_16105000000", "label_21102000000", "label_26109000000", "label_23125000000", "label_27000000000", "label_19101000000", "label_24110000000", "label_30102000000", "label_25311000000", "label_11100000000", "label_17103000000", "label_17105000000", "label_22101000000", "label_23117000000", "label_10101000000", "label_20100000000", "label_13114000000", "label_23000000000", "label_29999000000", "label_10105000000", "label_13100000000", "label_20000000000", "label_24102000000", "label_10106000000", "label_16100000000", "label_24101000000", "label_23103000000", "label_12106000000", "label_25310000000", "label_16000000000", "label_23126000000", "label_26101000000", "label_14999000000", "label_15105000000", "label_20102000000", "label_23110000000", "label_26102000000", "label_10999000000", "label_15100000000", "label_23116000000", "label_23118000000", "label_24109000000", "label_25313000000", "label_23123000000", "label_13999000000", "label_25312000000", "label_24116000000", "label_26104000000", "label_25305000000", "label_17000000000", "label_26105000000", "label_14106000000", "label_11101000000", "label_19000000000", "label_25999000000", "label_25306000000", "label_27103000000", "label_12108000000", "label_13113000000", "label_25000000000", "label_13117000000", "label_22107000000", "label_26114000000", "label_23101000000", "label_16999000000", "label_20106000000", "label_14104000000", "label_21100000000", "label_11112000000", "label_21103000000", "label_11102000000", "label_23114000000", "label_12107000000", "label_30101000000", "label_23134000000", "label_26106000000", "label_11111000000", "label_18106000000", "label_25309000000", "label_18111000000", "label_13104000000", "label_13109000000", "label_22106000000", "label_18112000000", "label_20107000000", "label_10103000000", "label_29101000000", "label_15102000000", "label_13102000000", "label_21105000000", "label_23131000000", "label_24114000000", "label_11000000000", "label_21101000000", "label_23108000000", "label_26108000000", "label_19104000000", "label_11108000000", "label_14102000000", "label_18104000000", "label_28100000000", "label_23115000000", "label_12103000000", "label_13116000000", "label_16104000000", "label_25301000000", "label_24108000000", "label_24120000000", "label_22111000000", "label_13103000000", "label_18108000000", "label_23105000000", "label_26103000000", "label_12999000000", "label_22113000000", "label_27999000000", "label_24999000000", "label_13112000000", "label_29102000000", "label_19106000000", "label_24104000000", "label_24107000000", "label_23104000000", "label_14107000000", "label_23119000000", "label_27102000000", "label_12102000000", "label_20103000000", "label_20111000000", "label_16101000000", "label_13000000000", "label_22102000000", "label_26111000000", "label_26999000000", "label_12000000000", "label_20110000000", "label_13107000000", "label_23109000000", "label_19103000000", "label_18102000000", "label_24106000000", "label_27100000000", "label_12105000000", "label_23111000000", "label_23106000000", "label_24000000000", "label_18103000000", "label_18109000000", "label_19999000000", "label_15104000000", "label_18999000000", "label_26112000000", "label_13105000000", "label_13115000000", "label_18105000000", "label_22105000000", "label_22108000000", "label_11103000000", "label_24115000000", "label_29103000000", "label_12100000000", "label_17999000000", "label_14000000000", "label_21000000000", "label_22999000000", "label_15999000000", "label_23129000000", "label_24111000000", "label_20105000000", "label_25307000000", "label_23999000000", "label_24105000000", "label_12110000000", "label_10102000000", "label_15103000000", "label_30100000000", "label_14103000000", "label_29000000000", "label_29100000000", "label_22110000000" ], "enumTitles": [ "All industries", "Used Cars", "Cleaning Supplies", "Hyper-Casual", "Apparel & Accessories", "Auction Services", "Anime", "Food & Cooking", "Utilities", "Marketing & Advertising", "Daily Essentials", "Pet Toys", "Aesthetic Medicine", "Education", "Cooking & Recipes", "Casino", "Baby Bedding", "Computers", "Professional Consultation", "Tissues & Wet Wipes", "Real Estate Information", "Life Services", "Tech & Electronics", "Travel Agencies & Services", "Petfood", "Business & Economy", "Match", "Pet Household Products", "General Information", "Loan Services", "Haircare", "Real Estate & Home Rentals", "Used Good Sales Platforms", "E-commerce Information", "Health & Fitness", "Constructional Engineering", "Audio & Video Players", "Investment Advisory", "Simulation", "Other Home Improvement", "Men's Shoes", "Other Apps", "Food & Fresh Produce", "Sports & Equipment", "Credit Bureaus", "Environmental Protection", "Other Vehicle & Transportation", "Tourist Information", "Home Decor", "Bicycles", "Large Appliances", "Network Products", "Investment Planning & Management", "Storage Products", "Securities", "Airplanes", "Traditional & Ceremonial Clothing", "Legal Services", "Wedding Photography", "Sports & Outdoor", "TV Drama & Series", "Education", "Early Childhood & Preschool Education", "Strollers & Cribs", "Military", "Puzzle", "Streaming Site", "E-Commerce (Non-app)", "Water Vehicles", "Oral Care", "Household Products", "Car Rentals", "Motorcycles", "Beauty & Personal Care", "Vocational Training", "Children's Apparel", "Travel", "Exercise & Fitness", "Office Equipment", "Digital Devices", "Construction Materials & Lighting", "Utilities Payments", "Games & Utility Software", "Food & Beverage", "Pet Healthcare", "Safety & Security", "Large E-commerce Platforms", "Party", "Automobiles", "Hotels & Accommodation", "Tours & Attractions", "Clothing Accessories", "TV Variety Shows", "Primary & Secondary Education & K-12", "Social", "Third-Party Payments", "News & Entertainment", "Other Health", "Language Training", "Commercial Banks", "Apps", "Recruitment & Job Searching", "Non-academic Training (Hobbies)", "Personal Care Appliances", "Office Equipment & Supplies", "Science & Technology", "Toys for Kids", "Strategy", "Appliances", "Car Information", "Photography", "Other Beauty & Personal Care", "Computer Accessories", "News & Reading", "Live Events", "Dating & Matchmaking Services", "Other Education", "Cell Phones", "Culture & Art", "Reading", "Energy Conservation & Environmental Protection", "Kids", "Sports & Fitness", "Other Financial Services", "Tabletop", "IT Services", "Gifts & Flowers", "Racing", "Travel", "Housekeeping", "Fragrances & Perfumes", "Auto Accessories", "Pets", "Other", "RPG", "Alcoholic Beverages", "Baby Feeding Supplies", "Precious Metals", "Games", "Credit Cards", "High-end Jewelry", "Beauty & Personal Care", "Politics", "Other Appliances", "Financial Services", "Cosmetics", "Interior Design & Decorating Services", "Car Dealerships", "Hardware & Electrical", "Auto Services", "Astrology", "Child Car Seats", "Small & Medium-sized E-commerce Platforms", "Social Media Account Promotion", "Shopping Services", "Accessories for 2/3-Wheeled Vehicles", "Cleaning Appliances", "Sports", "Toys", "Guarantees", "Microfinance Companies", "Ordinary Jewelry", "Pest Control", "Life & Leisure", "Overseas Education", "Medical Information", "Computers Components", "Insurance", "Power Strips & Socket", "Relationship Information", "Exhibition Services", "Vehicle & Transportation", "Furniture", "Celebrities & Gossip", "Gardening", "Pet Treats", "Electric Scooters", "Wig & Hair Styling", "Coffee Accessories", "Outdoor Equipment", "Humor", "Diapers & Baby Wipes", "Cryptocurrencies", "Home Appliances", "Action", "Agriculture, Forestry, Animal Husbandry & Fishing", "Individual Entrepreneurship", "Women's Shoes", "Trusts", "Laundry", "Charity & Public Welfare", "Wedding Celebrations", "Other Baby, Kids & Maternity", "Wearable Tech Devices", "Other Food & Beverage", "Other Business Services", "Foreign Exchange Transactions", "Dietary Supplements", "Pet Travel Accessories", "Electronics & Electrical", "Franchising", "Culture & History", "Feminine Care", "Movies", "Non-alcoholic Beverages", "Baby Formula", "Photography", "Parenting", "Kitchen & Bathroom Appliances", "Financial Services", "Bags", "Internet Services", "Other Life Services", "Baby, Kids & Maternity", "Business & Productivity", "Funds", "Lifestyle News", "Pet Grooming", "Glasses & Drinkware", "Machinery & Equipment", "Cuisine", "Baby Shoes", "Collectables & Antiques", "Law", "Business Services", "Tea Sets", "Leather Care", "Other Pets", "Gaming Devices", "Other Household Products", "Consumer Services", "Pawn Shops", "Crowd Funding", "Kitchen Accessories", "Watches", "Men's Clothing", "Auto Parts", "Service Outsourcing", "Medicine", "Baby Food", "Other Travel", "Beauty & Personal Care", "Home Improvement", "Other Apparel & Accessories", "Other Tech & Electronics", "Pet Information", "Logistics", "Online Shopping", "Shooting", "Other News & Entertainment", "Chemical Materials", "Baby Hygiene Products", "Higher Education", "Computer Repair", "Big Box Retailers", "Skincare", "Health", "Medical Services", "Women's Clothing" ], "prefill": "all", "title": "Top Ads industry", "type": "string" }, "ccLanguage": { "default": "all", "description": "Ad language filter. (mode=creativeCenter or both)", "editor": "select", "enum": [ "all", "en", "es", "ar", "vi", "th", "de", "id", "pt", "fr", "ms", "nl", "ja", "it", "ro", "zh-Hant", "ko" ], "enumTitles": [ "All languages", "English", "Spanish", "Arabic", "Vietnamese", "Thai", "German", "Indonesian", "Portuguese", "French", "Malay", "Dutch", "Japanese", "Italian", "Romanian", "Chinese (Traditional)", "Korean" ], "prefill": "all", "title": "Top Ads language", "type": "string" }, "ccObjective": { "default": "all", "description": "Campaign objective filter. (mode=creativeCenter or both)", "editor": "select", "enum": [ "all", "1", "2", "3", "4", "5", "8", "15", "16" ], "enumTitles": [ "All objectives", "Traffic", "App Installs", "Conversions", "Video Views", "Reach", "Lead Generation", "Product sales", "App Promotion" ], "prefill": "all", "title": "Top Ads objective", "type": "string" }, "ccOrderBy": { "default": "for_you", "description": "How Creative Center ranks ads. (mode=creativeCenter or both)", "editor": "select", "enum": [ "for_you", "ctr", "like" ], "enumTitles": [ "For You", "Click-through rate", "Likes" ], "prefill": "for_you", "title": "Top Ads ranking", "type": "string" }, "ccPeriod": { "default": "30", "description": "Performance window for Creative Center. (mode=creativeCenter or both)", "editor": "select", "enum": [ "7", "30", "180" ], "enumTitles": [ "Last 7 days", "Last 30 days", "Last 180 days" ], "prefill": "30", "title": "Top Ads period", "type": "string" }, "ccSweep": { "default": true, "description": "Anonymous visitors see only 20 ads per filter combination. Sweeping periods, rankings, objectives and formats collects many more unique ads. (mode=creativeCenter or both)", "prefill": false, "title": "Sweep Top Ads filters", "type": "boolean" }, "countOnly": { "default": false, "description": "Return one summary row with the number of matching ads instead of collecting ads. (mode=library)", "prefill": false, "title": "Count only", "type": "boolean" }, "endDate": { "description": "Latest last-shown date (`YYYY-MM-DD`). Default: today. (mode=library)", "editor": "textfield", "title": "Last shown to", "type": "string" }, "exactPhrase": { "default": false, "description": "Treat the keyword as an exact phrase instead of individual words. (mode=library)", "prefill": false, "title": "Exact phrase", "type": "boolean" }, "gender": { "default": "all", "description": "Only ads targeted at this gender. (mode=library)", "editor": "select", "enum": [ "all", "female", "male" ], "enumTitles": [ "All genders", "Female", "Male" ], "prefill": "all", "title": "Audience gender", "type": "string" }, "includeDetails": { "default": true, "description": "Open each ad's detail page for caption, CTA, landing page, advertiser identity and age/gender reach breakdown. Slower; recommended for smaller runs. (mode=library)", "prefill": false, "title": "Fetch ad details", "type": "boolean" }, "keyword": { "default": "", "description": "Search ads by keyword or advertiser name. Leave empty to browse recent ads in the selected region. (mode=library)", "editor": "textfield", "prefill": "Nike", "title": "Keyword", "type": "string" }, "maxItems": { "default": 50, "description": "Maximum records to collect per source (1–5,000). TikTok caps a single library search at about 5,000 results.", "maximum": 5000, "minimum": 1, "prefill": 3, "title": "Max items", "type": "integer" }, "mode": { "default": "library", "description": "`library` = TikTok DSA Commercial Content Library (EU/EEA/UK/CH/TR). `creativeCenter` = global Top Ads inspiration feed. `both` = run both and label every row with `source`.", "editor": "select", "enum": [ "library", "creativeCenter", "both" ], "enumTitles": [ "DSA ad library", "Creative Center Top Ads", "Both sources" ], "prefill": "library", "title": "Data source", "type": "string" }, "region": { "default": "all", "description": "TikTok DSA library covers EU/EEA countries plus the UK, Switzerland and Turkey. `all` searches the union (capped by TikTok), so split regions for deeper runs. (mode=library)", "editor": "select", "enum": [ "all", "AT", "BE", "BG", "CH", "CY", "CZ", "DE", "DK", "EE", "ES", "FI", "FR", "GB", "GR", "HR", "HU", "IE", "IS", "IT", "LI", "LT", "LU", "LV", "MT", "NL", "NO", "PL", "PT", "RO", "SE", "SI", "SK", "TR" ], "enumTitles": [ "All supported countries", "Austria", "Belgium", "Bulgaria", "Switzerland", "Cyprus", "Czech Republic", "Germany", "Denmark", "Estonia", "Spain", "Finland", "France", "United Kingdom", "Greece", "Croatia", "Hungary", "Ireland", "Iceland", "Italy", "Liechtenstein", "Lithuania", "Luxembourg", "Latvia", "Malta", "Netherlands", "Norway", "Poland", "Portugal", "Romania", "Sweden", "Slovenia", "Slovakia", "Turkey" ], "prefill": "DE", "title": "Ad target country", "type": "string" }, "sortBy": { "default": "last_shown_date,desc", "description": "Result order. (mode=library)", "editor": "select", "enum": [ "last_shown_date,desc", "last_shown_date,asc", "create_time,desc", "create_time,asc", "impression,desc", "impression,asc" ], "enumTitles": [ "Last shown — newest first", "Last shown — oldest first", "Created — newest first", "Created — oldest first", "Audience size — high to low", "Audience size — low to high" ], "prefill": "last_shown_date,desc", "title": "Sort by", "type": "string" }, "startDate": { "description": "Earliest last-shown date (`YYYY-MM-DD`). Default: one year ago. (mode=library)", "editor": "textfield", "title": "Last shown from", "type": "string" }, "startUrls": { "default": [], "description": "Paste TikTok library search or ad-detail URLs. Search URLs carry their own region, keyword/advertiser, dates and filters; detail URLs are read as ad IDs. (mode=library)", "editor": "requestListSources", "prefill": [], "title": "TikTok library URLs", "type": "array" }, "uniqueReach": { "default": "all", "description": "Filter by TikTok's unique-users-seen band. (mode=library)", "editor": "select", "enum": [ "all", "under10k", "10k-100k", "over100k" ], "enumTitles": [ "All reach bands", "Under 10K", "10K–100K", "Over 100K" ], "prefill": "all", "title": "Unique reach", "type": "string" } }, "required": [], "schemaVersion": 1, "title": "TikTok DSA Ads Transparency Library Input", "type": "object" }