Contact Search
The Prospector Endpoint enables bulk retrieval of contacts that match user-defined filters.
The Prospector API is only available under our Enterprise plans. To get access to the API, please contact us at [email protected].
To get more detail about the API parameters, response types and sample calls, click the arrow to the right on the card below.

Pre-Defined Filters

Some fields must contain strings that adhere to the pre-defined categories listed below.
'countries', 'personal_countries'
"antigua and barbuda",
"bosnia and herzegovina",
"burkina faso",
"cabo verde",
"central african republic",
"congo, democratic republic of the",
"congo, republic of the",
"costa rica",
"czech republic",
"dominican republic",
"east timor (timor-leste)",
"el salvador",
"equatorial guinea",
"korea, north",
"korea, south",
"marshall islands",
"micronesia, federated states of",
"myanmar (burma)",
"new zealand",
"north macedonia",
"papua new guinea",
"saint kitts and nevis",
"saint lucia",
"saint vincent and the grenadines",
"san marino",
"sao tome and principe",
"saudi arabia",
"sierra leone",
"solomon islands",
"south africa",
"sri lanka",
"sudan, south",
"the bahamas",
"the gambia",
"trinidad and tobago",
"united arab emirates",
"united kingdom",
"united states",
"vatican city",
"alternative dispute resolution",
"alternative medicine",
"apparel & fashion",
"architecture & planning",
"arts and crafts",
"aviation & aerospace",
"broadcast media",
"building materials",
"business supplies and equipment",
"capital markets",
"civic & social organization",
"civil engineering",
"commercial real estate",
"computer & network security",
"computer games",
"computer hardware",
"computer networking",
"computer software",
"consumer electronics",
"consumer goods",
"consumer services",
"defense & space",
"education management",
"electrical/electronic manufacturing",
"environmental services",
"events services",
"executive office",
"facilities services",
"financial services",
"fine art",
"food & beverages",
"food production",
"gambling & casinos",
"government administration",
"government relations",
"graphic design",
"higher education",
"hospital & health care",
"human resources",
"import and export",
"individual & family services",
"industrial automation",
"information services",
"information technology and services",
"international affairs",
"international trade and development",
"investment banking",
"investment management",
"law enforcement",
"law practice",
"legal services",
"legislative office",
"logistics and supply chain",
"luxury goods & jewelry",
"management consulting",
"market research",
"marketing and advertising",
"mechanical or industrial engineering",
"media production",
"medical devices",
"medical practice",
"mental health care",
"mining & metals",
"motion pictures and film",
"museums and institutions",
"non-profit organization management",
"oil & energy",
"online media",
"package/freight delivery",
"packaging and containers",
"paper & forest products",
"performing arts",
"political organization",
"primary/secondary education",
"professional training & coaching",
"program development",
"public policy",
"public relations and communications",
"public safety",
"railroad manufacture",
"real estate",
"recreational facilities and services",
"religious institutions",
"renewables & environment",
"security and investigations",
"sporting goods",
"staffing and recruiting",
"think tanks",
"translation and localization",
"venture capital & private equity",
"wine and spirits",
"writing and editing"

Credits Deduction:

The credits deducted are the minimum of the number of records found and the current page size. If there are 30 records found and the page size is 50, then 30 credits will be deducted. Vice versa, if the records are 60 and the page size is 50, then 50 credits will be deducted because the API only returned 50 contacts. The next 10 contacts will be in the next page and the credits for those will only be deducted if you send the API call for the next page to fetch those contacts.


import requests
import json
url = ""
payload = json.dumps({
"from_page": 1,
"page_size": 10,
"personal_countries": ["united states"],
"job_titles": ["founder"],
"personal_email": True
headers = {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
response = requests.request("POST", url, headers=headers, data=payload)
curl --location --request POST '' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{"from_page": 1, "page_size": 10, "personal_countries": ["united states"],
"job_titles": ["founder"], "personal_email": true}'
var myHeaders = new Headers();
myHeaders.append("x-api-key", "YOUR_API_KEY");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({
"from_page": 1,
"page_size": 10,
"personal_countries": ["united states"],
"job_titles": ["founder"],
"personal_email": true
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
fetch("", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));