PEOPLE SEARCH API
Find Profiles by Title, Company and Name
Search people by keyword and narrow by job title, company name, a company page URL, first name or last name. Get up to 50 profiles per page with name, headline, location and profile URL.
POST/api/v1/people/search
{
"status": "ok",
"data": {
"people": [
{
"full_name": "Raphaël Marinier",
"headline": "Software Engineer chez Google",
"location": "Greater Paris Metropolitan Region"
}
],
"has_more": true
}
}What is the Datamagnet People Search API?
The Datamagnet People Search API finds professional profiles by keyword and returns them as structured JSON, up to 50 per page. Filters narrow by job title, company name, current company page URL, first name and last name. Each result has the full name, headline, location, profile URL and member URN, ready to pass to the People API for the full profile.
- Input
- Keyword and filters
- Cost
- 10 credits per search
- Freshness
- Live at request time
One request
Authenticate with your API key as a bearer token and send a JSON body. This is the request behind the sample response.
POST /api/v1/people/search- Input: Keyword and filters
- Cost: 10 credits per search
curl -X POST \
"https://api.datamagnet.co/api/v1/people/search" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{"keyword": "software engineer", "company_linkedin_url": "https://www.linkedin.com/company/google/"}'→ 200 OK · 10 credits
{ "status": "ok", "data": { "people": [ { "full_name": "Raphaël Marinier", "headline": "Software Engineer chez Google", "location": "Greater Paris Metropolitan Region", "url": "https://www.linkedin.com/in/...", "urn": "ACoAAC8Np1kB17Ro_b3eo8YZWUZFudbt9lrg1Tw" }, ... ], "start": 0, "count": 50, "has_more": true }}
What you get
The main fields in the response. The People Search reference documents every field.
| Field | Type | Description |
|---|---|---|
full_name | string | Full name of the person. |
first_name, last_name | string | Name parts. null when the profile does not show them. |
headline | string | The person’s headline or current role description. |
location | string | Location of the person. |
url | string | Profile URL. |
urn | string | Member URN. De-duplicate on this across pages. |
profile_image_url | string | Profile picture URL. |
has_more | boolean | Whether another page is available. Use this, not count, to decide. |
total | integer | Upper bound on matching results. |
duplicates_removed | integer | Repeated people dropped from this page. |
Use cases
Prospect lists by role
Combine title_free_text with a company page URL to list the people in a role at a target account, then enrich the ones you want.
Find a profile URL
Have a name and an employer but no profile link? Search first_name, last_name and company_free_text and take the matching url.
Source candidates
Search a skill or job keyword with a title filter to build a sourcing list, de-duplicated by urn across pages.
Frequently asked questions
Run your first people search with 10 free credits
No credit card required. Get an API key and search by title and company in a few minutes.
- 10 credits per search
- Up to 50 people per page
- Profile URLs ready to enrich
Interactive Demo
~15 minutes
Get your API key
1 minPOST a keyword and filters
1 minEnrich the profiles you keep
Instant