GET /contact/search

Contact Search

Search B2B contacts on Crunchbase by job level and department with LinkedIn URLs and employer details.

Crunchbase Data API

Search for B2B contacts in the Crunchbase database filtered by job seniority level and department. Results include LinkedIn URLs, job levels, departments, and employer details with categories and locations. Use this endpoint for sales prospecting, lead generation, and building targeted contact lists.

HTTP Request

1
GET /contact/search

Parameters

ParameterTypeRequiredDefaultDescription
companystringNoOnly contacts at this company. Name, slug, or UUID
job_levelstringNoanySeniority: any, individual, manager, director, vp, exec
job_departmentstringNoanyDepartment: any, management, engineering, information_technology, operations, sales, marketing, finance, human_resources, consulting, support, design, legal, education, medical, business_development, public_relations, product, arts_and_media, data_science
per_pageintegerNo5Results per page (max 15)
pageintegerNo1Page number (sequential, 1-indexed)

Response

Example Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
{
  "status": true,
  "request_id": "86b4f7f9-ec41-7d10-d850-91ce24a4",
  "data": {
    "total": 58666711,
    "page": 1,
    "has_next_page": false,
    "results": [
      {
        "name": "Marina Favaro",
        "uuid": "e3a292e9-6123-496c-9541-7f1560131ec2",
        "type": "contact",
        "linkedin_url": "https://linkedin.com/in/marina-favaro-1698a586",
        "job_levels": [
          "individual",
          "director"
        ],
        "job_departments": [
          "marketing"
        ],
        "employer": {
          "uuid": "e10aaff2-4d89-46d4-820b-b4f64b8d42ca",
          "name": "Anthropic",
          "slug": "anthropic",
          "categories": [
            "Artificial Intelligence (AI)",
            "Foundational AI"
          ],
          "locations": [
            "San Francisco",
            "California"
          ]
        }
      },
      {
        "name": "Bret Taylor",
        "uuid": "a3093b95-bb32-49ef-811f-4c934cfbaf54",
        "type": "contact",
        "linkedin_url": "https://linkedin.com/in/brettaylor",
        "job_levels": [
          "exec"
        ],
        "job_departments": [
          "management"
        ],
        "employer": {
          "uuid": "cf2c678c-b81a-80c3-10d1-9c5e76448e51",
          "name": "OpenAI",
          "slug": "openai",
          "categories": [
            "Agentic AI",
            "Artificial Intelligence (AI)"
          ],
          "locations": [
            "San Francisco",
            "California"
          ]
        }
      }
      // ... more items
    ],
    "resolved_filters": {}
  },
  "request_params": {
    "per_page": "2",
    "page": "1"
  }
}

Response Fields

FieldTypeDescription
statusbooleanWhether the request was successful
request_idstringUnique identifier for the request
data.totalintegerTotal number of contacts matching the filters
data.pageintegerCurrent page number
data.has_next_pagebooleanWhether more pages of results are available
data.resultsarrayList of contact objects
data.results[].namestringFull name of the contact
data.results[].uuidstringContact UUID
data.results[].typestringEntity type (always "contact")
data.results[].linkedin_urlstringLinkedIn profile URL
data.results[].job_levelsarraySeniority levels (e.g., exec, director, vp, manager, individual)
data.results[].job_departmentsarrayDepartments (e.g., marketing, engineering, sales, management, finance)
data.results[].employerobjectCurrent employer details
data.results[].employer.uuidstringEmployer organization UUID
data.results[].employer.namestringEmployer name
data.results[].employer.slugstringEmployer slug — use in company-details
data.results[].employer.categoriesarrayIndustry categories (string array)
data.results[].employer.locationsarrayEmployer locations (string array: city, region)
data.resolved_filtersobjectAny filter resolutions applied by the API
request_paramsobjectEcho of the parameters sent in the request

Code Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
import requests

url = "https://crunchbase-extractor-full-api3.p.rapidapi.com/contact/search"

params = {
    "job_level": "exec",
    "job_department": "engineering",
    "per_page": "10",
    "page": "1"
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "crunchbase-extractor-full-api3.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()["data"]

print(f"Total contacts: {data['total']}")
for contact in data["results"]:
    levels = ", ".join(contact["job_levels"])
    depts = ", ".join(contact["job_departments"])
    print(f"{contact['name']}{levels} ({depts})")
    print(f"  Employer: {contact['employer']['name']}")
    print(f"  LinkedIn: {contact['linkedin_url']}")
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
const url = "https://crunchbase-extractor-full-api3.p.rapidapi.com/contact/search";

const params = new URLSearchParams({
  job_level: "exec",
  job_department: "engineering",
  per_page: "10",
  page: "1",
});

const response = await fetch(`${url}?${params}`, {
  method: "GET",
  headers: {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "crunchbase-extractor-full-api3.p.rapidapi.com",
  },
});

const { data } = await response.json();

console.log(`Total contacts: ${data.total}`);
data.results.forEach((contact) => {
  const levels = contact.job_levels.join(", ");
  const depts = contact.job_departments.join(", ");
  console.log(`${contact.name}${levels} (${depts})`);
  console.log(`  Employer: ${contact.employer.name}`);
  console.log(`  LinkedIn: ${contact.linkedin_url}`);
});
1
2
3
4
5
6
7
curl -G "https://crunchbase-extractor-full-api3.p.rapidapi.com/contact/search" \
  --data-urlencode "job_level=exec" \
  --data-urlencode "job_department=engineering" \
  --data-urlencode "per_page=10" \
  --data-urlencode "page=1" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: crunchbase-extractor-full-api3.p.rapidapi.com"
Start building today

Get your API key and make your first request in under a minute.

Get Your API Key on RapidAPI