{ "openapi": "3.0.1", "info": { "title": "TikTok Trending Sounds Scraper - Viral Music & Chart History", "description": "TikTok sound tracker for the Popular and Viral Top 50 charts in nine countries. Export trending sounds and songs with audio usage counts, rank changes, music links and dated chart history as JSON, CSV or API. Find sounds gaining usage over 3 or 7 days, with cached example videos. No TikTok login.", "version": "0.1", "x-build-id": "pXNBVbcYI50JunXcd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trendingtiktoksongs~tiktok-trending-sounds-history/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trendingtiktoksongs-tiktok-trending-sounds-history", "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/trendingtiktoksongs~tiktok-trending-sounds-history/runs": { "post": { "operationId": "runs-sync-trendingtiktoksongs-tiktok-trending-sounds-history", "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/trendingtiktoksongs~tiktok-trending-sounds-history/run-sync": { "post": { "operationId": "run-sync-trendingtiktoksongs-tiktok-trending-sounds-history", "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": { "mode": { "title": "Export mode", "enum": [ "latest", "history", "insights" ], "type": "string", "description": "Choose chart observations or measured three- or seven-day growth.", "default": "latest" }, "countries": { "title": "Countries", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Chart countries to export.", "items": { "type": "string", "enum": [ "US", "DE", "BR", "JP", "KR", "CA", "FR", "MX", "TR" ], "enumTitles": [ "United States", "Germany", "Brazil", "Japan", "South Korea", "Canada", "France", "Mexico", "Turkey" ] }, "default": [ "US" ] }, "chartTypes": { "title": "Charts", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Popular, Viral, or both.", "items": { "type": "string", "enum": [ "popular", "viral" ], "enumTitles": [ "Popular", "Viral" ] }, "default": [ "popular" ] }, "fromDate": { "title": "From date (UTC)", "type": "string", "description": "Required in history mode. First calendar date to include." }, "toDate": { "title": "To date (UTC)", "type": "string", "description": "Required in history mode. Last calendar date to include; at most 30 days including the first date." }, "maxRows": { "title": "Maximum results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Global row limit after filtering. Try starts with 10; when omitted: latest uses 50 per chart, history 5,000, and growth 20." }, "soundIds": { "title": "Sound IDs in the archive", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Optional: filter up to 50 TikTok sound IDs already covered by the archive. This does not start tracking new sounds.", "items": { "type": "string", "pattern": "^[0-9]{1,30}$" } }, "lookbackDays": { "title": "Growth period (3 or 7 days)", "minimum": 3, "maximum": 7, "type": "integer", "description": "Used only in sound usage growth mode. Seven days compares the end date with exactly seven days earlier.", "default": 7 }, "asOfDate": { "title": "Growth end date (UTC)", "type": "string", "description": "Optional in growth mode. Leave blank for the latest common fresh chart date." }, "sortBy": { "title": "Rank growth by", "enum": [ "usage_change", "usage_growth_pct" ], "type": "string", "description": "Growth mode: compare net count changes or percentage changes from a positive baseline.", "default": "usage_change" }, "growthFilter": { "title": "Growth results", "enum": [ "rising", "all" ], "type": "string", "description": "All also includes declining, flat and missing-baseline sounds. Rising includes only positive comparable changes.", "default": "rising" }, "minBaselineUsage": { "title": "Minimum baseline usage", "minimum": 0, "type": "integer", "description": "Growth mode only. Use 1,000 with percentage ranking to exclude tiny baselines. Zero disables this filter.", "default": 0 }, "includeExamples": { "title": "Include example videos", "type": "boolean", "description": "Growth mode only: include up to three cached videos using each sound when available. Examples are source-selected, not necessarily recent. Explicit historical dates return no video examples.", "default": false } } }, "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 } } } } } } } } } }