{
"openapi": "3.0.1",
"info": {
"title": "TikTok Trending Hashtags Scraper by Country",
"description": "Get TikTok Creative Center trending hashtags: rank, views, posts and industry for 27 countries and 7/30/120-day windows. No login, no API key. Export to JSON, CSV or Excel.",
"version": "0.1",
"x-build-id": "F2Oy5rtbTd7gjbIFl"
},
"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": "Markets to scrape (one Creative Center page per country, ~40 s each). Start with 1-3 countries. Several countries in one run give you a side-by-side comparison in a single dataset.",
"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": "Ranking window: 7 days = what is rising right now; 30 / 120 days = sustained trends.
💡 Schedule a weekly run to build your own trend history — TikTok only shows the current ranking.",
"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": "Optional industry label. Note: results currently include every industry; use the 'industry' field of each result to filter after export.",
"default": ""
},
"maxItemsPerType": {
"title": "Max Results",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "Maximum hashtags per country (1-100). Lower values finish faster and cost less: 20 hashtags ~ 25 s.",
"default": 50
},
"includeDetails": {
"title": "Include Detail Page Data",
"type": "boolean",
"description": "Add audience age/gender, regional popularity, related videos and trend curve for every hashtag. Slow: about 7 s per hashtag, so 50 hashtags add ~6 minutes per country. Keep Max Results low when enabling it.",
"default": false
},
"tiktokCookies": {
"title": "TikTok Cookies",
"type": "string",
"description": "TikTok session cookies (JSON)."
},
"cookieKvStoreId": {
"title": "Cookie KV Store ID",
"type": "string",
"description": "Optional override. By default the actor uses the session store configured by the developer (COOKIE_KV_STORE_ID)."
},
"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
},
"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
}
}
}
}
}
}
}
}
}
}