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
  }
}

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
POST /api/v1/people/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.

FieldTypeDescription
full_namestringFull name of the person.
first_name, last_namestringName parts. null when the profile does not show them.
headlinestringThe person’s headline or current role description.
locationstringLocation of the person.
urlstringProfile URL.
urnstringMember URN. De-duplicate on this across pages.
profile_image_urlstringProfile picture URL.
has_morebooleanWhether another page is available. Use this, not count, to decide.
totalintegerUpper bound on matching results.
duplicates_removedintegerRepeated 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

10 credits per search. Each request returns one page of up to 50 people.

Pass a company page URL in company_linkedin_url. It is resolved to the company and applied as a current-company filter, matching anyone who holds a current role there, which may not be the role in their headline. A URL that cannot be resolved returns a 400. company_free_text filters by company name instead.

Repeated people are removed within a page, and duplicates_removed reports how many. Use has_more, not the count, to decide whether to request the next page, and de-duplicate by urn across pages.

Full name, first and last name, headline, location, profile URL, member URN and profile picture. For work history, education and skills, pass the profile URL to the People API.

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

1

Get your API key

1 min
2

POST a keyword and filters

1 min
3

Enrich the profiles you keep

Instant