{ "openapi": "3.0.1", "info": { "title": "TikTok Trends Scraper — Trending Hashtags by Country", "description": "Extract trending hashtags from TikTok Creative Center. Get ranked hashtag data with view counts, post volumes, and industry tags across 27 countries. Export to JSON, CSV, or Excel. No login required.", "version": "0.1", "x-build-id": "pbHft9D8Q31PUSfZi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rastriq~tiktok-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rastriq-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/rastriq~tiktok-trends-scraper/runs": { "post": { "operationId": "runs-sync-rastriq-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/rastriq~tiktok-trends-scraper/run-sync": { "post": { "operationId": "run-sync-rastriq-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": [ "countries", "period" ], "properties": { "countries": { "title": "Countries", "type": "array", "description": "Countries to scrape trends for. Each country runs independently.", "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", "France", "Germany", "Italy", "Spain", "United Kingdom", "Argentina", "Australia", "Brazil", "Canada", "Colombia", "Egypt", "Indonesia", "Israel", "Japan", "South Korea", "Malaysia", "Mexico", "Philippines", "Saudi Arabia", "Singapore", "South Africa", "Taiwan", "Thailand", "Turkey", "United Arab Emirates", "Vietnam" ] }, "default": [ "US" ] }, "period": { "title": "Time Period", "enum": [ "7", "30", "120" ], "type": "string", "description": "Time window for trend analysis.", "default": "7" }, "industry": { "title": "Industry Filter", "enum": [ "", "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" ], "type": "string", "description": "Filter hashtags by industry. Leave empty for all.", "default": "" }, "maxItemsPerType": { "title": "Max Results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum hashtags to extract per country (up to 100).", "default": 50 }, "includeDetails": { "title": "Include Detail Page Data", "type": "boolean", "description": "Extract extended data per hashtag: audience age distribution, regional popularity, related videos, and trend curve. Increases runtime ~2s per hashtag.", "default": false }, "tiktokCookies": { "title": "TikTok Cookies", "type": "string", "description": "TikTok session cookies (JSON)." }, "cookieKvStoreId": { "title": "Cookie KV Store ID", "type": "string", "description": "KV Store ID for shared cookies.", "default": "3Pc5Q20nhP6Vr6bpG" }, "apifyToken": { "title": "Apify API Token", "type": "string", "description": "Personal API token for KV Store access." } } }, "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 } } } } } } } } } }