{ "openapi": "3.0.1", "info": { "title": "Skip Trace Lookup | TruePeopleSearch & FastPeopleSearch", "description": "Look up a person by name, city/state, or phone number across TruePeopleSearch and FastPeopleSearch public records - current city, age, phone numbers, and possible relatives. No login or API key. Not for FCRA-regulated screening use.", "version": "0.1", "x-build-id": "q1cpuZsiMJi7Zz1Lv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~skip-trace-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-skip-trace-lookup", "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/themineworks~skip-trace-lookup/runs": { "post": { "operationId": "runs-sync-themineworks-skip-trace-lookup", "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/themineworks~skip-trace-lookup/run-sync": { "post": { "operationId": "run-sync-themineworks-skip-trace-lookup", "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": [ "searches" ], "properties": { "searches": { "title": "Searches", "type": "array", "description": "List of people to look up. Each entry needs EITHER a name (fullName, optionally with city/state to narrow it) OR a phone number (for a reverse phone lookup). Example: [{\"fullName\": \"John Smith\", \"city\": \"New York\", \"state\": \"NY\"}, {\"phone\": \"212-555-0100\"}]" }, "sources": { "title": "Sources", "type": "array", "description": "Which public people-search sites to query for each search, e.g. TruePeopleSearch or FastPeopleSearch. Select one or both; more sources means more matches but a longer run.", "items": { "type": "string", "enum": [ "truepeoplesearch", "fastpeoplesearch" ], "enumTitles": [ "TruePeopleSearch", "FastPeopleSearch" ] }, "default": [ "truepeoplesearch", "fastpeoplesearch" ] }, "maxResultsPerSearch": { "title": "Max matches per search", "minimum": 1, "maximum": 20, "type": "integer", "description": "Most person rows per search per site, 10 to 20 (a lower value is treated as 10). Rows with the exact name you searched come first, then related names, then other people the site listed. Each row delivered is charged.", "default": 10 }, "onlyVerified": { "title": "Only verified matches", "type": "boolean", "description": "Off (default): every person row found is delivered and charged as one row, each labelled in match_quality: verified (the name you searched, a tie to your city or state, and phone numbers), no_phone, no_place_tie, name_variant or other_name (another person the site listed). On: only verified rows are delivered and charged.", "default": false }, "reuseHours": { "title": "Reuse pages from the last hours", "minimum": 0, "maximum": 48, "type": "integer", "description": "A search or person page this account already looked up in the last this many hours (0 to 48) is reused instead of fetched again, so a repeated search comes back faster and with the same rows. Only pages that returned people are kept, and only the records a row can come from, in key value stores named skip-trace-lookup-pages plus the date in your account, one per day, each deleted after 2 days. 0 turns this off and keeps nothing.", "default": 24 }, "monitorMode": { "title": "Monitor mode (only new or changed rows)", "type": "boolean", "description": "Run on a schedule and deliver ONLY person rows that are new or whose listing changed since a previous run (a new phone number, a move, a new age). You are charged per delivered row, not for every row each time. Ideal for monthly checks of a contact list. Requires the same input across runs.", "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 } } } } } } } } } }