{ "openapi": "3.0.1", "info": { "title": "Maigret Username OSINT Search", "description": "Search for a username across 3000+ social networks and websites, extracting profile data.", "version": "0.1", "x-build-id": "hewxtGUcgLmu557bd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datacach~maigret-username-osint/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datacach-maigret-username-osint", "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/datacach~maigret-username-osint/runs": { "post": { "operationId": "runs-sync-datacach-maigret-username-osint", "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/datacach~maigret-username-osint/run-sync": { "post": { "operationId": "run-sync-datacach-maigret-username-osint", "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": [ "username" ], "properties": { "username": { "title": "Username", "type": "string", "description": "The username to look up across social networks and websites. One username is searched per run. Example: johndoe" }, "topSites": { "title": "Number of sites to check", "minimum": 0, "maximum": 3000, "type": "integer", "description": "How many sites to check, ordered by popularity (Alexa rank). More sites means a more thorough search but a slower run and more results (which cost more). Set to 0 to check all 3000+ sites (slow). Free plan is capped at 100 sites and 25 results per run.", "default": 500 }, "sites": { "title": "Only these sites", "type": "string", "description": "Check only these specific sites, as a comma-separated list of site names. Leave empty to check by popularity instead. Example: GitHub,Twitter,Instagram" }, "tags": { "title": "Include site tags", "type": "string", "description": "Check only sites that carry one of these tags, as a comma-separated list. Useful to focus the search on a category. Example: social,coding,video" }, "excludeTags": { "title": "Exclude site tags", "type": "string", "description": "Skip any site that carries one of these tags, as a comma-separated list. Example: adult,dating" }, "idType": { "title": "Identifier type", "enum": [ "username", "yandex_public_id", "gaia_id", "vk_id", "ok_id", "wikimapia_uid", "steam_id" ], "type": "string", "description": "What kind of identifier you are searching for. Leave as \"Username\" unless you are looking up a platform-specific ID such as a Yandex or Steam ID.", "default": "username" }, "timeout": { "title": "Per-site timeout", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for each site to respond before giving up, in seconds. Lower values finish faster but may miss slow sites.", "default": 30 }, "maxConnections": { "title": "Max concurrent requests", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many sites to check at the same time. Higher values make the run faster but hit the network harder; lower values are gentler and more reliable on slow connections.", "default": 100 }, "noRecursion": { "title": "Disable recursive search", "type": "boolean", "description": "When enabled, the search does not follow extra usernames or IDs found on discovered profiles. When disabled (the default), Maigret recursively searches those discovered identities for a more thorough result. Always disabled on the free plan.", "default": false }, "printNotFound": { "title": "Include not-found sites", "type": "boolean", "description": "When enabled, the dataset also includes sites where the username was NOT found. When disabled (the default), only sites where the account exists are stored. Ignored on the free plan (found accounts only).", "default": false }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Route site checks through a proxy to avoid rate-limits and IP blocks. Apify Proxy is recommended for the best success rate.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }