ExactBuyer Docs
1.0.0
Search
⌃K

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.
API Response
Retrieved Contacts
{
"credits_deducted": 4,
"page": 1,
"page_size": 10,
"records_returned": 4,
"results": [
{
"accomplishment_courses": [
{
"name": "Artificial Intelligence",
"number": "6.034"
},
{
"name": "Computational Structures",
"number": "6.004"
},
{
"name": "Design and Analysis of Algorithms",
"number": "6.046"
},
{
"name": "Software Construction",
"number": "6.005"
}
],
"accomplishment_honors_awards": [
{
"description": "Over the weekend our team Elevate (now BeatBat Music) created a promotions platform for musicians to publish their events to local news publication calendars. This became a full time project.",
"issued_on": {
"day": 1,
"month": 3,
"year": 2016
},
"issuer": "Start Up Weekend Seattle",
"title": "Winner of Start-Up Weekend Seattle"
}
],
"accomplishment_organisations": [],
"accomplishment_patents": [],
...
}
,
{ ...
"current_work_email": "[email protected]",
"education": [
{
"degrees": [
"bachelors",
"bachelor of science"
],
"end_date": "2012",
"gpa": null,
"locations": [],
"majors": [
"computer science",
"management",
"management science"
],
"minors": [],
"school": {
"location": "cambridge, massachusetts, united states",
"name": "massachusetts institute of technology",
"profiles": [
"linkedin.com/edu/massachusetts-institute-of-technology-18494"
],
"type": "post-secondary institution",
"website": "mit.edu"
},
"start_date": "2008"
}
],
"total_records_found": 4
}

Pre-Defined Filters

Some fields must contain strings that adhere to the pre-defined categories listed below.
'languages'
'seniorities'
departments
'company_size'
company_revenues
last_funding_round_type
company_type
'countries', 'personal_countries'
'industries'
"africaans",
"afrikaans",
"albanian",
"american Sign Language",
"amharic",
"anglais",
"arabic",
"arabic (tourist, rusty)",
"aramaic",
"armenian",
"assamese",
"aymara",
"azerbaijani",
"bahasa Indonesia",
"balochi",
"bamanankan",
"basque",
"belarusan",
"belarusian",
"bengali",
"bhojpuri",
"bislama",
"bosnian",
"brahui",
"bulgarian",
"burmese",
"cantonese",
"catalan",
"català",
"cebuano",
"chechen",
"cherokee",
"chinese",
"chinese",
"chinese (Simplified)",
"chinois",
"circassian (Адыгэбзэ)",
"croatian",
"czech",
"dakota",
"danish",
"dari",
"dholuo",
"dutch",
"engels",
"english",
"espagnol",
"español",
"esperanto",
"estonian",
"farsi",
"filipino",
"finnish",
"fluent English. Spoken and written",
"français",
"french",
"french (rusty)",
"galician",
"georgian",
"german",
"german",
"german (tourist, rusty)",
"gikuyu",
"greek",
"guarani",
"gujarati",
"haitian creole",
"hausa",
"hawaiian",
"hawaiian creole",
"hebreeuws",
"hebrew",
"hiligaynon",
"hindi",
"hindi",
"hindi, Tamil",
"hungarian",
"icelandic",
"igbo",
"ilocano",
"indonesian",
"ingles",
"inglés",
"irish gaelic",
"ital",
"italian",
"japanese",
"japonais",
"jarai",
"javanese",
"kabyle",
"kannada",
"kashmiri",
"kazakh",
"khmer",
"khoekhoe",
"konkani",
"korean",
"kurdish",
"kyrgyz",
"k’iche’",
"lao",
"latin",
"latvian",
"lingala",
"lithuanian",
"macedonian",
"maithili",
"malagasy",
"malay",
"malayalam",
"mandarin",
"mandarin Chinese",
"marathi",
"marwari",
"mende",
"mongolian",
"nahuatl",
"navajo",
"nederlands",
"nepali",
"norwegian",
"ojibwa",
"oriya",
"oromo",
"pashto",
"persian",
"polish",
"portugese",
"portuguese",
"portugués",
"punjabi",
"quechua",
"romani",
"romanian",
"russe",
"russian",
"russian (Русский)",
"rwanda",
"samoan",
"sanskrit",
"serbian",
"shona",
"sindhi",
"sinhala",
"sinhalese",
"slovak",
"slovene",
"slovenian",
"somali",
"spanish",
"swahili",
"swedish",
"tachelhit",
"tagalog",
"taiwanese",
"tajiki",
"tamil",
"tatar",
"telugu",
"thai",
"tigrigna",
"tok pisin",
"turkish",
"turkmen",
"ukrainean",
"ukrainian",
"ukranian",
"urdu",
"urdu",
"urdu/hindi",
"uyghur",
"uzbek",
"vietnamese",
"warlpiri",
"welsh",
"wolof",
"xhosa",
"yakut",
"yiddish",
"yoruba",
"yucatec",
"zapotec",
"zulu",
"éwé",
"Английский",
"executive",
"director & vp",
"mid-level",
"entry"
"csuite",
"engineering_technical",
"design",
"education",
"finance",
"human_resources",
"information_technology",
"legal",
"marketing",
"medical_health",
"operations",
"sales",
"consulting",
"customer_success_support"
"1-10",
"11-50",
"51-200",
"201-500",
"501-1000",
"1001-5000",
"5001-10000",
"10001+"
"$0-$1m",
"$1m-$5m",
"$5m-$20m",
"$20m-$50m",
"$50m-$100m",
"$100m-$500m",
"$500m-$1b",
"$1b-$5b",
"$5b-$10b",
"$10b+"
"angel",
"seed",
"series_a",
"series_b",
"series_c",
"series_d",
"series_e",
"series_f",
"series_g",
"series_h",
"convertible_note",
"corporate_round",
"debt_financing",
"equity_crowdfunding",
"grant",
"initial_coin_offering",
"non_equity_assistance",
"post_ipo_debt",
"post_ipo_equity",
"post_ipo_secondary",
"pre_seed",
"private_equity",
"product_crowdfunding",
"secondary_market",
"series_unknown",
"undisclosed"
"EDUCATIONAL_INSTITUTION",
"GOVERNMENT_AGENCY",
"NONPROFIT",
"PARTNERSHIP",
"PRIVATELY_HELD",
"PUBLIC_COMPANY",
"'SELF-EMPLOYED",
"SOLE_PROPRIETORSHIP"
"afghanistan",
"albania",
"algeria",
"andorra",
"angola",
"antigua and barbuda",
"argentina",
"armenia",
"australia",
"austria",
"azerbaijan",
"bahrain",
"bangladesh",
"barbados",
"belarus",
"belgium",
"belize",
"benin",
"bhutan",
"bolivia",
"bosnia and herzegovina",
"botswana",
"brazil",
"brunei",
"bulgaria",
"burkina faso",
"burundi",
"cabo verde",
"cambodia",
"cameroon",
"canada",
"central african republic",
"chad",
"chile",
"china",
"colombia",
"comoros",
"congo, democratic republic of the",
"congo, republic of the",
"costa rica",
"croatia",
"cuba",
"cyprus",
"czech republic",
"denmark",
"djibouti",
"dominica",
"dominican republic",
"east timor (timor-leste)",
"ecuador",
"egypt",
"el salvador",
"equatorial guinea",
"eritrea",
"estonia",
"eswatini",
"ethiopia",
"fiji",
"finland",
"france",
"gabon",
"georgia",
"germany",
"ghana",
"greece",
"grenada",
"guatemala",
"guinea",
"guinea-bissau",
"guyana",
"haiti",
"honduras",
"hungary",
"iceland",
"india",
"indonesia",
"iran",
"iraq",
"ireland",
"israel",
"italy",
"jamaica",
"japan",
"jordan",
"kazakhstan",
"kenya",
"kiribati",
"korea, north",
"korea, south",
"kosovo",
"kuwait",
"kyrgyzstan",
"laos",
"latvia",
"lebanon",
"lesotho",
"liberia",
"libya",
"liechtenstein",
"lithuania",
"luxembourg",
"madagascar",
"malawi",
"malaysia",
"maldives",
"mali",
"malta",
"marshall islands",
"mauritania",
"mauritius",
"mexico",
"micronesia, federated states of",
"moldova",
"monaco",
"mongolia",
"montenegro",
"morocco",
"mozambique",
"myanmar (burma)",
"namibia",
"nauru",
"nepal",
"netherlands",
"new zealand",
"nicaragua",
"niger",
"nigeria",
"north macedonia",
"norway",
"oman",
"pakistan",
"palau",
"panama",
"papua new guinea",
"paraguay",
"peru",
"philippines",
"poland",
"portugal",
"qatar",
"romania",
"russia",
"rwanda",
"saint kitts and nevis",
"saint lucia",
"saint vincent and the grenadines",
"samoa",
"san marino",
"sao tome and principe",
"saudi arabia",
"senegal",
"serbia",
"seychelles",
"sierra leone",
"singapore",
"slovakia",
"slovenia",
"solomon islands",
"somalia",
"south africa",
"spain",
"sri lanka",
"sudan",
"sudan, south",
"suriname",
"sweden",
"switzerland",
"syria",
"taiwan",
"tajikistan",
"tanzania",
"thailand",
"the bahamas",
"the gambia",
"togo",
"tonga",
"trinidad and tobago",
"tunisia",
"turkey",
"turkmenistan",
"tuvalu",
"uganda",
"ukraine",
"united arab emirates",
"united kingdom",
"united states",
"uruguay",
"uzbekistan",
"vanuatu",
"vatican city",
"venezuela",
"vietnam",
"yemen",
"zambia",
"zimbabwe"
"accounting",
"airlines and aviation",
"alternative dispute resolution",
"alternative medicine",
"animation",
"apparel and fashion",
"architecture and planning",
"armed forces",
"automation machinery manufacturing",
"automotive",
"aviation & aerospace",
"banking",
"beverage manufacturing",
"biotechnology",
"biotechnology research",
"broadcast media",
"building materials",
"business skills training",
"business supplies and equipment",
"capital markets",
"chemical manufacturing",
"chemicals",
"civic and social organization",
"civil engineering",
"commercial real estate",
"computer and network security",
"computer games",
"computer hardware",
"computer hardware manufacturing",
"computer networking",
"computer networking products",
"computer software",
"construction",
"consumer electronics",
"consumer goods",
"consumer services",
"cosmetics",
"dairy",
"dairy product manufacturing",
"defense and space",
"design",
"design services",
"e-learning",
"e-learning providers",
"education administration programs",
"education management",
"electrical/electronic manufacturing",
"entertainment",
"entertainment providers",
"environmental services",
"events services",
"executive office",
"facilities services",
"farming",
"financial services",
"fine art",
"fishery",
"food & beverages",
"food production",
"fund-raising",
"furniture",
"gambling and casinos",
"glass, ceramics and concrete",
"government administration",
"government relations",
"government relations services",
"graphic design",
"higher education",
"hospital and health care",
"hospitality",
"human resources",
"human resources services",
"individual and family services",
"industrial automation",
"industrial automation machinery",
"industrial machinery",
"industrial machinery manufacturing",
"information services",
"insurance",
"international affairs",
"international trade and development",
"internet",
"internet publishing",
"investment banking",
"investment management",
"judiciary",
"law enforcement",
"law practice",
"leasing real estate",
"legal services",
"leisure, travel and tourism",
"libraries",
"logistics and supply chain",
"luxury goods and jewelry",
"machinery",
"machinery manufacturing",
"management consulting",
"manufacturing",
"maritime",
"maritime transportation",
"market research",
"marketing services",
"mechanical engineering",
"media production",
"medical devices",
"medical equipment",
"medical equipment manufacturing",
"medical practices",
"mental health care",
"military",
"mining",
"mining and metals",
"motor vehicle manufacturing",
"music",
"musicians",
"nanotechnology",
"nanotechnology research",
"newspaper publishing",
"newspapers",
"non-profit organization management",
"oil and energy",
"online media",
"outsourcing/offshoring",
"package and freight delivery",
"paper and forest products",
"performing arts",
"performing arts companies",
"personal care product manufacturing",
"pharmaceutical manufacturing",
"pharmaceuticals",
"philanthropic fundraising services",
"philanthropy",
"photography",
"plastics",
"plastics manufacturing",
"political organizations",
"primary and secondary education",
"printing",
"printing services",
"professional training & coaching",
"program development",
"public policy",
"public policy offices",
"public safety",
"publishing",
"railroad manufacturing",
"ranching",
"real estate",
"recreational facilities",
"recruiting",
"religious institutions",
"renewable energy semiconductor manufacturing",
"renewables and environment",
"research",
"research services",
"restaurants",
"retail",
"retail art supplies",
"retail groceries",
"retail office equipment",
"semiconductor manufacturing",
"semiconductors",
"shipbuilding",
"software development",
"spectator sports",
"sporting goods",
"sporting goods manufacturing",
"sports",
"strategic management services",
"supermarkets",
"telecommunications",
"textile manufacturing",
"textiles",
"think tanks",
"tobacco",
"transportation/trucking/railroad",
"travel arrangements",
"truck transportation",
"utilities",
"venture capital and private equity",
"veterinary",
"veterinary services",
"warehousing",
"wholesale",
"wholesale building materials",
"wireless",
"wireless services",
"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.

Examples

Python
cURL
Javascript
import requests
import json
url = "https://api.exactbuyer.com/v1/prospector"
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)
print(response.text)
curl --location --request POST 'api.exactbuyer.com/v1/prospector' \
--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("api.exactbuyer.com/v1/prospector", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));