{ "openapi": "3.0.1", "info": { "title": "Skip Trace | $7/1K | People Search, Address & Phone", "description": "Skip tracing & people search across the US. Look up anyone by name, address or phone and get current + past addresses, phone numbers, relatives, aliases, emails and a profile link. Real-time public records, no subscription or API key. Basic $7/1K or Premium $15/1K deep profiles. Lawful B2B use only.", "version": "0.3", "x-build-id": "OpmW4K7q0pLf43n5M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apivault_labs~skip-trace-people-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apivault_labs-skip-trace-people-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/apivault_labs~skip-trace-people-finder/runs": { "post": { "operationId": "runs-sync-apivault_labs-skip-trace-people-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/apivault_labs~skip-trace-people-finder/run-sync": { "post": { "operationId": "run-sync-apivault_labs-skip-trace-people-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": { "name": { "title": "Names", "type": "array", "description": "Full names to look up. Optionally add a location after a semicolon to narrow results, e.g. \"Amalia Castillo; Dallas, TX 75228\".", "items": { "type": "string" } }, "street_citystatezip": { "title": "Addresses", "type": "array", "description": "Street addresses with city, state, ZIP. Example: \"2551 Pinebluff Dr; Dallas, TX 75228\". Finds people associated with the address.", "items": { "type": "string" } }, "phone_number": { "title": "Phone numbers", "type": "array", "description": "US phone numbers for reverse lookup. Example: \"(214) 321-5304\".", "items": { "type": "string" } }, "max_results": { "title": "Max results per query", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many matched people to return per input value. Each source page holds ~15 people; values above 15 fetch additional pages. Default 10.", "default": 10 }, "tier": { "title": "Tier (basic / premium)", "enum": [ "basic", "premium" ], "type": "string", "description": "basic = fast lookup (name, age, current address, phones, profile link) at $7/1K. premium = opens each person's full profile and adds phone line types, full address history, emails, relatives, aliases, work/education hints, net-worth estimate, and the record's last-updated date at $15/1K.", "default": "basic" }, "maxRetries": { "title": "Retries on transient failure", "minimum": 0, "maximum": 3, "type": "integer", "description": "Retry attempts when the source returns a transient anti-bot response.", "default": 2 }, "timeout": { "title": "Timeout per request (seconds)", "minimum": 10, "maximum": 45, "type": "integer", "description": "Max wait per page fetch.", "default": 25 }, "useResidential": { "title": "Use residential proxy fallback (recommended)", "type": "boolean", "description": "On by default. Tries fast free datacenter IPs first, then automatically falls back to residential IPs when the source blocks the datacenter (which it usually does). The search response is small, so the residential cost is only a fraction of a cent per run. Turn this off only if you want datacenter-only (free, but most lookups will be blocked).", "default": true }, "maxConcurrency": { "title": "Max parallel lookups", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many lookups (and profile pages) to fetch in parallel. Higher is faster but hits the source harder; 4 is a good balance.", "default": 4 } } }, "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 } } } } } } } } } }