Search People

GET

https://host.com/v2/datasets/odyssey/people/search

Search for people by name, company, title, or natural language query. Returns LinkedIn profiles with rich metadata including professional headline, location, bio excerpt, follower count, and school.

Use the returned entity_id with /bio, /contact, or /education-work to get full enrichment data.

Pagination: Use offset and limit to page through results. Check has_more in the response to determine if more pages are available.

Large result sets: Supports up to 500 results per request. For requests exceeding 100 results, the API automatically expands the search with query variations to discover more profiles, then deduplicates by LinkedIn URL.

Examples:

?q=engineers at Anthropic in San Francisco&limit=20
?q=Sam Altman&limit=1
?q=senior data scientists&company=Stripe&location=New York&limit=50&offset=0

Search for people by name, company, title, or natural language query. Returns LinkedIn profiles with rich metadata including professional headline, location, bio excerpt, follower count, and school. Use the returned `entity_id` with `/bio`, `/contact`, or `/education-work` to get full enrichment data. **Pagination:** Use `offset` and `limit` to page through results. Check `has_more` in the response to determine if more pages are available. **Large result sets:** Supports up to 500 results per request. For requests exceeding 100 results, the API automatically expands the search with query variations to discover more profiles, then deduplicates by LinkedIn URL. **Examples:** - `?q=engineers at Anthropic in San Francisco&limit=20` - `?q=Sam Altman&limit=1` - `?q=senior data scientists&company=Stripe&location=New York&limit=50&offset=0`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

companystring or nullOptional

Current company filter

titlestring or nullOptional

Job title filter

limitintegerOptional1-500Defaults to 10

Maximum results per page

offsetintegerOptional>=0Defaults to 0

Number of results to skip for pagination

Response

Successful Response

querystring

has_morebooleanDefaults to false

limitintegerDefaults to 10

offsetintegerDefaults to 0

resultslist of objects

total_resultsintegerDefaults to 0

Errors

422

Unprocessable Entity Error

1	import requests
2
3	url = "https://host.com/v2/datasets/odyssey/people/search"
4
5	headers = {"Authorization": "Bearer <key>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"query": "string",
3	"has_more": false,
4	"limit": 10,
5	"offset": 0,
6	"results": [
7	{
8	"entity_id": "string",
9	"full_name": "string",
10	"company": "string",
11	"description": "string",
12	"followers": 1,
13	"headline": "string",
14	"linkedin_url": "string",
15	"location": "string",
16	"school": "string"
17	}
18	],
19	"total_results": 0
20	}

Authentication

Headers

Query parameters

Response

Errors