{ "openapi": "3.0.1", "info": { "title": "TikTok Trending Hashtags - Creative Center Rankings", "description": "Get TikTok trending hashtags from the Creative Center. Each tag has the rank, post count, views and industry tags. Plus the day-by-day popularity curve and the top creators. Pick one of 27 countries and a 7- or 30-day window. Three hashtags at a time, the same limit as the public page. $0.008 each.", "version": "0.1", "x-build-id": "S5tr6djeD9o0CkOle" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~tiktok-creative-center-trends/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-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/dami_studio~tiktok-creative-center-trends/runs": { "post": { "operationId": "runs-sync-dami_studio-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/dami_studio~tiktok-creative-center-trends/run-sync": { "post": { "operationId": "run-sync-dami_studio-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", "properties": { "trendTypes": { "title": "Trend types", "type": "array", "description": "Hashtag is supported from TikTok's anonymous public Creative Center page. Video, creator, song, and ad requests are probed only through documented availability checks and never charged when public data is unavailable.", "items": { "type": "string" }, "default": [ "hashtag" ] }, "industryIds": { "title": "Industry IDs", "type": "array", "description": "Optional local filter. TikTok returns industry IDs with public hashtag results; only matching returned hashtags are kept. Use IDs such as 11000000000 or 23000000000 exactly as exposed by Creative Center.", "items": { "type": "string" } }, "region": { "title": "Region", "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" ], "type": "string", "description": "ISO country code. Hashtag rankings currently support 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, and VN.", "default": "US" }, "periodDays": { "title": "Time period", "minimum": 7, "maximum": 30, "type": "integer", "description": "Creative Center comparison period in days.", "default": 7 }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 3, "type": "integer", "description": "Anonymous public Creative Center currently exposes up to three hashtag rankings. Higher values do not cause login-gated paging.", "default": 3 }, "requestTimeoutSecs": { "title": "Request timeout", "minimum": 8, "maximum": 60, "type": "integer", "description": "Maximum time for the Creative Center page request.", "default": 25 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Direct requests are used by default. Enable Apify Proxy only after a direct block; residential proxy use adds bandwidth cost and does not unlock login-gated or unavailable trend types.", "default": { "useApifyProxy": false } }, "sessionCookies": { "title": "Your own account cookies (optional)", "minItems": 0, "maxItems": 10, "type": "array", "description": "Optional. Runs read the anonymous public Creative Center page by default and use a built-in session only if that page comes back blocked. Supply your own TikTok account cookie to get a rate limit nobody else shares. In Chrome: F12 -> Application -> Cookies -> tiktok.com, and copy the value of sessionid. This does not unlock the trend types listed as unavailable. Anyone with this value can act as your account, so treat it like a password.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }