{ "openapi": "3.0.1", "info": { "title": "People Search Scraper: FastPeopleSearch & TruePeopleSearch", "description": "Search FastPeopleSearch and TruePeopleSearch by name in one run for skip tracing or lead generation. Get age, addresses, phone numbers, and relatives as structured JSON, with monitor mode for tracking changes. No third-party API key needed. Not for FCRA-regulated screening use.", "version": "1.5", "x-build-id": "RfDL24me0h1gEf1JC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~people-search-lookup-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-people-search-lookup-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/getascraper~people-search-lookup-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-people-search-lookup-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/getascraper~people-search-lookup-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-people-search-lookup-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", "required": [ "fullName" ], "properties": { "fullName": { "title": "Full name", "type": "string", "description": "The person's full name to search for, e.g. \"John Smith\".", "default": "John Smith" }, "city": { "title": "City", "type": "string", "description": "Optional city to narrow the search.", "default": "" }, "state": { "title": "State", "type": "string", "description": "Optional two-letter state code to narrow the search, e.g. \"NY\".", "default": "" }, "sources": { "title": "Sources", "type": "array", "description": "Which sites to search. Leave empty to search both.", "items": { "type": "string", "enum": [ "fastpeoplesearch", "truepeoplesearch" ], "enumTitles": [ "FastPeopleSearch", "TruePeopleSearch" ] }, "default": [] }, "includeDetails": { "title": "Include phone numbers", "type": "boolean", "description": "Open each result's detail page for phone numbers. Slower and makes one extra request per result. FastPeopleSearch detail pages are reliable; TruePeopleSearch detail pages are best-effort and sometimes unavailable due to that site's own CAPTCHA gate.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of person records to return.", "default": 10 }, "onlyNewOrChanged": { "title": "Incremental monitor mode", "type": "boolean", "description": "Only return records that are new or changed since your last run with the same monitor state name. Useful for periodically re-checking whether a person's known address or phone has changed.", "default": false }, "stateName": { "title": "Monitor state name", "type": "string", "description": "Name for this run's incremental state, used only when 'Incremental monitor mode' is on. Use different names to track separate lookups independently.", "default": "default" }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Pause between page loads to stay polite to the source sites.", "default": 1000 }, "maxClearingSecsPerSite": { "title": "Time limit per site for bot checks (seconds)", "minimum": 0, "maximum": 600, "type": "integer", "description": "Both sites sometimes show a bot check that needs several fresh attempts to clear. This caps how long the Actor keeps retrying one site before moving on, so a run finishes in a predictable time. Raise it, or set 0 for no limit, if searches often come back empty.", "default": 0 } } }, "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 } } } } } } } } } }