{ "openapi": "3.0.1", "info": { "title": "$0.5/1K 🔥 TikTok Top Ads Scraper 🖤 Creative Center", "description": "From $0.5/1K 💰 Fast TikTok Top Ads Scraper! Extract up to 3K unique ads per run. Spy on competitor ads library. Advanced filters, export CTR, likes, MP4 video URLs & much more for ecom product research & trending hooks. Export JSON/CSV/Excel. AI agents ready & costs pennies! Start now🚀", "version": "0.0", "x-build-id": "99rTTYk41Lzxtr7tW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/azzouzana~tiktok-creative-center-top-ads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-azzouzana-tiktok-creative-center-top-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/azzouzana~tiktok-creative-center-top-ads-scraper/runs": { "post": { "operationId": "runs-sync-azzouzana-tiktok-creative-center-top-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/azzouzana~tiktok-creative-center-top-ads-scraper/run-sync": { "post": { "operationId": "run-sync-azzouzana-tiktok-creative-center-top-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": { "maxItems": { "title": "📊 Max items", "minimum": 1, "maximum": 3000, "type": "integer", "description": "How many top ads to collect — up to 3,000 per run. Leave filters open for broader coverage. 💰", "default": 100 }, "extractDetails": { "title": "🔍 Fetch full ad details", "type": "boolean", "description": "When enabled, fetches richer fields per ad: landing page, keywords, tags, CTR tier. +$0.50 / 1K per successful detail fetch.", "default": false }, "countryCode": { "title": "🌍 Country", "enum": [ "US", "CA", "MX", "BR", "GB", "DE", "FR", "IT", "ES", "NL", "PL", "SE", "TR", "SA", "AE", "AU", "JP", "KR", "ID", "TH", "VN", "MY", "PH", "SG" ], "type": "string", "description": "Market / region filter.", "default": "US" }, "period": { "title": "📅 Period", "enum": [ "7", "30", "180" ], "type": "string", "description": "Lookback window.", "default": "30" }, "industry": { "title": "🏭 Industry", "enum": [ "All industries", "Education (10000000000)", "Early Childhood & Preschool Education", "Primary & Secondary Education & K-12", "Higher Education", "Overseas Education", "Vocational Training", "Language Training", "Non-academic Training (Hobbies)", "Other Education", "Vehicle & Transportation", "Automobiles", "Auto Accessories", "Auto Services", "Auto Parts", "Car Rentals", "Used Cars", "Motorcycles", "Bicycles", "Electric Scooters", "Water Vehicles", "Aeroplanes", "Accessories for 2/3-Wheeled Vehicles", "Car Dealerships", "Other Vehicle & Transportation", "Baby, Kids & Maternity", "Baby Food", "Strollers & Cots", "Baby Formula", "Nappies & Baby Wipes", "Baby Bedding", "Baby Shoes", "Toys for Kids", "Child Car Seats", "Baby Feeding Supplies", "Children's Apparel", "Baby Hygiene Products", "Other Baby, Kids & Maternity", "Financial Services (13000000000)", "Commercial Banks", "Securities", "Insurance", "Trusts", "Guarantees", "Pawn Shops", "Funds", "Credit Bureaus", "Microfinance Companies", "Investment Advisory", "Loan Services", "Foreign Exchange Transactions", "Precious Metals", "Third-Party Payments", "Crowd Funding", "Cryptocurrencies", "Credit Cards", "Other Financial Services", "Beauty & Personal Care (14000000000)", "Oral Care", "Haircare", "Wig & Hair Styling", "Skincare", "Cosmetics", "Aesthetic Medicine", "Fragrances & Perfumes", "Feminine Care", "Other Beauty & Personal Care", "Tech & Electronics", "Mobile Phones", "Computers", "Computer Components", "Computer Repair", "Gaming Devices", "Computer Accessories", "Network Products", "Office Equipment", "Headphone & Headset Accessories", "Other Tech & Electronics", "Appliances", "Personal Care Appliances", "Kitchen & Bathroom Appliances", "Large Appliances", "Home Appliances", "Digital Devices", "Other Appliances", "Travel (17000000000)", "Hotels & Accommodation", "Tours & Attractions", "Travel Agencies & Services", "Other Travel", "Household Products", "Storage Products", "Daily Essentials", "Glasses & Drinkware", "Tea Sets", "Coffee Accessories", "Kitchen Accessories", "Cleaning Appliances", "Tissues & Wet Wipes", "Laundry", "Leather Care", "Cleaning Supplies", "Toys", "Pest Control", "Tableware", "Other Household Products", "Pets", "Petfood", "Pet Healthcare", "Pet Household Products", "Pet Grooming", "Pet Treats", "Pet Toys", "Pet Travel Accessories", "Other Pets", "Apps", "Social", "Audio & Video Players", "News & Reading", "Photography (20103000000)", "Education (20104000000)", "Online Shopping", "Financial Services (20106000000)", "Life & Leisure", "Travel (20108000000)", "Health & Fitness", "Business & Productivity", "Parenting", "Utilities", "Other Apps", "Home Improvement", "Interior Design & Decorating Services", "Furniture", "Construction Materials & Lighting", "Hardware & Electrical", "Home Decor", "Power Strips & Socket", "Other Home Improvement", "Apparel & Accessories", "Clothing Accessories", "Bags", "Watches", "Ordinary Jewellery", "High-end Jewellery", "Men's Clothing", "Men's Shoes", "Women's Clothing", "Women's Shoes", "Traditional & Ceremonial Clothing", "Wearable Tech Devices", "Shoes Accessories", "Other Apparel & Accessories", "News & Entertainment", "Military", "Politics", "Business & Economy", "Science & Technology", "Culture & History", "Charity & Public Welfare", "Law", "Environmental Protection", "Celebrities & Gossip", "Lifestyle News", "Live Events", "Collectables & Antiques", "TV Drama & Series", "Anime", "Astrology", "Humour", "Culture & Art", "TV Variety Shows", "Reading", "Films", "Beauty & Personal Care (23122000000)", "Sports & Fitness", "Food & Cooking", "Games & Utility Software", "Car Information", "General Information", "E-commerce Information", "Pet Information", "Real Estate Information", "Relationship Information", "Streaming Site", "Tourist Information", "Social Media Account Promotion", "Other News & Entertainment", "Business Services", "Real Estate & Home Rentals", "Office Equipment & Supplies", "Recruitment & Job Searching", "Constructional Engineering", "Electronics & Electrical", "Chemical Materials", "Machinery & Equipment", "Franchising", "Agriculture, Forestry, Animal Husbandry & Fishing", "Energy Conservation & Environmental Protection", "Safety & Security", "Logistics", "Marketing & Advertising", "Professional Consultation", "Exhibition Services", "Service Outsourcing", "IT Services", "Legal Services", "Auction Services", "Investment Planning & Management", "Individual Entrepreneurship", "Other Business Services", "Games", "Games (By Genre)", "Roleplaying Games", "Simulation Games", "Strategy Games", "Shooting Games", "Sports Games", "Action Games", "Adventure Games", "Racing Games", "Music Games", "Action-adventure Games", "Puzzle Games", "Match-three Games", "Educational Games", "Sandbox Games", "Card Games (25100114000)", "Casino Games", "Combat Games", "Arcade Games", "Hyper-Casual", "Action (25300101000)", "Ball", "Escape", "Music", "Puzzle (25300105000)", "Racing (25300106000)", "Shooting (25300107000)", "Simulation (25300108000)", "Sports (25300109000)", "Other Hyper-Casual", "Action (25301000000)", "Artillery", "Asymmetric", "Brawl (25301102000)", "Fighting", "MOBA", "Music or Rhythm", "Open World", "Platformer", "Battle Royale (25301108000)", "Run & Gun", "Runner", "Shark", "Shoot'em Up", "Slasher", "Stealth", "Adventure", "Brawl (25301116000)", "Other Action", "Casino", "Bingo", "Chinese Card or Board", "Claw Machine", "Coin Pusher", "Dominoes", "Fishing", "Lottery or Scratchers", "Mahjong", "Okey", "Pachinko", "Poker or Card", "Slots", "Other Casino", "Match", "Blast-Meta", "Blast-Saga", "Bubble Shooter", "Connect Tiles", "Line-Saga", "M3-Meta", "M3-Saga", "Merge-Saga", "Other-Meta", "Other Match", "Puzzle (25304000000)", "Block", "Brain", "Brick Breaker", "Detective", "Hidden Object", "Hybrid", "Jigsaw", "Klotski", "Maze", "Minesweeper", "Nonogram", "Physics", "Escape Room", "Spot the Difference", "Sudoku", "Tile-Matching", "Word", "Other Puzzle", "Racing (25305000000)", "Arcade Racing", "Competitive Racing", "Simulation Racing", "Other Racing", "RPG", "Action RPG", "Empire Building RPG", "Idle RPG", "Location RPG", "MMORPG", "Open World RPG", "Puzzle RPG", "Roguelike ARPG", "Survival", "Tactics", "Team Battle", "Tower Defence RPG", "Other RPG", "Shooting (25307000000)", "Battle Royale (25307100000)", "Cover Fire", "PvE Shooting", "Sniper", "Team Deathmatch", "Other Shooting", "Simulation (25308000000)", "Animal Avatar", "Avatar Life", "Breeding", "Building", "Sandbox", "Dating", "Dress Up & Lifestyle", "Driving", "Farming", "Home Design", "Idle", "Idol Training", "Interactive Story", "Life Simulator", "Manager", "Pet", "Time Management", "Other Simulation", "Sports (25309000000)", "Arcade Sports", "Simulation Sports", "Team Manager", "Other Sports", "Strategy", "4X", "Auto Chess", "Build and Battle", "CCG", "Lane", "Legion", "Summoning", "Tower Defence", "RTS", "Other Strategy", "Party", "Guessing", "Karaoke", "Dance", "Luck Battle", "Mafia or Social Deduction", "Minigames", "Party Royale", "Quiz", "Truth or Dare", "Other Party", "Tabletop", "Board Game", "Card Games (25312101000)", "Chess", "Colouring", "Dice", "Go-Stop", "Hanafuda", "Mahjong Solitaire", "Othello", "Solitaire", "Other Tabletop", "Kids", "Educational", "Other Kids", "Other (25999000000)", "Other (25999999000)", "Life Services", "Wedding Photography", "Photography (26101000000)", "Dating & Matchmaking Services", "Wedding Celebrations", "Gifts & Flowers", "Housekeeping", "Shopping Services", "Used Good Sales Platforms", "Gardening", "Utilities Payments", "Internet Services", "Consumer Services", "Exercise & Fitness", "Beauty & Personal Care (26114000000)", "Entertainment Service", "Other Life Services", "Food & Beverage", "Cuisine", "Food & Fresh Produce", "Non-alcoholic Beverages", "Alcoholic Beverages", "Cooking & Recipes", "Other Food & Beverage", "Sports & Outdoor", "Outdoor Equipment", "Sports & Equipment" ], "type": "string", "description": "Industry category.", "default": "All industries" }, "objective": { "title": "🎯 Objective", "enum": [ "", "campaign_objective_reach", "campaign_objective_traffic", "campaign_objective_video_view", "campaign_objective_app_install", "campaign_objective_conversion", "campaign_objective_engagement", "campaign_objective_lead_generation", "campaign_objective_product_sales" ], "type": "string", "description": "Campaign objective filter.", "default": "" }, "adLanguage": { "title": "🗣️ Ad language", "enum": [ "", "en", "ja", "zh", "vi", "th", "pt", "id" ], "type": "string", "description": "Filter by ad copy language.", "default": "" }, "adFormat": { "title": "🎬 Ad type", "enum": [ "All ad types", "Spark ads", "Non-Spark ads" ], "type": "string", "description": "Spark ads vs non-Spark ads.", "default": "All ad types" }, "likeTier": { "title": "👍 Performance tier", "enum": [ "", "1", "2", "3", "4", "5" ], "type": "string", "description": "Performance percentile band (Top 1–20%, etc.).", "default": "" }, "orderBy": { "title": "↕️ Sort by", "enum": [ "for_you", "impression", "ctr", "play_2s_rate", "play_6s_rate", "cvr", "like" ], "type": "string", "description": "How TikTok ranks results.", "default": "for_you" }, "keyword": { "title": "🔎 Keyword", "type": "string", "description": "Search by brand or product keyword." } } }, "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 } } }, "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 } } } } } } } } } }