Role Search

Search for job roles across all companies in the Crunchbase database. Filter by role type (employee, board member, advisor) and whether the role is currently active. Use this endpoint to discover who holds specific positions, track executive movements, or build org charts.

HTTP Request

1
GET /role/search

Parameters

Parameter	Type	Required	Default	Description
`company`	string	No	—	Reverse lookup: roles held at this company. Name, slug, or UUID
`person`	string	No	—	Reverse lookup: every role this person has held. Name, slug, or UUID
`title`	string	No	—	Filter by role title (substring match). E.g. `CEO` matches ‘CEO’, ‘Co-CEO’
`role_type`	string	No	`any`	Role category: `any`, `employee`, `executive`, `board_member`, `advisor`, `board_observer`
`is_current`	string	No	`any`	`true` for currently-held roles only, `false` for former, `any` for both
`started_on_after`	string	No	—	Only roles that began on or after this date (`YYYY-MM-DD`)
`started_on_before`	string	No	—	Only roles that began on or before this date (`YYYY-MM-DD`)
`per_page`	integer	No	`5`	Results per page (max 15)
`order_by`	string	No	`started_on`	Sort field. `started_on` = chronological, `identifier` = alphabetical
`sort`	string	No	`desc`	`desc` for newest first

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
{
  "status": true,
  "request_id": "05b7c0e7-8bdc-dcc9-41fd-1d424ccb",
  "data": {
    "total": 338812,
    "page": 1,
    "has_next_page": false,
    "results": [
      {
        "name": "Henri Kuusla Networks Manager, Investors & Partnerships @ Maria 01",
        "slug": "henri-kuusla-employee-maria-01--a31726d2",
        "uuid": "a31726d2-14c9-4e65-9440-807ca48cab97",
        "image": null,
        "type": "job",
        "company": {
          "uuid": "5b20f729-e642-4286-b2e3-246851ef6df8",
          "slug": "maria-01",
          "name": "Maria 01",
          "type": "organization",
          "image": "https://images.crunchbase.com/image/upload/vxi8mtrgc1e8wg9bxvqb"
        },
        "person": {
          "uuid": "f8e2ba3c-11de-4fb9-be6d-94d7ef91acc9",
          "slug": "henri-kuusla",
          "name": "Henri Kuusla",
          "type": "person",
          "image": "https://images.crunchbase.com/image/upload/disfu51aeppixk8hes4v"
        },
        "title": "Networks Manager, Investors & Partnerships",
        "started_on": "1028-08-29"
      }
      // ... more items
    ],
    "resolved_filters": {}
  },
  "request_params": {
    "per_page": "2",
    "order_by": "started_on",
    "role_type": "employee",
    "sort": "asc",
    "is_current": "true"
  }
}

Response Fields

Field	Type	Description
`status`	boolean	Whether the request was successful
`request_id`	string	Unique identifier for the request
`data.total`	integer	Total number of roles matching the filters
`data.page`	integer	Current page number
`data.has_next_page`	boolean	Whether more pages of results are available
`data.results`	array	List of role/job objects
`data.results[].name`	string	Composite name (person + title + company)
`data.results[].slug`	string	Unique role slug
`data.results[].uuid`	string	Role UUID
`data.results[].image`	string/null	Image URL (typically null for roles)
`data.results[].type`	string	Entity type (always `"job"`)
`data.results[].company`	object	Organization where the role is held
`data.results[].company.uuid`	string	Organization UUID
`data.results[].company.slug`	string	Organization slug — use in company-details
`data.results[].company.name`	string	Organization name
`data.results[].company.type`	string	Entity type (always `"organization"`)
`data.results[].company.image`	string	Organization logo URL
`data.results[].person`	object	Person holding the role
`data.results[].person.uuid`	string	Person UUID
`data.results[].person.slug`	string	Person slug — use in person-details
`data.results[].person.name`	string	Person name
`data.results[].person.type`	string	Entity type (always `"person"`)
`data.results[].person.image`	string/null	Person profile image URL
`data.results[].title`	string	Job title
`data.results[].started_on`	string	Start date of the role
`data.resolved_filters`	object	Any filter resolutions applied by the API
`request_params`	object	Echo 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
import requests

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

params = {
    "role_type": "employee",
    "is_current": "true",
    "per_page": "10",
    "order_by": "started_on",
    "sort": "desc"
}

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 roles: {data['total']}")
for role in data["results"]:
    print(f"{role['person']['name']} — {role['title']}")
    print(f"  Company: {role['company']['name']} (since {role['started_on']})")

 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
const url = "https://crunchbase-extractor-full-api3.p.rapidapi.com/role/search";

const params = new URLSearchParams({
  role_type: "employee",
  is_current: "true",
  per_page: "10",
  order_by: "started_on",
  sort: "desc",
});

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 roles: ${data.total}`);
data.results.forEach((role) => {
  console.log(`${role.person.name} — ${role.title}`);
  console.log(`  Company: ${role.company.name} (since ${role.started_on})`);
});

1
2
3
4
5
6
7
8
curl -G "https://crunchbase-extractor-full-api3.p.rapidapi.com/role/search" \
  --data-urlencode "role_type=employee" \
  --data-urlencode "is_current=true" \
  --data-urlencode "per_page=10" \
  --data-urlencode "order_by=started_on" \
  --data-urlencode "sort=desc" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: crunchbase-extractor-full-api3.p.rapidapi.com"

Person Search — Search people by investor status and gender
Company People — Get all people for a specific company
Contact Search — Search B2B contacts by seniority and department