{ "openapi": "3.0.1", "info": { "title": "TikTok Affiliate & Influencer Finder (+ Promo Code Scraper)", "description": "Find TikTok affiliate creators and extract promo codes, sponsored posts, and engagement data. Multi-keyword search, minFollowers filter, niche filter. Supports DE, FR, ID and 9 other regions. Pay per lead.", "version": "0.0", "x-build-id": "bzYiQYDPbApgOHD6T" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/notus_lab~tiktok-affiliate-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-notus_lab-tiktok-affiliate-finder", "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/notus_lab~tiktok-affiliate-finder/runs": { "post": { "operationId": "runs-sync-notus_lab-tiktok-affiliate-finder", "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/notus_lab~tiktok-affiliate-finder/run-sync": { "post": { "operationId": "run-sync-notus_lab-tiktok-affiliate-finder", "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": { "searchKeywords": { "title": "Search Keywords (one per line)", "type": "array", "description": "One or more search keywords. Each keyword is searched independently and results are combined. Example: ['discount code skincare', 'use code earbuds']. All keywords are searched in a single run — no need to run the actor multiple times.", "items": { "type": "string" }, "default": [ "wireless earbuds discount code" ] }, "directUrls": { "title": "Direct TikTok Video or Creator Profile URLs", "type": "array", "description": "Optional: paste specific TikTok video URLs or creator profile links (e.g. https://www.tiktok.com/@username). If provided, bypasses keyword search entirely.", "items": { "type": "string" }, "default": [] }, "countryCode": { "title": "Target Country / Region", "enum": [ "US", "GB", "ID", "TH", "MY", "SG", "PH", "VN", "MX", "DE", "ES", "FR" ], "type": "string", "description": "Target region for localized TikTok content and creators. TIP: Use a keyword in the local language for the most accurate regional results (e.g. 'mini projecteur' for FR).", "default": "US" }, "nicheKeywords": { "title": "Niche Filter Keywords", "type": "array", "description": "Optional: only keep creators whose captions contain at least one of these words. Useful to narrow wide searches. Example: ['skincare', 'retinol', 'serum']. Leave empty to get all affiliate results.", "items": { "type": "string" }, "default": [] }, "minFollowers": { "title": "Minimum Creator Followers", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Skip creators with fewer followers than this threshold. Set to 0 to include all creators (micro-influencers included). Example: 10000 = only creators with 10K+ followers.", "default": 0 }, "resultsLimit": { "title": "Results Limit (per keyword)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of TikTok videos to fetch PER KEYWORD before affiliate filtering. With 3 keywords and resultsLimit=40, the actor fetches up to 120 raw videos total (40 per keyword), then filters and deduplicates them. You are only charged for the unique affiliate leads returned, not for raw videos fetched.", "default": 100 } } }, "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 } } } } } } } } } }