# $0.5/1K πŸ”₯ TikTok Top Ads Scraper πŸ–€ Creative Center (`azzouzana/tiktok-creative-center-top-ads-scraper`) Actor 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πŸš€ - **URL**: https://apify.com/azzouzana/tiktok-creative-center-top-ads-scraper.md - **Developed by:** [Azzouzana](https://apify.com/azzouzana) (community) - **Categories:** Social media, E-commerce, Automation - **Stats:** 30 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## TikTok Creative Center Top Ads Scraper | TikTok Ad Spy | Top Performing TikTok Ads | CTR, Likes, Spark Ads & MP4 Video URLs **TikTok Creative Center Top Ads scraper** for **TikTok ad spy**, **competitor ad research**, and **winning TikTok ad creatives**. Scrape **TikTok Top Ads** from [Creative Center Top Ads](https://ads.tiktok.com/business/creativecenter/inspiration/topads/pc/en): **ad copy**, **brand name**, **CTR**, **likes**, **cost score**, **Spark Ads**, **UGC ads**, **MP4 video URLs**, **cover images**, **industry**, **objective**, **country**, **keyword** search. Optional **landing page**, **keywords**, **tags** & more. Export **TikTok ads data** to **JSON**, **CSV**, **Excel**, **Apify API**. **Up 3,000 TikTok top ads per run.** No TikTok account. No login. nothing. --- ### 🀩 Features - πŸ† **TikTok Top Ads:** auction ads TikTok ranks as top performers - 🌍 **Country filters:** US, UK, DE, FR, AU, JP, BR, CA, MX, and more - 🧰 **419 industries:** same filters as Creative Center (objective, period, language, ad type, performance tier, keyword) - πŸ“Š **CTR, likes, cost score:** sort by Reach, CTR, CVR, 2s/6s view rate, Likes - πŸŽ₯ **MP4 download links:** `videoUrl720p`, `videoUrl540p`, `videoUrl360p` + `coverUrl` - πŸ” **`extractDetails`:** landing page, keywords, tags, CTR tier (+$0.50/1K) - πŸ“ˆ **Up to 3,000 ads/run** - πŸ“¦ **JSON / CSV / Excel / API / AI Agents ready!** --- ### πŸ“š How to use 1. [Create a free Apify account](https://apify.com/sign-up?fpr=cbgdsf) if you don't have one yet. No credit card needed. 2. Open the actor and pick your filters. Start with `countryCode` and `period`, then add industry, objective, keyword, or whatever you need. 3. Enter `maxItems` for how many ads you want (up to 3,000). 4. Hit **Start**, wait for the run to finish, then download your dataset as JSON, CSV, or Excel. --- ### πŸ€” Use cases - TikTok ad spy: competitor creatives, hooks, UGC, Spark Ads - Swipe files for media buyers and creative strategists - TikTok ads research by country, industry, objective - Benchmark CTR and likes vs your vertical - Video creative mining: download top-performing TikTok ad videos --- ### πŸ› οΈ Input | Field | Description | |-------|-------------| | `maxItems` | Top ads to collect. Max **3,000** per run | | `extractDetails` | Landing page, keywords, tags, CTR tier | | `countryCode` | Market (US, GB, DE, AU, …) | | `period` | 7, 30, or 180 days | | `industry` | Category or all | | `objective` | Traffic, conversions, app installs, etc. | | `adLanguage` | en, ja, zh, vi, th, pt, id, ... | | `adFormat` | Spark ads / non-Spark | | `likeTier` | Top 1-20%, 21-40%, … | | `orderBy` | For You, Reach, CTR, CVR, Likes, view rates | | `keyword` | Brand or product search | #### Input examples **Quick start (US, last 30 days):** ```json { "maxItems": 100, "countryCode": "US", "period": 30 } ```` **TikTok ad spy (Spark Ads, CTR sort, full details):** ```json { "maxItems": 500, "extractDetails": true, "countryCode": "GB", "period": 30, "industry": "Business & Productivity", "objective": "campaign_objective_conversion", "adLanguage": "en", "adFormat": "Spark ads", "likeTier": "1", "orderBy": "ctr", "keyword": "nike" } ``` *** ### πŸ€‘ Cost / Pricing **$0.50 / 1K** per top ad row. **`extractDetails: true`** β†’ **$1.00 / 1K** total. | Ads | Base | + `extractDetails` | | :--: | :--: | :--: | | 100 | $0.05 | $0.10 | | 500 | $0.25 | $0.50 | | 1,000 | $0.50 | $1.00 | | 3,000 | $1.50 | $3.00 | *** ### πŸ†“ Free tier limitations We want you to see how this actor works before you commit. To keep things fair for everyone, the **free tier** usually includes these trial limits: - **Sample data:** up to **5 top ads** per runβ€”enough to check data quality. - **Daily cap:** **5 runs** per calendar day (UTC). - **Between runs:** at least **30 minutes** before you can start another run. > Limits can change with platform load depending on system load and your intended scraping to prevent what we might interpret as free users abuse. #### Upgrade when you're ready! Use the free tier to decide if this actor fits your project. Paid Apify plans remove these wait times and caps so you can run at full volumeβ€”[**upgrade to a paid plan**](https://apify.com/pricing?fpr=cbgdsf). *** ### πŸ“€ Sample output ```json { "adId": "7644097429029437458", "adTitle": "Summer sale starts now, shop the collection", "brandName": "Example Brand", "ctr": 0.12, "likes": 48200, "costScore": 2, "favorite": false, "industryKey": "label_20110000000", "industryName": "Business & Productivity", "objectiveKey": "3", "isSparkAd": true, "isSearch": false, "videoId": "v10033g50000example0000000000000000", "durationSec": 28.5, "coverUrl": "https://example.com/cover.jpg", "videoUrl720p": "https://example.com/video-720p.mp4", "videoUrl540p": "https://example.com/video-540p.mp4", "videoUrl360p": "https://example.com/video-360p.mp4", "width": 720, "height": 1280, "countryCode": "US", "periodDays": 30, "orderBy": "ctr", "industryId": "20110000000", "industryLabel": "Business & Productivity", "filterObjective": "campaign_objective_conversion", "adLanguage": "en", "adFormat": "1", "adFormatLabel": "Spark ads", "likeTier": null, "keyword": null, "rank": 1, "detailUrl": "https://ads.tiktok.com/business/creativecenter/topads/7644097429029437458/pc/en?countryCode=US&period=30", "creativeCenterUrl": "https://ads.tiktok.com/business/creativecenter/inspiration/topads/pc/en?period=30®ion=US&order_by=ctr", "scrapedAt": "2026-07-03T12:00:00.000Z", "landingPageUrl": "https://example.com/landing", "keywords": ["summer sale", "fashion", "shop now"], "tags": ["UGC", "product demo"], "ctrTier": "top_10%", "detailFetched": true } ``` *** ### ❓ FAQ **TikTok account needed?**\ No. Top Ads is public on Creative Center. **Max volume?**\ 3,000 unique ads per run. Set `maxItems`. **Top Ads vs TikTok Ads Library?**\ **Top Ads:** global winning creatives, CTR, likes, video URLs. Ad spy and creative research.\ **Ads Library:** EU/UK transparency. Targeting, reach, compliance. **Need TikTok Ads Library (EU/UK)?**\ [azzouzana TikTok Ads Library Commercial Scraper πŸ”₯ $0.5/1K](https://apify.com/azzouzana/tiktok-ads-library-commercial-scraper?fpr=cbgdsf). `library.tiktok.com`, paid ads, targeting, reach, branded content. **What does `keyword` do?**\ It is the Creative Center Top Ads search box: brand name, product, or phrase in ad copy. Not a TikTok hashtag or campaign ID. Open an issue if you want hashtag or campaign ID search. **Video URLs expire?**\ Yes. `videoUrl720p` / `videoUrl540p` / `videoUrl360p` are signed TikTok CDN links. They usually expire in **24–48 hours**. Download MP4s right after the run, or re-run for fresh URLs. `coverUrl` (thumbnail) tends to last longer. *** ### πŸ“¬ Contact - πŸ’¬ Discord: `@azzouzana` - πŸ“§ *Public Creative Center data only. You comply with TikTok ToS and local law.* # Actor input Schema ## `maxItems` (type: `integer`): How many top ads to collect β€” up to 3,000 per run. Leave filters open for broader coverage. πŸ’° ## `extractDetails` (type: `boolean`): When enabled, fetches richer fields per ad: landing page, keywords, tags, CTR tier. +$0.50 / 1K per successful detail fetch. ## `countryCode` (type: `string`): Market / region filter. ## `period` (type: `string`): Lookback window. ## `industry` (type: `string`): Industry category. ## `objective` (type: `string`): Campaign objective filter. ## `adLanguage` (type: `string`): Filter by ad copy language. ## `adFormat` (type: `string`): Spark ads vs non-Spark ads. ## `likeTier` (type: `string`): Performance percentile band (Top 1–20%, etc.). ## `orderBy` (type: `string`): How TikTok ranks results. ## `keyword` (type: `string`): Search by brand or product keyword. ## Actor input object example ```json { "maxItems": 20, "extractDetails": false, "countryCode": "US", "period": "30", "industry": "All industries", "objective": "", "adLanguage": "", "adFormat": "All ad types", "likeTier": "", "orderBy": "for_you" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 20, "countryCode": "US", "period": "30", "industry": "All industries", "adFormat": "All ad types", "orderBy": "for_you" }; // Run the Actor and wait for it to finish const run = await client.actor("azzouzana/tiktok-creative-center-top-ads-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 20, "countryCode": "US", "period": "30", "industry": "All industries", "adFormat": "All ad types", "orderBy": "for_you", } # Run the Actor and wait for it to finish run = client.actor("azzouzana/tiktok-creative-center-top-ads-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxItems": 20, "countryCode": "US", "period": "30", "industry": "All industries", "adFormat": "All ad types", "orderBy": "for_you" }' | apify call azzouzana/tiktok-creative-center-top-ads-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=azzouzana/tiktok-creative-center-top-ads-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "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 } } } } } } } } } } ```