{ "openapi": "3.0.1", "info": { "title": "TikTok Creative Ads Scraper | Top Ads, Landing Pages & Metrics", "description": "TikTok Creative Ads scraper for Creative Center Top Ads: 20 top ads in 23 seconds, 48 fields each. Get ad title, industry, objective, budget level, likes, comments, shares, landing page, CTR and reach ranks, retention curve, ad language and video links by market, keyword, link or ad id. No login.", "version": "1.0", "x-build-id": "NKcRaCE63mivIadjh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/silentflow~tiktok-creative-ads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-silentflow-tiktok-creative-ads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/silentflow~tiktok-creative-ads-scraper/runs": { "post": { "operationId": "runs-sync-silentflow-tiktok-creative-ads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/silentflow~tiktok-creative-ads-scraper/run-sync": { "post": { "operationId": "run-sync-silentflow-tiktok-creative-ads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keywords": { "title": "🔎 Keywords", "type": "array", "description": "Words of the ads you want, matched in the ad text the way the Creative Center search box does: skincare, protein, mobile game. One ranking per keyword and market. A precise word returns a handful of ads, so pair it with a long period (Last 180 days) or All markets. Leave empty to get the market's top ads.", "items": { "type": "string" } }, "startUrls": { "title": "🔗 Creative Center links", "type": "array", "description": "Links copied from TikTok Creative Center (ads.tiktok.com/business/creativecenter):The filters in a link win over the form below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "adIds": { "title": "🆔 Ad ids", "type": "array", "description": "Ad ids from Creative Center or from an earlier run (id field), such as 7689889505990475797. Each id gives one row with fresh likes, comments, shares and landing page, so a watchlist of competitor ads refreshes in one run.", "items": { "type": "string" } }, "country": { "title": "🌍 Country", "type": "string", "description": "The market whose top ads you want, among the 82 countries Top Ads ranks. Pick it in the list, or type its code (gb, gbr), its English name (United Kingdom), or several codes separated by commas (us, gb, de) to get one ranking per market.", "default": "US" }, "period": { "title": "📅 Period", "enum": [ "7", "30", "180" ], "type": "string", "description": "The window the ranking covers. Last 180 days holds the most ads (up to 500 per market).", "default": "30" }, "sortBy": { "title": "↕️ Sort by", "enum": [ "reach", "for_you", "likes", "ctr", "view_2s_rate", "view_6s_rate", "cvr" ], "type": "string", "description": "Reach puts the most viewed ads first. The other sorts rank by likes, click-through rate, the share of viewers still watching at 2 or 6 seconds, or conversion rate. Every row also carries its rank in each of these rankings.", "default": "reach" }, "industries": { "title": "🏷️ Industries", "type": "array", "description": "Keep the ads of these industries only: a whole sector (Beauty & Personal Care) or one of its 237 subcategories (Beauty & Personal Care › Skincare, Games › Puzzle). Type in the box to find one. Leave empty for every industry. Each row names its exact subcategory.", "items": { "type": "string", "enum": [ "22000000000", "22101000000", "22102000000", "22105000000", "22106000000", "22107000000", "22108000000", "22109000000", "22110000000", "22111000000", "22112000000", "22113000000", "22999000000", "16000000000", "16100000000", "16101000000", "16102000000", "16104000000", "16105000000", "16999000000", "20000000000", "20100000000", "20101000000", "20102000000", "20103000000", "20104000000", "20105000000", "20106000000", "20107000000", "20108000000", "20109000000", "20110000000", "20111000000", "20112000000", "20999000000", "12000000000", "12100000000", "12101000000", "12102000000", "12103000000", "12104000000", "12105000000", "12106000000", "12107000000", "12108000000", "12109000000", "12110000000", "12999000000", "14000000000", "14100000000", "14101000000", "14102000000", "14103000000", "14104000000", "14105000000", "14106000000", "14107000000", "14999000000", "24000000000", "24100000000", "24101000000", "24102000000", "24103000000", "24104000000", "24105000000", "24106000000", "24107000000", "24108000000", "24109000000", "24110000000", "24111000000", "24112000000", "24113000000", "24114000000", "24115000000", "24116000000", "24117000000", "24118000000", "24119000000", "24120000000", "24999000000", "30000000000", "30100000000", "30101000000", "30102000000", "10000000000", "10100000000", "10101000000", "10102000000", "10103000000", "10104000000", "10105000000", "10106000000", "10999000000", "13000000000", "13100000000", "13101000000", "13102000000", "13103000000", "13104000000", "13105000000", "13107000000", "13108000000", "13109000000", "13110000000", "13111000000", "13112000000", "13113000000", "13114000000", "13115000000", "13116000000", "13117000000", "13999000000", "27000000000", "27100000000", "27101000000", "27102000000", "27103000000", "27104000000", "27999000000", "25000000000", "25300000000", "25301000000", "25302000000", "25303000000", "25304000000", "25305000000", "25306000000", "25307000000", "25308000000", "25309000000", "25310000000", "25311000000", "25312000000", "25313000000", "25999000000", "29000000000", "29100000000", "29101000000", "29102000000", "29103000000", "29999000000", "21000000000", "21100000000", "21101000000", "21102000000", "21103000000", "21104000000", "21105000000", "21999000000", "18000000000", "18100000000", "18101000000", "18102000000", "18103000000", "18104000000", "18105000000", "18106000000", "18107000000", "18108000000", "18109000000", "18110000000", "18111000000", "18112000000", "18999000000", "26000000000", "26100000000", "26101000000", "26102000000", "26103000000", "26104000000", "26105000000", "26106000000", "26107000000", "26108000000", "26109000000", "26111000000", "26112000000", "26113000000", "26114000000", "26999000000", "23000000000", "23100000000", "23101000000", "23102000000", "23103000000", "23104000000", "23105000000", "23106000000", "23107000000", "23108000000", "23109000000", "23110000000", "23111000000", "23112000000", "23113000000", "23114000000", "23115000000", "23116000000", "23117000000", "23118000000", "23119000000", "23122000000", "23123000000", "23124000000", "23125000000", "23126000000", "23127000000", "23128000000", "23129000000", "23130000000", "23131000000", "23132000000", "23133000000", "23134000000", "23999000000", "19000000000", "19100000000", "19101000000", "19102000000", "19103000000", "19104000000", "19105000000", "19106000000", "19999000000", "28000000000", "28100000000", "28101000000", "15000000000", "15100000000", "15101000000", "15102000000", "15103000000", "15104000000", "15105000000", "15106000000", "15107000000", "15999000000", "17000000000", "17103000000", "17105000000", "17106000000", "17999000000", "11000000000", "11100000000", "11101000000", "11102000000", "11103000000", "11104000000", "11105000000", "11106000000", "11107000000", "11108000000", "11109000000", "11110000000", "11111000000", "11112000000", "11999000000" ], "enumTitles": [ "Apparel & Accessories", "Apparel & Accessories › Clothing Accessories", "Apparel & Accessories › Bags", "Apparel & Accessories › Watches", "Apparel & Accessories › Ordinary Jewelry", "Apparel & Accessories › High-end Jewelry", "Apparel & Accessories › Men's Clothing", "Apparel & Accessories › Men's Shoes", "Apparel & Accessories › Women's Clothing", "Apparel & Accessories › Women's Shoes", "Apparel & Accessories › Traditional & Ceremonial Clothing", "Apparel & Accessories › Wearable Tech Devices", "Apparel & Accessories › Other Apparel & Accessories", "Appliances", "Appliances › Personal Care Appliances", "Appliances › Kitchen & Bathroom Appliances", "Appliances › Large Appliances", "Appliances › Home Appliances", "Appliances › Digital Devices", "Appliances › Other Appliances", "Apps", "Apps › Social", "Apps › Audio & Video Players", "Apps › News & Reading", "Apps › Photography", "Apps › Education", "Apps › Online Shopping", "Apps › Financial Services", "Apps › Life & Leisure", "Apps › Travel", "Apps › Health & Fitness", "Apps › Business & Productivity", "Apps › Parenting", "Apps › Utilities", "Apps › Other Apps", "Baby, Kids & Maternity", "Baby, Kids & Maternity › Baby Food", "Baby, Kids & Maternity › Strollers & Cribs", "Baby, Kids & Maternity › Baby Formula", "Baby, Kids & Maternity › Diapers & Baby Wipes", "Baby, Kids & Maternity › Baby Bedding", "Baby, Kids & Maternity › Baby Shoes", "Baby, Kids & Maternity › Toys for Kids", "Baby, Kids & Maternity › Child Car Seats", "Baby, Kids & Maternity › Baby Feeding Supplies", "Baby, Kids & Maternity › Children's Apparel", "Baby, Kids & Maternity › Baby Hygiene Products", "Baby, Kids & Maternity › Other Baby, Kids & Maternity", "Beauty & Personal Care", "Beauty & Personal Care › Oral Care", "Beauty & Personal Care › Haircare", "Beauty & Personal Care › Wig & Hair Styling", "Beauty & Personal Care › Skincare", "Beauty & Personal Care › Cosmetics", "Beauty & Personal Care › Aesthetic Medicine", "Beauty & Personal Care › Fragrances & Perfumes", "Beauty & Personal Care › Feminine Care", "Beauty & Personal Care › Other Beauty & Personal Care", "Business Services", "Business Services › Real Estate & Home Rentals", "Business Services › Office Equipment & Supplies", "Business Services › Recruitment & Job Searching", "Business Services › Constructional Engineering", "Business Services › Electronics & Electrical", "Business Services › Chemical Materials", "Business Services › Machinery & Equipment", "Business Services › Franchising", "Business Services › Agriculture, Forestry, Animal Husbandry & Fishing", "Business Services › Energy Conservation & Environmental Protection", "Business Services › Safety & Security", "Business Services › Logistics", "Business Services › Marketing & Advertising", "Business Services › Professional Consultation", "Business Services › Exhibition Services", "Business Services › Service Outsourcing", "Business Services › IT Services", "Business Services › Legal Services", "Business Services › Auction Services", "Business Services › Investment Planning & Management", "Business Services › Individual Entrepreneurship", "Business Services › Other Business Services", "E-Commerce (Non-app)", "E-Commerce (Non-app) › Big Box Retailers", "E-Commerce (Non-app) › Small & Medium-sized E-commerce Platforms", "E-Commerce (Non-app) › Large E-commerce Platforms", "Education", "Education › Early Childhood & Preschool Education", "Education › Primary & Secondary Education & K-12", "Education › Higher Education", "Education › Overseas Education", "Education › Vocational Training", "Education › Language Training", "Education › Non-academic Training (Hobbies)", "Education › Other Education", "Financial Services", "Financial Services › Commercial Banks", "Financial Services › Securities", "Financial Services › Insurance", "Financial Services › Trusts", "Financial Services › Guarantees", "Financial Services › Pawn Shops", "Financial Services › Funds", "Financial Services › Credit Bureaus", "Financial Services › Microfinance Companies", "Financial Services › Investment Advisory", "Financial Services › Loan Services", "Financial Services › Foreign Exchange Transactions", "Financial Services › Precious Metals", "Financial Services › Third-Party Payments", "Financial Services › Crowd Funding", "Financial Services › Cryptocurrencies", "Financial Services › Credit Cards", "Financial Services › Other Financial Services", "Food & Beverage", "Food & Beverage › Cuisine", "Food & Beverage › Food & Fresh Produce", "Food & Beverage › Non-alcoholic Beverages", "Food & Beverage › Alcoholic Beverages", "Food & Beverage › Cooking & Recipes", "Food & Beverage › Other Food & Beverage", "Games", "Games › Hyper-Casual", "Games › Action", "Games › Casino", "Games › Match", "Games › Puzzle", "Games › Racing", "Games › RPG", "Games › Shooting", "Games › Simulation", "Games › Sports", "Games › Strategy", "Games › Party", "Games › Tabletop", "Games › Kids", "Games › Other", "Health", "Health › Medical Services", "Health › Medical Information", "Health › Dietary Supplements", "Health › Medicine", "Health › Other Health", "Home Improvement", "Home Improvement › Interior Design & Decorating Services", "Home Improvement › Furniture", "Home Improvement › Construction Materials & Lighting", "Home Improvement › Hardware & Electrical", "Home Improvement › Home Decor", "Home Improvement › Power Strips & Socket", "Home Improvement › Other Home Improvement", "Household Products", "Household Products › Storage Products", "Household Products › Daily Essentials", "Household Products › Glasses & Drinkware", "Household Products › Tea Sets", "Household Products › Coffee Accessories", "Household Products › Kitchen Accessories", "Household Products › Cleaning Appliances", "Household Products › Tissues & Wet Wipes", "Household Products › Laundry", "Household Products › Leather Care", "Household Products › Cleaning Supplies", "Household Products › Toys", "Household Products › Pest Control", "Household Products › Other Household Products", "Life Services", "Life Services › Wedding Photography", "Life Services › Photography", "Life Services › Dating & Matchmaking Services", "Life Services › Wedding Celebrations", "Life Services › Gifts & Flowers", "Life Services › Housekeeping", "Life Services › Shopping Services", "Life Services › Used Good Sales Platforms", "Life Services › Gardening", "Life Services › Utilities Payments", "Life Services › Internet Services", "Life Services › Consumer Services", "Life Services › Exercise & Fitness", "Life Services › Beauty & Personal Care", "Life Services › Other Life Services", "News & Entertainment", "News & Entertainment › Military", "News & Entertainment › Politics", "News & Entertainment › Business & Economy", "News & Entertainment › Science & Technology", "News & Entertainment › Culture & History", "News & Entertainment › Charity & Public Welfare", "News & Entertainment › Law", "News & Entertainment › Environmental Protection", "News & Entertainment › Celebrities & Gossip", "News & Entertainment › Lifestyle News", "News & Entertainment › Live Events", "News & Entertainment › Collectables & Antiques", "News & Entertainment › TV Drama & Series", "News & Entertainment › Anime", "News & Entertainment › Astrology", "News & Entertainment › Humor", "News & Entertainment › Culture & Art", "News & Entertainment › TV Variety Shows", "News & Entertainment › Reading", "News & Entertainment › Movies", "News & Entertainment › Beauty & Personal Care", "News & Entertainment › Sports & Fitness", "News & Entertainment › Food & Cooking", "News & Entertainment › Games & Utility Software", "News & Entertainment › Car Information", "News & Entertainment › General Information", "News & Entertainment › E-commerce Information", "News & Entertainment › Pet Information", "News & Entertainment › Real Estate Information", "News & Entertainment › Relationship Information", "News & Entertainment › Streaming Site", "News & Entertainment › Tourist Information", "News & Entertainment › Social Media Account Promotion", "News & Entertainment › Other News & Entertainment", "Pets", "Pets › Petfood", "Pets › Pet Healthcare", "Pets › Pet Household Products", "Pets › Pet Grooming", "Pets › Pet Treats", "Pets › Pet Toys", "Pets › Pet Travel Accessories", "Pets › Other Pets", "Sports & Outdoor", "Sports & Outdoor › Outdoor Equipment", "Sports & Outdoor › Sports & Equipment", "Tech & Electronics", "Tech & Electronics › Cell Phones", "Tech & Electronics › Computers", "Tech & Electronics › Computers Components", "Tech & Electronics › Computer Repair", "Tech & Electronics › Gaming Devices", "Tech & Electronics › Computer Accessories", "Tech & Electronics › Network Products", "Tech & Electronics › Office Equipment", "Tech & Electronics › Other Tech & Electronics", "Travel", "Travel › Hotels & Accommodation", "Travel › Tours & Attractions", "Travel › Travel Agencies & Services", "Travel › Other Travel", "Vehicle & Transportation", "Vehicle & Transportation › Automobiles", "Vehicle & Transportation › Auto Accessories", "Vehicle & Transportation › Auto Services", "Vehicle & Transportation › Auto Parts", "Vehicle & Transportation › Car Rentals", "Vehicle & Transportation › Used Cars", "Vehicle & Transportation › Motorcycles", "Vehicle & Transportation › Bicycles", "Vehicle & Transportation › Electric Scooters", "Vehicle & Transportation › Water Vehicles", "Vehicle & Transportation › Airplanes", "Vehicle & Transportation › Accessories for 2/3-Wheeled Vehicles", "Vehicle & Transportation › Car Dealerships", "Vehicle & Transportation › Other Vehicle & Transportation" ] } }, "objective": { "title": "🎯 Campaign objective", "enum": [ "all", "traffic", "app_installs", "conversions", "video_views", "reach", "lead_generation", "product_sales", "app_promotion" ], "type": "string", "description": "Keep the ads bought for one goal, such as Conversions for ads that sell or App Installs for app campaigns.", "default": "all" }, "adFormat": { "title": "🎬 Ad format", "enum": [ "all", "spark", "non_spark" ], "type": "string", "description": "Spark Ads are posts of a TikTok account that a brand boosts as ads; the others are uploaded in Ads Manager. Every row says which one it is (isSparkAd).", "default": "all" }, "adLanguage": { "title": "🗣️ Ad language", "enum": [ "all", "ar", "zh-Hant", "nl", "en", "fr", "de", "id", "it", "ja", "ko", "ms", "pt", "ro", "es", "th", "vi" ], "type": "string", "description": "Keep the ads spoken or written in one language, such as Spanish ads in the United States. Every row carries its language code (adLanguage).", "default": "all" }, "likeTier": { "title": "❤️ Likes tier", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string", "description": "Keep the ads of one band of the ranking by likes: Top 1–20% for the most liked ads, Top 81–100% for the least liked.", "default": "all" }, "maxItems": { "title": "🔢 Max ads", "minimum": 1, "type": "integer", "description": "Stop after this many ads, across markets, keywords, links and ids; with several markets each gets its share. A market ranking holds up to 500 ads. Set it to what you need, the cost grows with it.", "default": 100 }, "includeDetails": { "title": "📊 Ad details and ranks", "type": "boolean", "description": "Read each ad's page and rankings: landing page, comments, shares, the countries it ran in, its second-by-second retention curve, its rank by reach, likes, CTR, 2 and 6-second view rates and conversion rate, its language and whether it is a Spark Ad. Turn it off for a faster list with titles, likes, budget and video links only.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }