{ "openapi": "3.0.1", "info": { "title": "TikTok Hashtag Analytics & Tracker — Views, Posts & Growth", "description": "Track TikTok hashtag views, post counts and growth over time. Analyze supporting videos, creator metrics and related hashtags via API, CSV, Excel and JSON.", "version": "0.1", "x-build-id": "vDLdFNboYJNpqqbDh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zapticx~tiktok-hashtag-analytics-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zapticx-tiktok-hashtag-analytics-tracker", "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/zapticx~tiktok-hashtag-analytics-tracker/runs": { "post": { "operationId": "runs-sync-zapticx-tiktok-hashtag-analytics-tracker", "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/zapticx~tiktok-hashtag-analytics-tracker/run-sync": { "post": { "operationId": "run-sync-zapticx-tiktok-hashtag-analytics-tracker", "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": [ "hashtags" ], "properties": { "hashtags": { "title": "Hashtags", "minItems": 1, "maxItems": 5000, "type": "array", "description": "Hashtags to analyze. Type them with or without #, paste TikTok hashtag URLs such as https://www.tiktok.com/tag/marketing, or paste a comma-separated list. Capitals and spaces are ignored the way TikTok ignores them (\"Black Friday\" is #blackfriday), and duplicates are removed automatically.", "items": { "type": "string" } }, "trackHistory": { "title": "Track growth between runs", "type": "boolean", "description": "Save each hashtag's view and post counts in a private history store in your Apify account. On later runs, every result shows how many views and posts were gained since the previous run, the percentage growth and the per-day rate. The first run of a hashtag starts the history. These growth figures are calculated by this Actor from its own observations; TikTok does not provide hashtag history.", "default": true }, "includeVideos": { "title": "Include supporting videos", "type": "boolean", "description": "Also return TikTok videos related to each hashtag, with their views, likes, comments, shares, saves and creator details, plus the hashtags that appear most often alongside yours. Videos come from TikTok's Discover keyword pages, not from the hashtag's own feed, so not every video necessarily uses the hashtag (see hashtagMatch on each video). Some hashtags have no Discover page and return no videos. Charged per video returned.", "default": false }, "maxVideosPerHashtag": { "title": "Max videos per hashtag", "minimum": 1, "maximum": 90, "type": "integer", "description": "Maximum number of supporting videos per hashtag. TikTok's Discover feed usually runs out after a few pages, so very high values may return fewer videos. Only used when supporting videos are included.", "default": 10 }, "onlyVideosContainingHashtag": { "title": "Only videos that use the hashtag", "type": "boolean", "description": "Keep only supporting videos whose caption actually contains the requested hashtag. This may return fewer videos than the maximum. Only used when supporting videos are included.", "default": false }, "videoCountry": { "title": "Supporting video region", "enum": [ "US", "GB", "CA", "AU", "IE", "NZ", "DE", "FR", "ES", "IT", "NL", "BR", "MX", "PK", "ID", "PH", "MY", "SG", "AE", "SA", "TR", "EG", "NG", "ZA", "JP", "KR" ], "type": "string", "description": "Which regional selection of supporting videos TikTok shows. This only affects the supporting videos: hashtag view and post totals are always global.", "default": "US" } } }, "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 } } } } } } } } } }