{ "openapi": "3.0.1", "info": { "title": "TikTok Hashtag Stats Scraper & Monitor - Views & Video Growth", "description": "Track how fast TikTok hashtags grow: exact view and video counts per hashtag, average views per video, and with monitoring on, the views and videos added since the last run and per hour. The rounded view count is shown beside the exact one.", "version": "0.1", "x-build-id": "yOg4M8RCwNF6UiPxc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~tiktok-hashtag-stats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-tiktok-hashtag-stats-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/neverempty~tiktok-hashtag-stats-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-tiktok-hashtag-stats-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/neverempty~tiktok-hashtag-stats-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-tiktok-hashtag-stats-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", "properties": { "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtags to read: booktok, #booktok, or https://www.tiktok.com/tag/booktok. One per line (commas also work). TikTok normalises names itself - 'skin care' is read as #skincare - and every row shows both what you typed and what TikTok returned. The same hashtag is read and charged once per run. If you leave this empty, the example hashtags booktok and skincare are read and every row says so in inputHashtag.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum rows to return", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many charged rows to return in total when monitoring is off: reading stops once this many hashtags have been read, and a free row says how many entries at the end of the list were not read. In monitoring mode it does not limit the changes returned - every change among the hashtags read comes back. Up to 1,000 hashtags are read per run (about 1.3 seconds each).", "default": 100 }, "monitoringMode": { "title": "Monitoring mode: return a hashtag only when its counts change", "type": "boolean", "description": "Off = every hashtag you listed comes back with its current counts, charged per row. On = the Actor remembers each hashtag's counts and, on later runs, returns it only when they moved, with the change since the last delivered row (viewCountDelta, videoCountDelta, viewsPerHour). The first run returns every hashtag once to set the baseline. Large hashtags move between almost any two runs (#booktok: +8 videos in about 7 seconds on 2026-09-14), so they come back on almost every run. **In monitoring mode every hashtag read costs $0.30 per 1,000 checks, moved or not** (names TikTok returns nothing for and bot checks are free), plus the row price for the rows returned. The Actor reads only as many hashtags as the run's maximum total charge can pay for with a check and a change row each. Counts are remembered per hashtag; do not put the same hashtag in two schedules that can run at the same time.", "default": false }, "monitorMode": { "title": "What counts as a change", "enum": [ "any-change", "video-change" ], "type": "string", "description": "Any change = the hashtag comes back when its video count moves or its view count moves (by at least 'Minimum view change', if set). New videos only = it comes back only when the video count moves. Both compare the exact figures, not the rounded ones.", "default": "any-change" }, "minViewIncrease": { "title": "Minimum view change", "minimum": 0, "type": "integer", "description": "In 'any change' mode, ignore view-count movements smaller than this (in either direction). A hashtag whose video count moved still comes back. The comparison is always against the last row that was delivered, so small movements add up until they cross the threshold instead of being lost. 0 = any movement counts.", "default": 0 }, "resetMonitoringState": { "title": "Forget what was remembered and start over", "type": "boolean", "description": "Clears every remembered count for this Actor, so the next monitoring run returns each hashtag once again. This affects all your monitoring runs, because counts are stored per hashtag rather than per list.", "default": false }, "useProxy": { "title": "Use a proxy if TikTok answers with a bot check", "type": "boolean", "description": "Every hashtag is requested directly first, trying TikTok's m.tiktok.com, t.tiktok.com and www.tiktok.com addresses in that order, because from Apify www.tiktok.com answered this request with an empty response on every attempt measured on 2026-09-14 while m.tiktok.com answered with the data. If every address answers with a bot check or nothing, this switches to a proxy session and tries them again. With it off, that answer is returned as a free 'blocked' row.", "default": true } } }, "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 } } } } } } } } } }