{ "openapi": "3.0.1", "info": { "title": "Skip Trace Scraper — Phone, Email & Address by Name", "description": "Skip trace a person, address, or phone: current + previous addresses, phones, emails, relatives, age & aliases from ThatsThem, no login. Export JSON/CSV.", "version": "0.1", "x-build-id": "NTOzJyjL1GWn5JXG8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~skip-trace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-skip-trace-scraper", "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/scrapersdelight~skip-trace-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-skip-trace-scraper", "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/scrapersdelight~skip-trace-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-skip-trace-scraper", "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": { "searchType": { "title": "Search by", "enum": [ "name", "address", "phone" ], "type": "string", "description": "What you are searching with: a person's Name (+ city/state), an Address, or a Phone number. Fill the matching field(s) below.", "default": "name" }, "name": { "title": "Name", "type": "string", "description": "Name mode: the person's full name, e.g. \"John Smith\". Combine with City + State to narrow the results." }, "city": { "title": "City", "type": "string", "description": "Name mode (optional): city to narrow the name search, e.g. \"Dallas\". Leave blank to search the name nationwide." }, "state": { "title": "State (2-letter)", "type": "string", "description": "Name mode (optional): 2-letter state code to narrow the name search, e.g. \"TX\"." }, "address": { "title": "Address", "type": "string", "description": "Address mode: a full US street address, e.g. \"1600 Pennsylvania Ave NW, Washington, DC 20500\". Returns the people associated with that address." }, "phone": { "title": "Phone number", "type": "string", "description": "Phone mode: a US phone number in any format, e.g. \"214-695-0688\" or \"(214) 695-0688\". Returns the owner + associated people." }, "searches": { "title": "Bulk searches (advanced)", "type": "array", "description": "Optional. Run many lookups in one job. Each item is an object, e.g. {\"searchType\":\"name\",\"name\":\"Jane Doe\",\"city\":\"Austin\",\"state\":\"TX\"} or {\"searchType\":\"phone\",\"phone\":\"512-555-0134\"} or {\"searchType\":\"address\",\"address\":\"1 Infinite Loop, Cupertino, CA 95014\"}." }, "startUrls": { "title": "ThatsThem URLs (advanced)", "type": "array", "description": "Optional. Paste ThatsThem name/address/phone result URLs directly (e.g. https://thatsthem.com/name/John-Smith/Dallas-TX) to scrape as-is.", "items": { "type": "string" } }, "maxRecords": { "title": "Max records", "minimum": 0, "type": "integer", "description": "Cap on person records returned this run (cost/speed guard). Default 50; set 0 for every match across all searches.", "default": 50 }, "maxPhonesPerRecord": { "title": "Max phones per record", "minimum": 0, "type": "integer", "description": "Keep at most this many phone numbers per person (they are ordered most-relevant first). 0 = keep all found.", "default": 10 }, "maxEmailsPerRecord": { "title": "Max emails per record", "minimum": 0, "type": "integer", "description": "Keep at most this many email addresses per person (most-relevant first). 0 = keep all found.", "default": 10 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave on. With Apify Proxy on, every lookup goes through Apify's Unblocker, which gets past ThatsThem's human check (residential and datacenter IPs alone are shown the check). Your own proxy URLs are used as given; with the proxy off, ThatsThem shows its human check and the run stops.", "default": { "useApifyProxy": true } }, "requestConcurrency": { "title": "Request concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Max parallel requests. Keep modest to respect the site and avoid rate limits.", "default": 3 }, "diagnose": { "title": "Diagnostic mode (dev)", "type": "boolean", "description": "Dev only. Fetches the first search, logs one parsed record, then exits.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }