{ "openapi": "3.0.1", "info": { "title": "Social Media Finder by Name — Find Profiles on 3000+ Sites", "description": "Enter a person's name and get their public social media profiles. The name becomes ranked username candidates, each checked against 3000+ sites, returning one row per confirmed profile with URL, category and confidence. Powered by open-source maigret (MIT). Unofficial wrapper.", "version": "1.0", "x-build-id": "MKMEYbxthAcjsXcdH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ntriqpro~social-media-finder-by-name/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ntriqpro-social-media-finder-by-name", "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/ntriqpro~social-media-finder-by-name/runs": { "post": { "operationId": "runs-sync-ntriqpro-social-media-finder-by-name", "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/ntriqpro~social-media-finder-by-name/run-sync": { "post": { "operationId": "run-sync-ntriqpro-social-media-finder-by-name", "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", "required": [ "disclaimerAck" ], "properties": { "names": { "title": "Names", "type": "array", "description": "People to look up, by name. Write a full name as plain text (\"John Smith\") — the Actor turns it into username candidates for you. Up to 10 names per run. Runtime grows with names x maxPermutations, so start small and scale up once you like the results. Free plan: each run returns up to 25 results. Paid Apify plans receive the full result set.", "items": { "type": "string" } }, "name": { "title": "Name (single)", "type": "string", "description": "Alternative to the list above — one name to look up." }, "maxPermutations": { "title": "Username candidates per name", "minimum": 1, "maximum": 72, "type": "integer", "description": "How many username candidates to build from each name and check. Candidates are ranked, so the most plausible forms (johnsmith, john.smith, john_smith) are always tried first. Higher means more coverage and a longer run. Range 1-72, default 6." }, "siteScope": { "title": "How many sites to check", "enum": [ "top300", "top500", "all3000" ], "type": "string", "description": "top500 checks the 500 most-visited sites and is the right default. all3000 checks the engine's whole catalogue of 3000+ sites — far more coverage, several times the runtime. top300 is the fast option for large batches." }, "minConfidence": { "title": "Minimum confidence", "type": "string", "description": "Drop profiles scored below this (0 to 1). Confidence combines how well the username matches the name with the engine's own match signals, so raising it filters out the coincidences that common names attract. 0.5 keeps everything plausible; 0.8 keeps only full-name matches." }, "timeout": { "title": "Per-site timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for each site to respond. Higher means fewer false negatives and a slower run. Range 5-120." }, "concurrency": { "title": "Username candidates checked in parallel", "minimum": 1, "maximum": 4, "type": "integer", "description": "How many username candidates are looked up at the same time. 2 is a good balance; raise it to shorten large runs, lower it to 1 if sites start rate-limiting you." }, "monitorMode": { "title": "Monitor mode (change alerts)", "type": "boolean", "description": "Compare this run with the previous run for the same monitor key and label every profile new / changed / removed / unchanged. Schedule the Actor and you get only what changed since last time. The first run saves a baseline and returns everything.", "default": false }, "monitorKey": { "title": "Monitor key (optional)", "type": "string", "description": "Name this watch, e.g. \"acme-candidates-weekly\". Runs sharing a key are compared with each other, so you can keep several independent watches. Leave empty and the key is derived from your input automatically." }, "includeUnchanged": { "title": "Monitor mode: include unchanged profiles", "type": "boolean", "description": "In monitor mode, also return profiles that did not change since the previous run. Off by default, so a scheduled run stays a short change report.", "default": false }, "extractProfileFields": { "title": "Extract profile details (opt-in)", "type": "boolean", "description": "Off by default. When off, results contain account-existence evidence only: site, profile URL, category, confidence. Turn it on to also save personal details the page exposes — full name, bio, avatar, location. You become the data controller for any personal data you collect this way, so only enable it when you have a lawful basis (GDPR/CCPA/PIPA).", "default": false }, "includeAdultSites": { "title": "Include adult sites", "type": "boolean", "description": "Include adult and webcam sites in the lookup. Excluded by default.", "default": false }, "disclaimerAck": { "title": "I will use these results lawfully", "type": "boolean", "description": "Required. Confirms you have a lawful basis for looking these people up, that a username match is not proof of identity, and that you are the data controller for whatever you collect. See the README for the full notice.", "default": 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 } } } } } } } } } }