{ "openapi": "3.0.1", "info": { "title": "TikTok Influencer Email Finder — Niche Creator Leads", "description": "Search TikTok creators by niche, country, language, and follower count. Export only profiles with a public email, Instagram, YouTube, or X contact for outreach. $0.50 per 100 qualified results.", "version": "0.1", "x-build-id": "x4cmSnPflaTF9cJMx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/funny_ground~tiktok-influencer-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-funny_ground-tiktok-influencer-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/funny_ground~tiktok-influencer-finder/runs": { "post": { "operationId": "runs-sync-funny_ground-tiktok-influencer-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/funny_ground~tiktok-influencer-finder/run-sync": { "post": { "operationId": "run-sync-funny_ground-tiktok-influencer-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": { "keywords": { "title": "Keywords / niches / 关键词", "type": "array", "description": "搜索关键词或领域，每行一个；留空则自动枚举常见领域（美妆/健身/美食/游戏/科技等）。Keywords or niches, one per line. Leave empty to auto-enumerate common niches.", "items": { "type": "string" } }, "minFollowers": { "title": "Min followers / 最少粉丝", "minimum": 0, "type": "integer", "description": "只保留粉丝数 ≥ 该值的达人。0 = 不限。Only keep creators with at least this many followers. 0 = no minimum.", "default": 0 }, "maxFollowers": { "title": "Max followers / 最多粉丝", "minimum": 0, "type": "integer", "description": "只保留粉丝数 ≤ 该值的达人（适合找腰部/微达人）。0 = 不限。Only keep creators with at most this many followers. 0 = no maximum.", "default": 0 }, "maxCreatorsPerKeyword": { "title": "Max creators per keyword / 每词最多达人数", "minimum": 1, "maximum": 1000, "type": "integer", "description": "每个关键词最多返回的去重达人数量。Actor 会持续翻页并检查候选主页，直到达到该数量，或确认上游已耗尽。Maximum unique creators to return per keyword; discovery continues until this cap is reached or the source is exhausted. For Apify Free-plan users, a separate global limit of 50 dataset rows per run applies regardless of this field. Paid-plan users are not subject to that developer-set 50-row limit.", "default": 50 }, "onlyWithContact": { "title": "Only creators with contact / 仅返回有联系方式的达人", "type": "boolean", "description": "Enabled by default: exclude creators without a public email, Instagram, X/Twitter, or YouTube contact. Disable it to include matching creators even when all contact fields are empty. 默认开启：过滤掉没有公开联系方式的达人；关闭后也会返回联系方式为空的匹配达人。", "default": true }, "keywordExpansion": { "title": "Related keyword expansion / 相关关键词扩搜", "enum": [ "auto", "broad", "off" ], "type": "string", "description": "When base and localized searches do not fill the requested result count, derive safe related searches from a curated niche map and hashtags seen across multiple creators. Auto is recommended. Broad accepts single-creator hashtag evidence and tries more localized variants. Off runs only the original/base-localized queries.", "default": "auto" }, "maxRelatedKeywords": { "title": "Max related keywords / 最多联想词", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum semantic alternatives derived for each original keyword. The output limit and all selected follower, country, language, and contact filters still apply to the combined results.", "default": 4 }, "countries": { "title": "Countries / regions — search & select / 国家与地区（可搜索多选）", "uniqueItems": true, "type": "array", "description": "Search the dropdown and select one or more countries/regions. The Actor automatically adds country-specific discovery terms before applying the strict region filter. You may also enter another ISO 3166-1 alpha-2 code. Unknown creator regions are excluded. TikTok region is a public content/account signal, not proof of legal residence.", "items": { "type": "string", "enumSuggestedValues": [ "US", "GB", "CA", "AU", "NZ", "IE", "DE", "FR", "ES", "IT", "PT", "NL", "BE", "CH", "AT", "SE", "NO", "DK", "FI", "IS", "PL", "CZ", "SK", "HU", "RO", "BG", "GR", "HR", "RS", "SI", "UA", "RU", "TR", "IL", "AE", "SA", "QA", "KW", "EG", "MA", "ZA", "NG", "KE", "GH", "TZ", "ET", "BR", "MX", "AR", "CO", "CL", "PE", "VE", "EC", "UY", "PY", "BO", "CR", "PA", "DO", "JM", "JP", "KR", "CN", "TW", "HK", "MO", "SG", "MY", "ID", "TH", "VN", "PH", "IN", "PK", "BD", "LK", "NP", "MM", "KH" ], "enumTitles": [ "🇺🇸 United States / 美国 (US)", "🇬🇧 United Kingdom / 英国 (GB)", "🇨🇦 Canada / 加拿大 (CA)", "🇦🇺 Australia / 澳大利亚 (AU)", "🇳🇿 New Zealand / 新西兰 (NZ)", "🇮🇪 Ireland / 爱尔兰 (IE)", "🇩🇪 Germany / 德国 (DE)", "🇫🇷 France / 法国 (FR)", "🇪🇸 Spain / 西班牙 (ES)", "🇮🇹 Italy / 意大利 (IT)", "🇵🇹 Portugal / 葡萄牙 (PT)", "🇳🇱 Netherlands / 荷兰 (NL)", "🇧🇪 Belgium / 比利时 (BE)", "🇨🇭 Switzerland / 瑞士 (CH)", "🇦🇹 Austria / 奥地利 (AT)", "🇸🇪 Sweden / 瑞典 (SE)", "🇳🇴 Norway / 挪威 (NO)", "🇩🇰 Denmark / 丹麦 (DK)", "🇫🇮 Finland / 芬兰 (FI)", "🇮🇸 Iceland / 冰岛 (IS)", "🇵🇱 Poland / 波兰 (PL)", "🇨🇿 Czechia / 捷克 (CZ)", "🇸🇰 Slovakia / 斯洛伐克 (SK)", "🇭🇺 Hungary / 匈牙利 (HU)", "🇷🇴 Romania / 罗马尼亚 (RO)", "🇧🇬 Bulgaria / 保加利亚 (BG)", "🇬🇷 Greece / 希腊 (GR)", "🇭🇷 Croatia / 克罗地亚 (HR)", "🇷🇸 Serbia / 塞尔维亚 (RS)", "🇸🇮 Slovenia / 斯洛文尼亚 (SI)", "🇺🇦 Ukraine / 乌克兰 (UA)", "🇷🇺 Russia / 俄罗斯 (RU)", "🇹🇷 Türkiye / 土耳其 (TR)", "🇮🇱 Israel / 以色列 (IL)", "🇦🇪 United Arab Emirates / 阿联酋 (AE)", "🇸🇦 Saudi Arabia / 沙特阿拉伯 (SA)", "🇶🇦 Qatar / 卡塔尔 (QA)", "🇰🇼 Kuwait / 科威特 (KW)", "🇪🇬 Egypt / 埃及 (EG)", "🇲🇦 Morocco / 摩洛哥 (MA)", "🇿🇦 South Africa / 南非 (ZA)", "🇳🇬 Nigeria / 尼日利亚 (NG)", "🇰🇪 Kenya / 肯尼亚 (KE)", "🇬🇭 Ghana / 加纳 (GH)", "🇹🇿 Tanzania / 坦桑尼亚 (TZ)", "🇪🇹 Ethiopia / 埃塞俄比亚 (ET)", "🇧🇷 Brazil / 巴西 (BR)", "🇲🇽 Mexico / 墨西哥 (MX)", "🇦🇷 Argentina / 阿根廷 (AR)", "🇨🇴 Colombia / 哥伦比亚 (CO)", "🇨🇱 Chile / 智利 (CL)", "🇵🇪 Peru / 秘鲁 (PE)", "🇻🇪 Venezuela / 委内瑞拉 (VE)", "🇪🇨 Ecuador / 厄瓜多尔 (EC)", "🇺🇾 Uruguay / 乌拉圭 (UY)", "🇵🇾 Paraguay / 巴拉圭 (PY)", "🇧🇴 Bolivia / 玻利维亚 (BO)", "🇨🇷 Costa Rica / 哥斯达黎加 (CR)", "🇵🇦 Panama / 巴拿马 (PA)", "🇩🇴 Dominican Republic / 多米尼加共和国 (DO)", "🇯🇲 Jamaica / 牙买加 (JM)", "🇯🇵 Japan / 日本 (JP)", "🇰🇷 South Korea / 韩国 (KR)", "🇨🇳 China / 中国 (CN)", "🇹🇼 Taiwan / 中国台湾 (TW)", "🇭🇰 Hong Kong / 中国香港 (HK)", "🇲🇴 Macao / 中国澳门 (MO)", "🇸🇬 Singapore / 新加坡 (SG)", "🇲🇾 Malaysia / 马来西亚 (MY)", "🇮🇩 Indonesia / 印度尼西亚 (ID)", "🇹🇭 Thailand / 泰国 (TH)", "🇻🇳 Vietnam / 越南 (VN)", "🇵🇭 Philippines / 菲律宾 (PH)", "🇮🇳 India / 印度 (IN)", "🇵🇰 Pakistan / 巴基斯坦 (PK)", "🇧🇩 Bangladesh / 孟加拉国 (BD)", "🇱🇰 Sri Lanka / 斯里兰卡 (LK)", "🇳🇵 Nepal / 尼泊尔 (NP)", "🇲🇲 Myanmar / 缅甸 (MM)", "🇰🇭 Cambodia / 柬埔寨 (KH)" ] }, "default": [] }, "languages": { "title": "Main languages — search & select / 主流语言（可搜索多选）", "uniqueItems": true, "type": "array", "description": "Search the dropdown and select one or more mainstream content languages. The Actor automatically adds localized discovery terms before applying language detection. Detection uses public bio and matched-video text first, with TikTok profile language only as supporting evidence. Unknown or below-threshold results are excluded.", "items": { "type": "string", "enum": [ "en", "zh", "es", "pt", "fr", "de", "it", "ja", "ko", "ar", "ru", "hi", "id", "ms", "vi", "th", "tr", "bn", "ur", "nl", "pl", "uk", "fil", "fa" ], "enumTitles": [ "English / 英语 (en)", "Chinese / 中文 (zh)", "Spanish / 西班牙语 (es)", "Portuguese / 葡萄牙语 (pt)", "French / 法语 (fr)", "German / 德语 (de)", "Italian / 意大利语 (it)", "Japanese / 日语 (ja)", "Korean / 韩语 (ko)", "Arabic / 阿拉伯语 (ar)", "Russian / 俄语 (ru)", "Hindi / 印地语 (hi)", "Indonesian / 印尼语 (id)", "Malay / 马来语 (ms)", "Vietnamese / 越南语 (vi)", "Thai / 泰语 (th)", "Turkish / 土耳其语 (tr)", "Bengali / 孟加拉语 (bn)", "Urdu / 乌尔都语 (ur)", "Dutch / 荷兰语 (nl)", "Polish / 波兰语 (pl)", "Ukrainian / 乌克兰语 (uk)", "Filipino / Tagalog / 菲律宾语 (fil)", "Persian / Farsi / 波斯语 (fa)" ] }, "default": [] }, "minimumLanguageConfidence": { "title": "Minimum language confidence / 最低语言置信度", "enum": [ "high", "medium", "low" ], "type": "string", "description": "Applied only when Main languages is set. Medium is recommended: it rejects profile-setting-only guesses while retaining text-supported matches. High is stricter and may return fewer creators; Low accepts profile-language-only matches.", "default": "medium" }, "maxConcurrency": { "title": "Profile concurrency / 主页请求并发", "minimum": 1, "maximum": 12, "type": "integer", "description": "How many lightweight public profile HTTP requests to run in parallel. Search discovery can use a separate non-residential fallback run when the HTTP source is blocked.", "default": 8 }, "maxRequestRetries": { "title": "Max request retries / 最大重试次数", "minimum": 0, "maximum": 3, "type": "integer", "description": "Retries for temporary public HTTP/API failures. A low default prevents slow, wasteful runs.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration / 代理", "type": "object", "description": "Legacy compatibility field. It is ignored. Direct HTTP is preferred, and the fallback never enables residential proxies.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }