{ "openapi": "3.0.1", "info": { "title": "Socialscan Email & Username Account Discovery", "description": "Check authorized email addresses and usernames against Socialscan's public registration-validation integrations and return structured TAKEN, AVAILABLE, INVALID, and ERROR evidence.", "version": "0.9", "x-build-id": "p0EjCchX8kv46bzaO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~socialscan-osint/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-socialscan-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/khadinakbar~socialscan-osint/runs": { "post": { "operationId": "runs-sync-khadinakbar-socialscan-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/khadinakbar~socialscan-osint/run-sync": { "post": { "operationId": "run-sync-khadinakbar-socialscan-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": [ "queries", "authorizationConfirmed" ], "properties": { "queries": { "title": "Emails or usernames", "minItems": 1, "maxItems": 50, "type": "array", "description": "One or more full email addresses or usernames to check. Up to 50 unique identifiers are accepted per run. Emails are normalized to lowercase; usernames are passed to Socialscan as entered. Supply only authorized identifiers and use non-personal examples in any saved public task. The runtime keeps identifier values out of Actor logs; use your Apify project access controls for run input and result storage.", "items": { "type": "string", "minLength": 1, "maxLength": 254 } }, "authorizationConfirmed": { "title": "I am authorized to assess these identifiers", "type": "boolean", "description": "Required safety confirmation. Set true only when you own the supplied identifiers or have documented authorization to perform this public account-status assessment. The Actor is not a tool for unauthorized enumeration, stalking, harassment, or privacy intrusion.", "default": false }, "platforms": { "title": "Platforms", "uniqueItems": true, "type": "array", "description": "Optional cloud-verified Socialscan keys: gitlab, twitter, or tumblr. Leave [] to use all three. Email checks skip GitLab because its upstream implementation does not expose an email-availability check. Skipped integrations are reported per query and do not create a false negative.", "items": { "type": "string" }, "default": [] }, "includeAvailable": { "title": "Include AVAILABLE results", "type": "boolean", "description": "When false (default), dataset result arrays focus on TAKEN, INVALID, and ERROR responses while counts still include AVAILABLE checks. Set true when you need an auditable row for every successful platform response. This does not change which platforms are checked or billed.", "default": false }, "cacheTokens": { "title": "Cache platform tokens", "type": "boolean", "description": "Warm and reuse Socialscan's supported CSRF/API tokens once per platform for this run. Defaults to true to reduce duplicate setup requests. Disable only when you need to avoid token prewarm requests; this may increase request volume for tokenized integrations.", "default": true }, "concurrency": { "title": "Concurrent platform checks", "minimum": 1, "maximum": 16, "type": "integer", "description": "Maximum number of platform checks running at once for each identifier. Values from 1 to 16 are accepted; the default 6 is a cautious balance for public registration endpoints. This Actor processes identifiers sequentially to keep the overall request rate bounded.", "default": 6 }, "requestTimeoutSecs": { "title": "Per-platform timeout (seconds)", "minimum": 5, "maximum": 60, "type": "integer", "description": "Maximum wait for one public platform check. Values from 5 to 60 seconds are accepted and the default is 15. Timed-out checks are returned as ERROR rather than being reported as AVAILABLE or NOT_FOUND.", "default": 15 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings for public platform requests. The default uses an Apify Residential sticky session and can replace it after an inconclusive route check. Supply only an Apify-supported configuration and never place proxy credentials in Actor input. Pass {} only when direct routing is explicitly allowed by your policy.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }