{ "openapi": "3.0.1", "info": { "title": "ThatsThem People Search Scraper", "description": "Reverse phone, email, and address lookup plus name search — free US people data from ThatsThem. Find a US person's name, age, phone numbers, addresses, and relatives by NAME, PHONE, EMAIL, or ADDRESS. No login or paywall.", "version": "0.1", "x-build-id": "LgWYSjqcHfLdLKacl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~thatsthem-people-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-thatsthem-people-search-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/jungle_synthesizer~thatsthem-people-search-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-thatsthem-people-search-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/jungle_synthesizer~thatsthem-people-search-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-thatsthem-people-search-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": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "What will this data feed? E.g. lead lists, KYB checks, price tracking." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact email (optional)", "minLength": 1, "type": "string", "description": "We'll personally help with your use case. No spam." }, "firstName": { "title": "First Name", "type": "string", "description": "First name to search for (name mode — pair with lastName)" }, "lastName": { "title": "Last Name", "type": "string", "description": "Last name to search for (name mode — pair with firstName)" }, "city": { "title": "City", "type": "string", "description": "City to narrow a name search (optional, used with state)" }, "state": { "title": "State", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "DC" ], "type": "string", "description": "US state abbreviation to narrow a name or address search" }, "phone": { "title": "Phone Number", "type": "string", "description": "US phone number for reverse-phone lookup (e.g. 5551234567 or 555-123-4567)" }, "email": { "title": "Email Address", "type": "string", "description": "Email address for reverse-email lookup" }, "address": { "title": "Street Address", "type": "string", "description": "Street address for reverse-address lookup — requires city and state (e.g. \"123 Main St\")" }, "name": { "title": "Full Name (alternative to First/Last Name)", "type": "string", "description": "Full name as one field, e.g. \"Kim Layton\" — used only when firstName/lastName are not set" }, "query": { "title": "Search Query (alias for Full Name)", "type": "string", "description": "Alias for the name field — used only when firstName/lastName/name are not set" }, "searches": { "title": "Batch — search several people at once (optional)", "type": "array", "description": "Optional. A list of lookups to run in ONE actor run, instead of one run per person. Each entry takes the same fields as a single search (firstName+lastName, phone, email, address+city+state, or name/query); the lookup mode is inferred from the fields present, same as a single search. Any field you set at the top level is inherited as a default by every entry. maxItems caps the WHOLE run, so 3 entries with maxItems 10 return at most 10 records in total — set maxItemsPerSearch as well if you want a guaranteed share for each entry (e.g. 30 lookups, maxItems 30, maxItemsPerSearch 1 for one record per person). Batching is much faster than separate runs — the site's anti-bot challenge is cleared once for the whole batch instead of once per person. Leave empty to run a single search." }, "maxItems": { "title": "Max Items (total for the run)", "type": "integer", "description": "Maximum number of person records this run returns and is billed for, in total (0 = unlimited). In batch mode it caps the whole run, not each search — 10 phone numbers with maxItems 5 return 5 records, not 50.", "default": 10 }, "maxItemsPerSearch": { "title": "Max Items per search entry (batch only)", "minimum": 1, "type": "integer", "description": "Optional, and only meaningful with a batch. The most records any ONE search entry may take out of the maxItems budget, so an early entry with many matches cannot use it all up and leave the later entries with nothing. Leave empty and each entry may use the whole budget. Example: 30 people with maxItems 30 and maxItemsPerSearch 1 returns one record per person." } } }, "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 } } } } } } } } } }