{ "openapi": "3.0.1", "info": { "title": "TikTok Creative Center Trends Scraper", "description": "Scrape TikTok Creative Center trends: trending hashtags with trend curves, trending videos and top ads by country, period and industry. No login. Pay only per result.", "version": "1.0", "x-build-id": "9OngRis955LttcTbQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/symphonic_mullite~tiktok-creative-center-trends/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-symphonic_mullite-tiktok-creative-center-trends", "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/symphonic_mullite~tiktok-creative-center-trends/runs": { "post": { "operationId": "runs-sync-symphonic_mullite-tiktok-creative-center-trends", "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/symphonic_mullite~tiktok-creative-center-trends/run-sync": { "post": { "operationId": "run-sync-symphonic_mullite-tiktok-creative-center-trends", "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", "required": [ "types", "countries" ], "properties": { "types": { "title": "What to scrape", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Trend lists to collect. Trending hashtags (27 countries), trending videos (US, JP, ID, TH, VN) and top ads (28 countries). TikTok removed the public songs and creators lists from the Creative Center, so they are not offered.", "items": { "type": "string", "enum": [ "hashtags", "videos", "topAds" ], "enumTitles": [ "Trending hashtags", "Trending videos", "Top ads" ] }, "default": [ "hashtags" ] }, "countries": { "title": "Countries", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Countries (regions) to collect. Each list type supports its own set; unsupported combinations are skipped with a warning.\n\nHashtags: US, FR, DE, IT, ES, GB, AR, AU, BR, CA, CO, EG, ID, IL, JP, KR, MY, MX, PH, SA, SG, ZA, TW, TH, TR, AE, VN.\nVideos: US, JP, VN, TH, ID.\nTop ads: 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.", "items": { "type": "string", "enum": [ "AR", "AU", "BR", "CA", "CO", "EG", "FR", "DE", "ID", "IL", "IT", "JP", "MY", "MX", "NL", "PK", "PH", "RO", "SA", "SG", "ZA", "KR", "ES", "SE", "TW", "TH", "TR", "AE", "GB", "US", "VN" ], "enumTitles": [ "Argentina", "Australia", "Brazil", "Canada", "Colombia", "Egypt", "France", "Germany", "Indonesia", "Israel", "Italy", "Japan", "Malaysia", "Mexico", "Netherlands", "Pakistan", "Philippines", "Romania", "Saudi Arabia", "Singapore", "South Africa", "South Korea", "Spain", "Sweden", "Taiwan", "Thailand", "Turkey", "United Arab Emirates", "United Kingdom", "United States", "Vietnam" ] }, "default": [ "US" ] }, "maxItemsPerType": { "title": "Max items per type", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stops collecting a type once this many items were saved for it. You are charged per saved item, so this also caps the cost of a run.", "default": 1000 }, "hashtagPeriods": { "title": "Periods", "uniqueItems": true, "type": "array", "description": "Ranking windows: last 7, 30 or 90 days.", "items": { "type": "string", "enum": [ "7", "30", "90" ], "enumTitles": [ "Last 7 days", "Last 30 days", "Last 90 days" ] }, "default": [ "7" ] }, "hashtagIndustries": { "title": "Industries", "uniqueItems": true, "type": "array", "description": "Industry rankings to collect. \"All industries\" is the overall ranking. Leave empty to collect the overall ranking plus all 15 industry rankings.", "items": { "type": "string", "enum": [ "all", "10000000000", "11000000000", "12000000000", "14000000000", "15000000000", "17000000000", "18000000000", "19000000000", "21000000000", "22000000000", "23000000000", "25000000000", "27000000000", "28000000000", "29000000000" ], "enumTitles": [ "All industries", "Education", "Vehicle & Transportation", "Baby, Kids & Maternity", "Beauty & Personal Care", "Tech & Electronics", "Travel", "Household Products", "Pets", "Home Improvement", "Apparel & Accessories", "News & Entertainment", "Games", "Food & Beverage", "Sports & Outdoor", "Health" ] }, "default": [ "all", "10000000000", "11000000000", "12000000000", "14000000000", "15000000000", "17000000000", "18000000000", "19000000000", "21000000000", "22000000000", "23000000000", "25000000000", "27000000000", "28000000000", "29000000000" ] }, "videoPeriods": { "title": "Periods", "uniqueItems": true, "type": "array", "description": "Ranking windows: last 7 or 30 days.", "items": { "type": "string", "enum": [ "7", "30" ], "enumTitles": [ "Last 7 days", "Last 30 days" ] }, "default": [ "7" ] }, "videoSortBy": { "title": "Sort orders", "uniqueItems": true, "type": "array", "description": "Ranking metrics, as on the Creative Center tabs. Each one is a separate top-4 list.", "items": { "type": "string", "enum": [ "views", "engagement", "sixSecondViews" ], "enumTitles": [ "Highest video views", "Highest engagement", "Highest 6-second views" ] }, "default": [ "views" ] }, "videoContentTags": { "title": "Content tags", "uniqueItems": true, "type": "array", "description": "Video content tag filters. Each one is a separate top-4 list. \"All content\" is the unfiltered ranking.", "items": { "type": "string", "enum": [ "all", "11002", "11003", "11010", "11013", "11015" ], "enumTitles": [ "All content (no tag filter)", "Beauty & Care", "Fashion", "Food & Beverage", "Lifestyle & Leisure", "Technology & Finance" ] }, "default": [ "all" ] }, "topAdsPeriods": { "title": "Periods", "uniqueItems": true, "type": "array", "description": "Ranking windows: last 7, 30 or 180 days.", "items": { "type": "string", "enum": [ "7", "30", "180" ], "enumTitles": [ "Last 7 days", "Last 30 days", "Last 180 days" ] }, "default": [ "7" ] }, "topAdsIndustries": { "title": "Industries", "uniqueItems": true, "type": "array", "description": "Advertiser industries. \"All industries\" is the unfiltered dashboard.", "items": { "type": "string", "enum": [ "all", "10000000000", "11000000000", "12000000000", "13000000000", "14000000000", "15000000000", "16000000000", "17000000000", "18000000000", "19000000000", "20000000000", "21000000000", "22000000000", "23000000000", "24000000000", "25000000000", "26000000000", "27000000000", "28000000000", "29000000000", "30000000000" ], "enumTitles": [ "All industries", "Education", "Vehicle & Transportation", "Baby, Kids & Maternity", "Financial Services", "Beauty & Personal Care", "Tech & Electronics", "Appliances", "Travel", "Household Products", "Pets", "Apps", "Home Improvement", "Apparel & Accessories", "News & Entertainment", "Business Services", "Games", "Life Services", "Food & Beverage", "Sports & Outdoor", "Health", "E-Commerce (Non-app)" ] }, "default": [ "all" ] }, "topAdsSortBy": { "title": "Sort orders", "uniqueItems": true, "type": "array", "description": "Dashboard sort orders. Each one is a separate list.", "items": { "type": "string", "enum": [ "for_you", "impression", "ctr", "play_6s_rate", "like" ], "enumTitles": [ "For You", "Reach", "CTR", "6s view rate", "Likes" ] }, "default": [ "for_you" ] }, "topAdsIncludeDetails": { "title": "Include ad details", "type": "boolean", "description": "Also open each ad's public detail page to add comments, shares, target countries, landing page, keywords and CTR percentile. One extra page visit per ad, so runs take longer; the price per item is the same.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy is recommended. Datacenter proxies work for the Creative Center; switch to residential only if you see blocked pages.", "default": { "useApifyProxy": 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 } } } } } } } } } }