{ "openapi": "3.0.1", "info": { "title": "Skip Tracer — TruePeopleSearch Scraper", "description": "Scrapes TruePeopleSearch to find phone numbers, emails, and relatives for property owners. Input: array of name/address records. Output: enriched contact data for skip tracing.", "version": "0.1", "x-build-id": "YhtkyXtncocg4vDcF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datasiphon~skip-tracer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datasiphon-skip-tracer", "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/datasiphon~skip-tracer/runs": { "post": { "operationId": "runs-sync-datasiphon-skip-tracer", "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/datasiphon~skip-tracer/run-sync": { "post": { "operationId": "run-sync-datasiphon-skip-tracer", "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": { "queries": { "title": "Search Queries (legacy)", "type": "array", "description": "Array of person records to look up. Each record has name, city, and state. Kept for backward compatibility with the old actor — you can use it exactly as before." }, "name": { "title": "Names", "type": "array", "description": "Batch list of full names to look up, e.g. [\"John Smith\", \"Mary Jane Doe\"]. You can combine with city/state by passing objects {\"name\": \"John Smith\", \"city\": \"Dallas\", \"state\": \"TX\"}.", "items": { "type": "string" } }, "address": { "title": "Addresses (reverse lookup)", "type": "array", "description": "List of street addresses to reverse-search and find who lives there, e.g. [\"123 Main St\", \"456 Oak Ave\"]. You can include city/state by passing {\"address\": \"123 Main St\", \"city\": \"Dallas\", \"state\": \"TX\"}.", "items": { "type": "string" } }, "phone_number": { "title": "Phone Numbers (reverse lookup)", "type": "array", "description": "List of phone numbers to reverse-search and identify the owner, e.g. [\"214-349-3972\", \"+14155552671\"].", "items": { "type": "string" } }, "email": { "title": "Emails (reverse lookup)", "type": "array", "description": "List of email addresses to reverse-search and find the owner, e.g. [\"john.smith@example.com\"].", "items": { "type": "string" } }, "csvUrl": { "title": "Bulk CSV / Google Sheets URL", "type": "string", "description": "URL to a CSV file or a Google Sheets share link. Header row is detected (Name / Address / Phone / Email / City / State columns). Each row becomes a lookup. Great for bulk skip-tracing." }, "maxResultsPerQuery": { "title": "Max Results Per Query", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of candidate people to harvest and merge per name/address/phone lookup.", "default": 5 }, "source": { "title": "Data Sources", "enum": [ "auto", "fastpeoplesearch", "truepeoplesearch", "thatsthem" ], "type": "string", "description": "Which people-search sources to use. 'auto' (default) uses all available sources for best corroboration. Pick a single source to keep runs fast and cheap.", "default": "auto" }, "verifyEmailsFlag": { "title": "Verify Emails", "type": "boolean", "description": "Check each discovered email for deliverability via DNS MX/A record lookup. Adds a small delay but lets you filter out dead addresses.", "default": false }, "flatOutput": { "title": "Flat Output", "type": "boolean", "description": "Collapse all array fields (phones, emails, relatives, addresses) into ; separated flat columns so the dataset is clean for CSV/Excel export.", "default": false }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional URL to POST the full results JSON to when the run completes." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "People-search sites (FastPeopleSearch, TruePeopleSearch, That'sThem) are protected by Cloudflare and heavily rate-limited. Use an Apify proxy with a residential group — or any custom proxy URL — to get results. Without a proxy, runs will likely return empty records.", "default": { "useApifyProxy": false } }, "unblockerUrlTemplate": { "title": "Unblocker URL Template", "type": "string", "description": "Optional: a URL template that wraps target URLs to route them through your anti-bot unblocker, e.g. 'https://my-unblocker.com/fetch?url={{URL}}'. Leave empty to fetch directly." }, "demoMode": { "title": "Demo Mode", "type": "boolean", "description": "Return a sample record per input without scraping any site. Useful to test your pipeline / output schema for free.", "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 } } } } } } } } } }