{ "openapi": "3.0.1", "info": { "title": "TikTok Influencer Search — Find Creators by Description", "description": "Find TikTok influencers by describing them in plain English. AI checks every creator against each requirement with quotes as proof. Get followers, average and median views, engagement rate and the email from their bio or, optionally, the page it links to. Only new creators on repeat runs.", "version": "0.0", "x-build-id": "8GLnbcJ0ANP2UGOnV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/afanasenko~tiktok-influencer-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-afanasenko-tiktok-influencer-search", "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/afanasenko~tiktok-influencer-search/runs": { "post": { "operationId": "runs-sync-afanasenko-tiktok-influencer-search", "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/afanasenko~tiktok-influencer-search/run-sync": { "post": { "operationId": "run-sync-afanasenko-tiktok-influencer-search", "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": { "brief": { "title": "Who to find", "type": "string", "description": "Plain English, like a message to an assistant: niche, what they post, where they are, size, contact. Example: \"US fitness creators with 10k–200k followers who post home workouts and have an email in their bio\". Up to 4,000 characters.", "default": "" }, "maxResults": { "title": "Number of matching creators", "minimum": 1, "maximum": 200, "type": "integer", "description": "The search stops when it has this many creators that pass every requirement. Each one is charged; possible matches are free.", "default": 20 }, "country": { "title": "Country", "enum": [ "", "US", "GB", "CA", "AU", "DE", "FR", "ES", "IT", "BR", "MX", "IN", "PH", "ID", "AE", "SA", "TR", "NG", "ZA", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AG", "AR", "AM", "AW", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "IO", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CV", "BQ", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "GF", "PF", "GA", "GM", "GE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HN", "HK", "HU", "IS", "IR", "IQ", "IE", "IM", "IL", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "XK", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NU", "NF", "KP", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "WS", "SM", "ST", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "GS", "KR", "SS", "LK", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TM", "TC", "TV", "VI", "UG", "UA", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW" ], "type": "string", "description": "Only creators from this country. Proven by the region TikTok records for the creator's recent videos (for example \"US: 9 of 10 recent videos\") or by the place the creator states in their bio. The video region can differ from where a creator lives. \"Any country\" sets no restriction; you can also name the country in the description.", "default": "" }, "minFollowers": { "title": "Min followers", "minimum": 0, "type": "integer", "description": "0 = no minimum.", "default": 0 }, "maxFollowers": { "title": "Max followers", "minimum": 0, "type": "integer", "description": "0 = no maximum.", "default": 0 }, "mustHaveEmail": { "title": "Must have an email in the bio", "type": "boolean", "description": "Only creators who write an email address in their TikTok bio. With \"Find email or phone behind the bio link\" on, an email published behind the bio link also counts.", "default": false }, "lookBehindBioLink": { "title": "Find email or phone behind the bio link", "type": "boolean", "description": "When on, for a creator whose bio shows no email the Actor opens the bio link — a link-in-bio page such as Linktree, a WhatsApp link, or the creator's own website (home page and one contact page) — and takes the email or phone published there. It fills the linkEmail / linkPhone columns (with where each came from), and an email or phone requirement in your description, or \"Must have an email in the bio\", is then also met by a contact found there. Only contacts the creator published are returned. At most 3 pages and about 10 seconds per creator, so runs are slower. Off by default. No extra charge.", "default": false }, "maxProfilesToCheck": { "title": "Max creators to check (AI cost control)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "The most creators the AI checks in one run. 0 = automatic (6 per creator asked for, at least 100). Checks are never charged; only matching creators are.", "default": 0 }, "skipDelivered": { "title": "Skip creators already delivered to you", "enum": [ "off", "7", "30", "90", "180", "365", "forever" ], "type": "string", "description": "Leave out creators this Actor already delivered to your Apify account, across all your runs and descriptions (matching creators and free possible matches). Skipped creators are not checked or charged; the run looks for the next ones instead. From the API you can also pass any number of days, e.g. \"45\". The history is a key-value store named tt-delivered-… in your Storage, kept from version 0.0.5 on; delete it to start over. Runs that overlap in time may still share a creator.", "default": "off" } } }, "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 } } } } } } } } } }