{ "openapi": "3.0.1", "info": { "title": "VK Influencer Email Finder — Russian Creator Leads", "description": "Find VK creators by niche, audience, country, language, and views. Export public email, phone, Telegram, social, website, and manager contacts. $0.50 per 100 paid-plan leads.", "version": "1.0", "x-build-id": "Jh77L9ady39pNo0eT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/funny_ground~vk-influencer-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-funny_ground-vk-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~vk-influencer-finder/runs": { "post": { "operationId": "runs-sync-funny_ground-vk-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~vk-influencer-finder/run-sync": { "post": { "operationId": "run-sync-funny_ground-vk-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 / 关键词或领域", "uniqueItems": true, "type": "array", "description": "Creator niches to search, one per line. Russian and Latin queries are supported. Leave empty to scan a curated set of common commercial niches.", "items": { "type": "string" } }, "minFollowers": { "title": "Minimum audience / 最少粉丝", "minimum": 0, "type": "integer", "description": "Only keep creators with at least this many followers or community members. For personal profiles, the larger of public profile followers and VK Video followers is used. 0 means no minimum.", "default": 0 }, "maxFollowers": { "title": "Maximum audience / 最多粉丝", "minimum": 0, "type": "integer", "description": "Only keep creators with at most this many followers or members. Useful for micro- and mid-tier creator discovery. 0 means no maximum.", "default": 0 }, "minAverageViews": { "title": "Minimum sampled average views / 最低平均播放", "minimum": 0, "type": "integer", "description": "Require at least this average view count across the creator's videos encountered during keyword discovery. This is a search-matched sample, not a lifetime channel average. 0 disables the filter.", "default": 0 }, "maxCreatorsPerKeyword": { "title": "Maximum creators per keyword / 每词最多达人", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum globally deduplicated, qualified creators returned for each original keyword. Discovery continues through pages and related queries until this target, source exhaustion, or a safety limit. A separate global 50-row cap applies to Free-plan runs.", "default": 50 }, "onlyWithContact": { "title": "Only creators with public contact / 仅返回有联系方式达人", "type": "boolean", "description": "Enabled by default. Excludes creators without an explicit public email, phone, Telegram, Instagram, YouTube, TikTok, X, website, or named VK manager.", "default": true }, "creatorTypes": { "title": "Creator types / 达人类型", "uniqueItems": true, "type": "array", "description": "Choose VK communities/public pages, personal profiles, or both.", "items": { "type": "string", "enum": [ "community", "profile" ], "enumTitles": [ "Communities and public pages / 社群与公共主页", "Personal profiles / 个人主页" ] }, "default": [ "community", "profile" ] }, "verifiedOnly": { "title": "Verified creators only / 仅认证达人", "type": "boolean", "description": "When enabled, only VK-verified creators are returned.", "default": false }, "keywordExpansion": { "title": "Related and localized keyword expansion / 相关词与本地化扩搜", "enum": [ "auto", "broad", "off" ], "type": "string", "description": "Auto expands only when the original query does not fill the requested count. It uses curated Russian/English niche equivalents and hashtags supported by multiple creators. Broad accepts single-creator hashtag evidence and more variants. Off searches only the original and active-filter localized queries.", "default": "auto" }, "maxRelatedKeywords": { "title": "Maximum related keywords / 最多联想词", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum semantic alternatives derived for each original keyword. All selected filters still apply to combined results.", "default": 4 }, "countries": { "title": "Countries / regions / 国家与地区", "uniqueItems": true, "type": "array", "description": "Strict filter based on explicit public VK country/city/profile evidence. Creators whose country cannot be established are excluded when this filter is active.", "items": { "type": "string", "enum": [ "RU", "UA", "BY", "KZ", "UZ", "KG", "AM", "AZ", "GE", "MD", "EE", "LV", "LT", "DE", "US", "CA" ], "enumTitles": [ "🇷🇺 Russia / 俄罗斯 (RU)", "🇺🇦 Ukraine / 乌克兰 (UA)", "🇧🇾 Belarus / 白俄罗斯 (BY)", "🇰🇿 Kazakhstan / 哈萨克斯坦 (KZ)", "🇺🇿 Uzbekistan / 乌兹别克斯坦 (UZ)", "🇰🇬 Kyrgyzstan / 吉尔吉斯斯坦 (KG)", "🇦🇲 Armenia / 亚美尼亚 (AM)", "🇦🇿 Azerbaijan / 阿塞拜疆 (AZ)", "🇬🇪 Georgia / 格鲁吉亚 (GE)", "🇲🇩 Moldova / 摩尔多瓦 (MD)", "🇪🇪 Estonia / 爱沙尼亚 (EE)", "🇱🇻 Latvia / 拉脱维亚 (LV)", "🇱🇹 Lithuania / 立陶宛 (LT)", "🇩🇪 Germany / 德国 (DE)", "🇺🇸 United States / 美国 (US)", "🇨🇦 Canada / 加拿大 (CA)" ] }, "default": [] }, "languages": { "title": "Content languages / 内容语言", "uniqueItems": true, "type": "array", "description": "Filter using public profile text and keyword-matched video captions. Unknown or below-threshold detections are excluded when active.", "items": { "type": "string", "enum": [ "ru", "uk", "en", "kk", "be", "uz", "az", "hy", "ka", "de", "pl", "tr" ], "enumTitles": [ "Russian / 俄语 (ru)", "Ukrainian / 乌克兰语 (uk)", "English / 英语 (en)", "Kazakh / 哈萨克语 (kk)", "Belarusian / 白俄罗斯语 (be)", "Uzbek / 乌兹别克语 (uz)", "Azerbaijani / 阿塞拜疆语 (az)", "Armenian / 亚美尼亚语 (hy)", "Georgian / 格鲁吉亚语 (ka)", "German / 德语 (de)", "Polish / 波兰语 (pl)", "Turkish / 土耳其语 (tr)" ] }, "default": [] }, "minimumLanguageConfidence": { "title": "Minimum language confidence / 最低语言置信度", "enum": [ "high", "medium", "low" ], "type": "string", "description": "Applied only when Content languages is set. Medium is recommended; High is stricter and may return fewer creators.", "default": "medium" }, "includeClips": { "title": "Use VK Clips for discovery / 用 Clips 发现达人", "type": "boolean", "description": "Include short_video results when discovering creators and calculating matched-video sample metrics.", "default": true }, "maxPagesPerQuery": { "title": "Maximum pages per query / 每查询最多页数", "minimum": 1, "maximum": 100, "type": "integer", "description": "Hard pagination safety limit for each original, localized, or related search query.", "default": 20 }, "maxCandidatesPerKeyword": { "title": "Maximum candidates checked per keyword / 每词候选上限", "minimum": 20, "maximum": 5000, "type": "integer", "description": "Hard safety cap before filtering. Raising it can find more contact-qualified creators but increases VK requests and runtime.", "default": 1000 }, "requestTimeoutSecs": { "title": "Request timeout / 请求超时", "minimum": 5, "maximum": 120, "type": "integer", "description": "Timeout for each anonymous VK HTTP request.", "default": 30 }, "maxRequestRetries": { "title": "Maximum request retries / 最大重试次数", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries for temporary VK rate limits, network failures, and server errors.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration / 代理", "type": "object", "description": "Compatibility field. It is ignored because direct anonymous VK HTTP is faster and cheaper for this Actor.", "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 } } } } } } } } } }