{ "openapi": "3.0.1", "info": { "title": "Social Media Profile Finder - Handles, Links & Follower Counts", "description": "For lead and influencer research: a name, brand or company domain comes back as the TikTok, YouTube, Twitch, Telegram, Bluesky, Snapchat, GitHub and Discord accounts behind it, with the follower count and the evidence for each match. All 8 answered on 2026-09-23; 5 give an exact count.", "version": "0.1", "x-build-id": "9yRDggKOnWlKM5qLx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~social-media-profile-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-social-media-profile-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/neverempty~social-media-profile-finder/runs": { "post": { "operationId": "runs-sync-neverempty-social-media-profile-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/neverempty~social-media-profile-finder/run-sync": { "post": { "operationId": "run-sync-neverempty-social-media-profile-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": { "names": { "title": "Names or brands to find", "type": "array", "description": "One person, brand or company name per line. For each one the Actor opens the handle built from that name on every platform you picked, and reads the first page of web search results for it. Latin letters and digits are used to build the handle, so a name written only in other scripts is skipped with a free row saying so. A repeated name is used once and gets a free 'duplicate' row. If you leave both this field and 'Company websites' out, the example name 'MrBeast' is used and every row says so in its query column. Up to 200 entries per run across both fields.", "items": { "type": "string" } }, "domains": { "title": "Company websites to find accounts for", "type": "array", "description": "One website per line: a domain (example.com) or any URL on it. The Actor reads the site's own pages, takes the social links published there, and also tries the handle built from the domain's own label (duolingo.com is matched as 'duolingo'). A link published on the company's own website is the strongest single piece of evidence there is, but it is not proof on its own: company sites also link to partners, to staff and to the Discord of a tool they use, so a linked account whose name has nothing in common with the company is scored down, not up. robots.txt is read first and pages the site asks robots to stay out of are not opened.", "items": { "type": "string" } }, "platforms": { "title": "Platforms to search (leave empty for all eight)", "type": "array", "description": "tiktok, youtube, twitch, telegram, bluesky, snapchat, github, discord. Leave the list empty to search all eight; every row says which platforms were searched. Instagram, Facebook, LinkedIn, X/Twitter and Threads are not covered: their profile pages refuse automated reads from datacenter connections or publish no follower number, and this Actor does not claim to cover them. Counts are exact on TikTok, Twitch, Telegram, Bluesky and GitHub; YouTube, Snapchat and Discord publish only a rounded or approximate number, and every row says which it is.", "items": { "type": "string", "enum": [ "tiktok", "youtube", "twitch", "telegram", "bluesky", "snapchat", "github", "discord" ], "enumTitles": [ "TikTok", "YouTube", "Twitch", "Telegram", "Bluesky", "Snapchat", "GitHub", "Discord (invite links)" ] } }, "searchTheWeb": { "title": "Also use web search to find accounts", "type": "boolean", "description": "On, the Actor also reads the first page of Bing results for each entry and takes any profile URL it finds there. A results page is used only when the search engine highlighted enough of your words in the results; pages that could not be confirmed as the answer to your query are discarded, because they are somebody else's search results. Turning this off makes runs faster and cheaper to your Apify proxy usage, and the Actor then relies on the handles built from the name and, for websites, on the links published on the site.", "default": true }, "includeWeakMatches": { "title": "Include weak matches (confidence: low)", "type": "boolean", "description": "Off, a profile is returned only when the platform itself shows a handle or a name that matches what you asked for, or when the link is published on the website you gave. On, profiles that rest on weaker evidence are returned too, marked confidence 'low', with the reasons in the matchReasons column. Weak matches are charged like any other row, so leave this off if you do not want to pay for accounts that may belong to somebody else.", "default": false }, "country": { "title": "Country to search from", "type": "string", "description": "Two-letter ISO country code used for the web search (us, gb, de, jp, ...; uk is read as gb). Search results differ by country. The profile pages themselves are read the same way whatever you pick. Left empty, us is used and every row says so in searchCountry." }, "maxResults": { "title": "Maximum profiles to return", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The run stops once this many charged rows have been returned, and a free row says how many profiles and entries were left out.", "default": 1000 }, "maxPagesPerWebsite": { "title": "Pages to read per website", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many pages of each website in 'Company websites' to open: the home page first, then the contact, about, imprint or press pages it links to, which is where social links usually sit. Only pages on the same site are opened, and only ones robots.txt allows.", "default": 5 } } }, "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 } } } } } } } } } }