{ "openapi": "3.0.1", "info": { "title": "TikTok Creative Center — Top Ads Spy (CTR + Video URL)", "description": "Scrape TikTok's official Creative Center Top Ads — winning ad creatives with CTR, likes, MP4 video URL (720p), cover, duration, industry. Filter country/period/industry, sort by CTR/likes/cost. Headless bootstrap + HTTP pagination. Dropshipper goldmine.", "version": "1.0", "x-build-id": "Zgqei7N4YQTyRkC2N" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dltik~tiktok-creative-center/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dltik-tiktok-creative-center", "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/dltik~tiktok-creative-center/runs": { "post": { "operationId": "runs-sync-dltik-tiktok-creative-center", "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/dltik~tiktok-creative-center/run-sync": { "post": { "operationId": "run-sync-dltik-tiktok-creative-center", "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": { "countryCodes": { "title": "Countries", "uniqueItems": true, "type": "array", "description": "ISO 2-letter country codes (US, FR, GB, DE, IT, ES, JP, BR, MX, etc.). Several markets are scraped in parallel, each returning up to maxResults ads. Leave empty to use the single Country field below.", "items": { "type": "string" } }, "countryCode": { "title": "Country (single)", "type": "string", "description": "ISO 2-letter country code. Shortcut for a single market; ignored if Countries is set.", "default": "US" }, "period": { "title": "Period (days)", "enum": [ "7", "30", "180" ], "type": "string", "description": "Lookback window for top ads. TikTok Creative Center supports 7, 30, 180.", "default": "30" }, "orderBy": { "title": "Sort by", "enum": [ "for_you", "ctr", "cost", "like", "like_rate", "play_6s_rate" ], "type": "string", "description": "How to rank the top ads.", "default": "for_you" }, "industry": { "title": "Industry (optional)", "type": "string", "description": "Industry filter key from the Creative Center URL (e.g. '22102000000' = E-commerce > Beauty). Leave empty for all industries." }, "maxResults": { "title": "Max ads", "minimum": 1, "maximum": 500, "type": "integer", "description": "Cap on total ads to fetch (paginated, ~20 per page).", "default": 60 }, "enrichDetails": { "title": "Enrich with ad details", "type": "boolean", "description": "For each ad, also fetch its detail page: landing-page URL, CTA, per-second retention/keyframe data and like/CTR percentiles vs industry. The landing page reveals the exact product/offer behind each winning ad. Billed per ad enriched.", "default": false }, "useResidentialProxy": { "title": "Use residential proxy (optional)", "type": "boolean", "description": "Enable only if you hit rate limits on large runs — the public Creative Center API serves cold datacenter requests just fine.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Advanced: override the proxy. Only honored when 'Use residential proxy' is enabled.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }