Skip Trace API — Phone, Email & Address Lookup
Pricing
from $6.00 / 1,000 person with contact data
Skip trace anyone in the US by name, phone, email or address — one lookup or a list of 1,000, a few seconds each, no browser. Phones with carrier and line type, emails, addresses and relatives, merged from several people-search databases into one row. Pay only for named people with contact data.
You can access the Skip Trace API — Phone, Email & Address Lookup programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "POQtousvlygll9bJG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mu0i~skip-tracing-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mu0i-skip-tracing-api", "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/mu0i~skip-tracing-api/runs": { "post": { "operationId": "runs-sync-mu0i-skip-tracing-api", "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/mu0i~skip-tracing-api/run-sync": { "post": { "operationId": "run-sync-mu0i-skip-tracing-api", "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": { "name": { "title": "Names", "type": "array", "description": "One person per line, ideally with a location after a semicolon: \"Michael Johnson; Los Angeles, CA\" or \"Michael Johnson; 90001\". A location greatly improves matches for common names.", "items": { "type": "string" } }, "street_citystatezip": { "title": "Addresses (reverse address lookup)", "type": "array", "description": "Street, a semicolon, then city/state/ZIP: \"350 5th Ave; New York, NY\". Add \"| Full Name\" to keep only one resident: \"350 5th Ave; New York, NY | John Smith\".", "items": { "type": "string" } }, "phone_number": { "title": "Phone numbers (reverse phone lookup)", "type": "array", "description": "US numbers in any format: \"(212) 665-1000\", \"2126651000\" or \"+1 212-665-1000\". Optionally add \"| Full Name\".", "items": { "type": "string" } }, "email": { "title": "Emails (reverse email lookup)", "type": "array", "description": "Email addresses to look up the person behind. Optionally add \"| Full Name\".", "items": { "type": "string" } }, "personFilter": { "title": "Only this person, for every search (optional)", "type": "string", "description": "Keep only people whose full name contains all these words, e.g. \"John Smith\". Applies to every entry that has no \"| Full Name\" of its own." }, "csvUrl": { "title": "CSV or Google Sheet URL (optional)", "type": "string", "description": "Paste a Google Sheet link (shared as \"Anyone with the link\") or a link to a CSV file (Google Drive and Dropbox links work too). Each row is one search. Columns like Name / Owner Name, Address / Property Address (plus City, State, Zip), Phone and Email are recognized; an owner name pinpoints the right person at an address. A single column with no header is searched line by line. Adds to anything typed in the lists above. Column rules: README › \"From a CSV or Google Sheet\"." }, "fallbackWhenNoMatch": { "title": "If the named person isn't found, return the first person instead", "type": "boolean", "description": "Applies to entries with a \"| Full Name\" filter. Off: a miss is a free not_found row that says how many other people the search found. On: you get the first people found anyway, flagged nameMatch: false, and they are billed like any result.", "default": false }, "flatOutput": { "title": "Spreadsheet columns (Phone-1 … Phone-5, Email-1 … Email-5)", "type": "boolean", "description": "Also add the flat column layout other skip trace Actors use — Search Option, Input Given, First/Last Name, Age, Born, Lives in, Street Address, Address Locality/Region, Postal Code, County Name, ZIP+4, Latitude, Longitude, Deliverable, Email-1…5, Phone-1…5 with Type, Provider and First/Last Reported, Previous Addresses, Relatives, Associates — on top of the regular fields. Turn on to keep an existing sheet, Zapier zap or CRM mapping working without changes: Postal Code is still the 5-digit ZIP and no column was renamed or removed, so a mapping that matches on column NAMES is unaffected (one that matches on column POSITION will see the four new columns after County Name).", "default": false }, "maxResults": { "title": "Max people per search", "minimum": 1, "maximum": 50, "type": "integer", "description": "Most people to return per search (1–50). Records for the same person are merged and the best-corroborated person comes first, so 1 is right for list skip tracing. Raise it for common names without a location, or to see a whole household at an address. Each extra named person with contact data is one billed result. Free Apify plan: at most 3 results per run.", "default": 1 }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches run at once (1–10). Higher finishes long lists sooner.", "default": 3 } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Skip Trace API — Phone, Email & Address Lookup from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: