{ "openapi": "3.0.1", "info": { "title": "TikTok Trends Scraper — Creative Center hashtags & videos", "description": "Scrape TikTok Creative Center trends with no login: trending hashtags with posts, views, daily trend curve and top creators, plus top trending TikTok videos by country, period and industry. TikTok API alternative for TikTok Shop sellers and marketers. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "yff1DwbukdM1rRXWm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/istmobot~tiktok-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-istmobot-tiktok-trends-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/istmobot~tiktok-trends-scraper/runs": { "post": { "operationId": "runs-sync-istmobot-tiktok-trends-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/istmobot~tiktok-trends-scraper/run-sync": { "post": { "operationId": "run-sync-istmobot-tiktok-trends-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", "required": [ "type" ], "properties": { "type": { "title": "What to scrape", "enum": [ "hashtags", "videos" ], "type": "string", "description": "\"hashtags\": trending hashtags with posts, views, daily trend curve and top creators. \"videos\": top trending TikTok videos with views, engagement and creator.", "default": "hashtags" }, "countryCodes": { "title": "Countries", "type": "array", "description": "One or more markets. Hashtags: 27 countries. Videos: US, JP, VN, TH, ID only (other countries return a free error item).", "items": { "type": "string", "enum": [ "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" ], "enumTitles": [ "United States (US)", "France (FR)", "Germany (DE)", "Italy (IT)", "Spain (ES)", "United Kingdom (GB)", "Argentina (AR)", "Australia (AU)", "Brazil (BR)", "Canada (CA)", "Colombia (CO)", "Egypt (EG)", "Indonesia (ID)", "Israel (IL)", "Japan (JP)", "South Korea (KR)", "Malaysia (MY)", "Mexico (MX)", "Philippines (PH)", "Saudi Arabia (SA)", "Singapore (SG)", "South Africa (ZA)", "Taiwan (TW)", "Thailand (TH)", "Türkiye (TR)", "United Arab Emirates (AE)", "Vietnam (VN)" ] }, "default": [ "US" ] }, "period": { "title": "Period", "enum": [ "7", "30", "90" ], "type": "string", "description": "Trend window in days. 90 days is available for hashtags only.", "default": "7" }, "industries": { "title": "Industries (hashtags)", "type": "array", "description": "Hashtags only. Each selected industry returns its own top hashtags. Leave empty for the overall ranking.", "items": { "type": "string", "enum": [ "10000000000", "11000000000", "12000000000", "14000000000", "15000000000", "17000000000", "18000000000", "19000000000", "21000000000", "22000000000", "23000000000", "25000000000", "27000000000", "28000000000", "29000000000" ], "enumTitles": [ "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" ] } }, "contentTags": { "title": "Video content tags (videos)", "type": "array", "description": "Videos only. Each selected tag returns its own top videos. Leave empty for all content.", "items": { "type": "string", "enum": [ "11002", "11003", "11010", "11013", "11015" ], "enumTitles": [ "Beauty & Care", "Fashion", "Food & Beverage", "Lifestyle & Leisure", "Technology & Finance" ] } }, "sortBy": { "title": "Rank videos by (videos)", "enum": [ "views", "engagement", "completion" ], "type": "string", "description": "Videos only: rank by video views, engagement rate or 6-second view rate.", "default": "views" }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum number of results for the whole run (you are charged per result).", "default": 100 } } }, "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 } } } } } } } } } }