{ "description": "Collect TikTok Creative Center Top Ads by market, period, industry, objective, language, ad format, like percentile, and ranking. No login or cookies required.", "properties": { "adFormat": { "default": "", "description": "Spark ads are boosted organic posts; Non-Spark ads are regular in-feed ads.", "editor": "select", "enum": [ "", "1", "2" ], "enumTitles": [ "All ad formats", "Spark ads", "Non-Spark ads" ], "prefill": "", "title": "Ad format", "type": "string" }, "adIds": { "default": [], "description": "Ad IDs or Creative Center URLs to refresh. Used only in 'Specific ads' mode.", "editor": "stringList", "items": { "type": "string" }, "prefill": [], "sectionCaption": "Specific ads", "sectionDescription": "Only used when Mode is Specific ad IDs.", "title": "Specific ad IDs", "type": "array" }, "country": { "default": "US", "description": "122 supported markets. All countries reads multiple market boards and merges the results; it uses more requests.", "editor": "select", "enum": [ "", "AL", "DZ", "AO", "AR", "AM", "AU", "AT", "AZ", "BH", "BD", "BY", "BE", "BO", "BA", "BW", "BR", "BN", "BG", "KH", "CM", "CA", "CL", "CO", "CR", "CI", "HR", "CY", "CZ", "DK", "DO", "EC", "EG", "SV", "EE", "ET", "FI", "FR", "GE", "DE", "GH", "GR", "GT", "JO", "HN", "HK", "HU", "IN", "ID", "IQ", "IE", "IL", "IT", "JM", "JP", "KZ", "KE", "KW", "KG", "LA", "LV", "LB", "LY", "MY", "MV", "MU", "MX", "MD", "MN", "ME", "MA", "MZ", "MM", "NA", "NL", "NZ", "NI", "NG", "MK", "NO", "OM", "PK", "PS", "PA", "PY", "PE", "PH", "PL", "PT", "PR", "QA", "LT", "RO", "SA", "SN", "RS", "SG", "SK", "SI", "ZA", "KR", "ES", "LK", "SD", "SE", "CH", "TW", "TJ", "TZ", "TH", "TT", "TN", "TR", "UG", "AE", "GB", "US", "UY", "VE", "VN", "YE", "ZM", "ZW" ], "enumTitles": [ "All countries (sweep 122 markets)", "Albania", "Algeria", "Angola", "Argentina", "Armenia", "Australia", "Austria", "Azerbaijan", "Bahrain", "Bangladesh", "Belarus", "Belgium", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Brazil", "Brunei", "Bulgaria", "Cambodia", "Cameroon", "Canada", "Chile", "Colombia", "Costa Rica", "Cote d'Ivoire", "Croatia", "Cyprus", "Czechia", "Denmark", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Estonia", "Ethiopia", "Finland", "France", "Georgia", "Germany", "Ghana", "Greece", "Guatemala", "Hashemite Kingdom of Jordan", "Honduras", "Hong Kong", "Hungary", "India", "Indonesia", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Kazakhstan", "Kenya", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Libya", "Malaysia", "Maldives", "Mauritius", "Mexico", "Moldova", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar", "Namibia", "Netherlands", "New Zealand", "Nicaragua", "Nigeria", "North Macedonia", "Norway", "Oman", "Pakistan", "Palestine", "Panama", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Republic of Lithuania", "Romania", "Saudi Arabia", "Senegal", "Serbia", "Singapore", "Slovakia", "Slovenia", "South Africa", "South Korea", "Spain", "Sri Lanka", "Sudan", "Sweden", "Switzerland", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Trinidad and Tobago", "Tunisia", "Turkey", "Uganda", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Venezuela", "Vietnam", "Yemen", "Zambia", "Zimbabwe" ], "prefill": "US", "title": "Country", "type": "string" }, "includeDetails": { "default": true, "description": "Add landing page, target countries, comments, shares, and source (one extra request per ad).", "prefill": false, "sectionCaption": "Ad details", "sectionDescription": "Optional enrichment requests.", "title": "Include ad details", "type": "boolean" }, "includeKeyframes": { "default": false, "description": "Add the per-second retention curve (one extra request per ad).", "prefill": false, "title": "Include retention curve", "type": "boolean" }, "industry": { "default": "", "description": "TikTok's industry taxonomy. Child categories are shown under their parent.", "editor": "select", "enum": [ "", "label_22000000000", "label_22102000000", "label_22101000000", "label_22107000000", "label_22108000000", "label_22109000000", "label_22106000000", "label_22999000000", "label_22112000000", "label_22105000000", "label_22113000000", "label_22110000000", "label_22111000000", "label_16000000000", "label_16105000000", "label_16104000000", "label_16101000000", "label_16102000000", "label_16999000000", "label_16100000000", "label_20000000000", "label_20101000000", "label_20110000000", "label_20104000000", "label_20106000000", "label_20109000000", "label_20107000000", "label_20102000000", "label_20105000000", "label_20999000000", "label_20111000000", "label_20103000000", "label_20100000000", "label_20108000000", "label_20112000000", "label_12000000000", "label_12104000000", "label_12108000000", "label_12100000000", "label_12102000000", "label_12110000000", "label_12105000000", "label_12107000000", "label_12109000000", "label_12103000000", "label_12999000000", "label_12101000000", "label_12106000000", "label_14000000000", "label_14105000000", "label_14104000000", "label_14107000000", "label_14106000000", "label_14101000000", "label_14100000000", "label_14999000000", "label_14103000000", "label_14102000000", "label_24000000000", "label_24108000000", "label_24118000000", "label_24105000000", "label_24103000000", "label_24104000000", "label_24109000000", "label_24114000000", "label_24107000000", "label_24120000000", "label_24119000000", "label_24116000000", "label_24117000000", "label_24111000000", "label_24106000000", "label_24112000000", "label_24101000000", "label_24999000000", "label_24113000000", "label_24100000000", "label_24102000000", "label_24110000000", "label_24115000000", "label_30000000000", "label_30100000000", "label_30102000000", "label_30101000000", "label_10000000000", "label_10100000000", "label_10102000000", "label_10105000000", "label_10106000000", "label_10999000000", "label_10103000000", "label_10101000000", "label_10104000000", "label_13000000000", "label_13100000000", "label_13108000000", "label_13117000000", "label_13115000000", "label_13116000000", "label_13112000000", "label_13107000000", "label_13104000000", "label_13102000000", "label_13110000000", "label_13111000000", "label_13109000000", "label_13999000000", "label_13105000000", "label_13113000000", "label_13101000000", "label_13114000000", "label_13103000000", "label_27000000000", "label_27103000000", "label_27104000000", "label_27100000000", "label_27101000000", "label_27102000000", "label_27999000000", "label_25000000000", "label_25301000000", "label_25302000000", "label_25300000000", "label_25313000000", "label_25303000000", "label_25999000000", "label_25311000000", "label_25304000000", "label_25305000000", "label_25306000000", "label_25307000000", "label_25308000000", "label_25309000000", "label_25310000000", "label_25312000000", "label_29000000000", "label_29102000000", "label_29101000000", "label_29100000000", "label_29103000000", "label_29999000000", "label_21000000000", "label_21102000000", "label_21101000000", "label_21103000000", "label_21104000000", "label_21100000000", "label_21999000000", "label_21105000000", "label_18000000000", "label_18106000000", "label_18110000000", "label_18104000000", "label_18101000000", "label_18102000000", "label_18105000000", "label_18108000000", "label_18109000000", "label_18999000000", "label_18112000000", "label_18100000000", "label_18103000000", "label_18107000000", "label_18111000000", "label_26000000000", "label_26114000000", "label_26112000000", "label_26102000000", "label_26113000000", "label_26108000000", "label_26104000000", "label_26105000000", "label_26111000000", "label_26999000000", "label_26101000000", "label_26106000000", "label_26107000000", "label_26109000000", "label_26103000000", "label_26100000000", "label_23000000000", "label_23113000000", "label_23114000000", "label_23122000000", "label_23102000000", "label_23126000000", "label_23108000000", "label_23105000000", "label_23111000000", "label_23116000000", "label_23104000000", "label_23128000000", "label_23107000000", "label_23124000000", "label_23125000000", "label_23127000000", "label_23115000000", "label_23106000000", "label_23109000000", "label_23110000000", "label_23100000000", "label_23119000000", "label_23999000000", "label_23129000000", "label_23101000000", "label_23118000000", "label_23130000000", "label_23131000000", "label_23103000000", "label_23134000000", "label_23123000000", "label_23132000000", "label_23133000000", "label_23112000000", "label_23117000000", "label_19000000000", "label_19999000000", "label_19103000000", "label_19101000000", "label_19102000000", "label_19105000000", "label_19106000000", "label_19104000000", "label_19100000000", "label_28000000000", "label_28100000000", "label_28101000000", "label_15000000000", "label_15100000000", "label_15105000000", "label_15103000000", "label_15101000000", "label_15102000000", "label_15104000000", "label_15106000000", "label_15107000000", "label_15999000000", "label_17000000000", "label_17103000000", "label_17999000000", "label_17105000000", "label_17106000000", "label_11000000000", "label_11111000000", "label_11110000000", "label_11101000000", "label_11103000000", "label_11102000000", "label_11100000000", "label_11107000000", "label_11112000000", "label_11104000000", "label_11108000000", "label_11106000000", "label_11999000000", "label_11105000000", "label_11109000000" ], "enumTitles": [ "All industries", "Apparel & Accessories", "Apparel & Accessories > Bags", "Apparel & Accessories > Clothing Accessories", "Apparel & Accessories > High-end Jewelry", "Apparel & Accessories > Men's Clothing", "Apparel & Accessories > Men's Shoes", "Apparel & Accessories > Ordinary Jewelry", "Apparel & Accessories > Other Apparel & Accessories", "Apparel & Accessories > Traditional & Ceremonial Clothing", "Apparel & Accessories > Watches", "Apparel & Accessories > Wearable Tech Devices", "Apparel & Accessories > Women's Clothing", "Apparel & Accessories > Women's Shoes", "Appliances", "Appliances > Digital Devices", "Appliances > Home Appliances", "Appliances > Kitchen & Bathroom Appliances", "Appliances > Large Appliances", "Appliances > Other Appliances", "Appliances > Personal Care Appliances", "Apps", "Apps > Audio & Video Players", "Apps > Business & Productivity", "Apps > Education", "Apps > Financial Services", "Apps > Health & Fitness", "Apps > Life & Leisure", "Apps > News & Reading", "Apps > Online Shopping", "Apps > Other Apps", "Apps > Parenting", "Apps > Photography", "Apps > Social", "Apps > Travel", "Apps > Utilities", "Baby, Kids & Maternity", "Baby, Kids & Maternity > Baby Bedding", "Baby, Kids & Maternity > Baby Feeding Supplies", "Baby, Kids & Maternity > Baby Food", "Baby, Kids & Maternity > Baby Formula", "Baby, Kids & Maternity > Baby Hygiene Products", "Baby, Kids & Maternity > Baby Shoes", "Baby, Kids & Maternity > Child Car Seats", "Baby, Kids & Maternity > Children's Apparel", "Baby, Kids & Maternity > Diapers & Baby Wipes", "Baby, Kids & Maternity > Other Baby, Kids & Maternity", "Baby, Kids & Maternity > Strollers & Cribs", "Baby, Kids & Maternity > Toys for Kids", "Beauty & Personal Care", "Beauty & Personal Care > Aesthetic Medicine", "Beauty & Personal Care > Cosmetics", "Beauty & Personal Care > Feminine Care", "Beauty & Personal Care > Fragrances & Perfumes", "Beauty & Personal Care > Haircare", "Beauty & Personal Care > Oral Care", "Beauty & Personal Care > Other Beauty & Personal Care", "Beauty & Personal Care > Skincare", "Beauty & Personal Care > Wig & Hair Styling", "Business Services", "Business Services > Agriculture, Forestry, Animal Husbandry & Fishing", "Business Services > Auction Services", "Business Services > Chemical Materials", "Business Services > Constructional Engineering", "Business Services > Electronics & Electrical", "Business Services > Energy Conservation & Environmental Protection", "Business Services > Exhibition Services", "Business Services > Franchising", "Business Services > Individual Entrepreneurship", "Business Services > Investment Planning & Management", "Business Services > IT Services", "Business Services > Legal Services", "Business Services > Logistics", "Business Services > Machinery & Equipment", "Business Services > Marketing & Advertising", "Business Services > Office Equipment & Supplies", "Business Services > Other Business Services", "Business Services > Professional Consultation", "Business Services > Real Estate & Home Rentals", "Business Services > Recruitment & Job Searching", "Business Services > Safety & Security", "Business Services > Service Outsourcing", "E-Commerce (Non-app)", "E-Commerce (Non-app) > Big Box Retailers", "E-Commerce (Non-app) > Large E-commerce Platforms", "E-Commerce (Non-app) > Small & Medium-sized E-commerce Platforms", "Education", "Education > Early Childhood & Preschool Education", "Education > Higher Education", "Education > Language Training", "Education > Non-academic Training (Hobbies)", "Education > Other Education", "Education > Overseas Education", "Education > Primary & Secondary Education & K-12", "Education > Vocational Training", "Financial Services", "Financial Services > Commercial Banks", "Financial Services > Credit Bureaus", "Financial Services > Credit Cards", "Financial Services > Crowd Funding", "Financial Services > Cryptocurrencies", "Financial Services > Foreign Exchange Transactions", "Financial Services > Funds", "Financial Services > Guarantees", "Financial Services > Insurance", "Financial Services > Investment Advisory", "Financial Services > Loan Services", "Financial Services > Microfinance Companies", "Financial Services > Other Financial Services", "Financial Services > Pawn Shops", "Financial Services > Precious Metals", "Financial Services > Securities", "Financial Services > Third-Party Payments", "Financial Services > Trusts", "Food & Beverage", "Food & Beverage > Alcoholic Beverages", "Food & Beverage > Cooking & Recipes", "Food & Beverage > Cuisine", "Food & Beverage > Food & Fresh Produce", "Food & Beverage > Non-alcoholic Beverages", "Food & Beverage > Other Food & Beverage", "Games", "Games > Action", "Games > Casino", "Games > Hyper-Casual", "Games > Kids", "Games > Match", "Games > Other", "Games > Party", "Games > Puzzle", "Games > Racing", "Games > RPG", "Games > Shooting", "Games > Simulation", "Games > Sports", "Games > Strategy", "Games > Tabletop", "Health", "Health > Dietary Supplements", "Health > Medical Information", "Health > Medical Services", "Health > Medicine", "Health > Other Health", "Home Improvement", "Home Improvement > Construction Materials & Lighting", "Home Improvement > Furniture", "Home Improvement > Hardware & Electrical", "Home Improvement > Home Decor", "Home Improvement > Interior Design & Decorating Services", "Home Improvement > Other Home Improvement", "Home Improvement > Power Strips & Socket", "Household Products", "Household Products > Cleaning Appliances", "Household Products > Cleaning Supplies", "Household Products > Coffee Accessories", "Household Products > Daily Essentials", "Household Products > Glasses & Drinkware", "Household Products > Kitchen Accessories", "Household Products > Laundry", "Household Products > Leather Care", "Household Products > Other Household Products", "Household Products > Pest Control", "Household Products > Storage Products", "Household Products > Tea Sets", "Household Products > Tissues & Wet Wipes", "Household Products > Toys", "Life Services", "Life Services > Beauty & Personal Care", "Life Services > Consumer Services", "Life Services > Dating & Matchmaking Services", "Life Services > Exercise & Fitness", "Life Services > Gardening", "Life Services > Gifts & Flowers", "Life Services > Housekeeping", "Life Services > Internet Services", "Life Services > Other Life Services", "Life Services > Photography", "Life Services > Shopping Services", "Life Services > Used Good Sales Platforms", "Life Services > Utilities Payments", "Life Services > Wedding Celebrations", "Life Services > Wedding Photography", "News & Entertainment", "News & Entertainment > Anime", "News & Entertainment > Astrology", "News & Entertainment > Beauty & Personal Care", "News & Entertainment > Business & Economy", "News & Entertainment > Car Information", "News & Entertainment > Celebrities & Gossip", "News & Entertainment > Charity & Public Welfare", "News & Entertainment > Collectables & Antiques", "News & Entertainment > Culture & Art", "News & Entertainment > Culture & History", "News & Entertainment > E-commerce Information", "News & Entertainment > Environmental Protection", "News & Entertainment > Food & Cooking", "News & Entertainment > Games & Utility Software", "News & Entertainment > General Information", "News & Entertainment > Humor", "News & Entertainment > Law", "News & Entertainment > Lifestyle News", "News & Entertainment > Live Events", "News & Entertainment > Military", "News & Entertainment > Movies", "News & Entertainment > Other News & Entertainment", "News & Entertainment > Pet Information", "News & Entertainment > Politics", "News & Entertainment > Reading", "News & Entertainment > Real Estate Information", "News & Entertainment > Relationship Information", "News & Entertainment > Science & Technology", "News & Entertainment > Social Media Account Promotion", "News & Entertainment > Sports & Fitness", "News & Entertainment > Streaming Site", "News & Entertainment > Tourist Information", "News & Entertainment > TV Drama & Series", "News & Entertainment > TV Variety Shows", "Pets", "Pets > Other Pets", "Pets > Pet Grooming", "Pets > Pet Healthcare", "Pets > Pet Household Products", "Pets > Pet Toys", "Pets > Pet Travel Accessories", "Pets > Pet Treats", "Pets > Petfood", "Sports & Outdoor", "Sports & Outdoor > Outdoor Equipment", "Sports & Outdoor > Sports & Equipment", "Tech & Electronics", "Tech & Electronics > Cell Phones", "Tech & Electronics > Computer Accessories", "Tech & Electronics > Computer Repair", "Tech & Electronics > Computers", "Tech & Electronics > Computers Components", "Tech & Electronics > Gaming Devices", "Tech & Electronics > Network Products", "Tech & Electronics > Office Equipment", "Tech & Electronics > Other Tech & Electronics", "Travel", "Travel > Hotels & Accommodation", "Travel > Other Travel", "Travel > Tours & Attractions", "Travel > Travel Agencies & Services", "Vehicle & Transportation", "Vehicle & Transportation > Accessories for 2/3-Wheeled Vehicles", "Vehicle & Transportation > Airplanes", "Vehicle & Transportation > Auto Accessories", "Vehicle & Transportation > Auto Parts", "Vehicle & Transportation > Auto Services", "Vehicle & Transportation > Automobiles", "Vehicle & Transportation > Bicycles", "Vehicle & Transportation > Car Dealerships", "Vehicle & Transportation > Car Rentals", "Vehicle & Transportation > Electric Scooters", "Vehicle & Transportation > Motorcycles", "Vehicle & Transportation > Other Vehicle & Transportation", "Vehicle & Transportation > Used Cars", "Vehicle & Transportation > Water Vehicles" ], "prefill": "", "sectionCaption": "Filters", "sectionDescription": "Narrow the leaderboard. Leave a filter at All to sweep every value.", "title": "Industry", "type": "string" }, "language": { "default": "", "description": "Language of the ad copy.", "editor": "select", "enum": [ "", "en", "es", "ar", "vi", "th", "de", "id", "pt", "fr", "ms", "nl", "ja", "it", "ro", "zh-Hant", "ko", "uk" ], "enumTitles": [ "All languages", "English", "Spanish", "Arabic", "Vietnamese", "Thai", "German", "Indonesian", "Portuguese", "French", "Malay", "Dutch", "Japanese", "Italian", "Romanian", "Chinese (Traditional)", "Korean", "Ukrainian" ], "prefill": "", "title": "Ad language", "type": "string" }, "likeTier": { "default": "", "description": "TikTok's like-percentile band; Top 1-20% is the highest.", "editor": "select", "enum": [ "", "1", "2", "3", "4", "5" ], "enumTitles": [ "All like tiers", "Top 1-20%", "Top 21-40%", "Top 41-60%", "Top 61-80%", "Top 81-100%" ], "prefill": "", "title": "Like percentile", "type": "string" }, "maxItems": { "default": 30, "description": "Maximum unique ads to deliver (0-500). TikTok exposes 20 per board; enable Sweep to read more boards.", "maximum": 500, "minimum": 0, "prefill": 3, "sectionCaption": "Collection", "sectionDescription": "How many ads to collect and whether to read more boards.", "title": "Maximum ads", "type": "integer" }, "mode": { "default": "leaderboard", "description": "Choose the Top Ads leaderboard, TikTok's handpicked Spotlight, or refresh specific ad IDs.", "editor": "select", "enum": [ "leaderboard", "spotlight", "byAdIds" ], "enumTitles": [ "Top Ads leaderboard", "Top Ads Spotlight", "Specific ad IDs" ], "prefill": "leaderboard", "title": "Mode", "type": "string" }, "objective": { "default": "", "description": "Campaign objective as TikTok labels it.", "editor": "select", "enum": [ "", "campaign_objective_traffic", "campaign_objective_app_installs", "campaign_objective_conversion", "campaign_objective_video_views", "campaign_objective_reach", "campaign_objective_lead_generation", "campaign_objective_product_sales", "campaign_objective_app_promotion" ], "enumTitles": [ "All objectives", "Traffic", "App Installs", "Conversions", "Video Views", "Reach", "Lead Generation", "Product Sales", "App Promotion" ], "prefill": "", "title": "Campaign objective", "type": "string" }, "orderBy": { "default": "for_you", "description": "TikTok's ranking. CTR and Likes are sorted highest-first locally.", "editor": "select", "enum": [ "for_you", "impression", "ctr", "play_2s_rate", "play_6s_rate", "cvr", "like" ], "enumTitles": [ "TikTok For You ranking", "Reach (TikTok ranking)", "CTR (highest first)", "2-second view rate", "6-second view rate", "Conversion rate", "Likes (highest first)" ], "prefill": "for_you", "title": "Sort by", "type": "string" }, "period": { "default": "30", "description": "The trailing window TikTok ranks over.", "editor": "select", "enum": [ "7", "30", "180" ], "enumTitles": [ "Last 7 days", "Last 30 days", "Last 180 days" ], "prefill": "30", "title": "Time period", "type": "string" }, "sweep": { "default": true, "description": "Read more filter combinations to get past TikTok's 20-ad board. Turn off to get exactly one board.", "prefill": false, "title": "Sweep to fill", "type": "boolean" } }, "required": [ "mode" ], "schemaVersion": 1, "title": "TikTok Top Ads Scraper Input", "type": "object" }