Paid checkout is currently closed. Prices below are listed for reference; request an opening notification in your billing dashboard.

// People search API

LinkedIn people search API

Describe the people you are looking for with filters and get matching LinkedIn profile slugs, ten per page. Turn any of them into a full profile with one more call.

12 filtersTitle, company, past company, country, city, school, company size and more.
10 profiles a pageFollow next_cursor until it is null.
1 credit a pageCharged only for pages that have results.
Works with enrichmentEach slug becomes a full profile on request.
curl -X POST https://enrichgrid.com/v1/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"filters": {"country": ["US"], "title": {"any": ["ceo", "founder"]},
                   "company_size": {"min": 11, "max": 200}}, "cursor": null}'

Filters you can combine

FilterExampleMeaning
country["US", "FR"]The person's country (ISO codes)
city["Paris"]The person's city
title{"any": ["ceo", "head of"]}Words in the current job title
company["microsoft", 1035]Current company, by slug or numeric id
past_company["google"]Any former company
company_size{"min": 11, "max": 200}Headcount of the current company
company_industry_id[4]Industry of the current company
company_has_websitetrueThe company has a website
industry_id[96]The person's industry
school["stanford-university"]Any school attended
career_years{"min": 5, "max": 15}Years since the first job
tenure_years{"min": 2}Years in the current role

Send at least one filter. All filters are combined with AND; several values inside one filter are alternatives.

Paging through results

Each call returns up to 10 profile slugs and a next_cursor. Send the same filters again with cursor set to that value to get the next page; next_cursor: null means you have reached the last page.

From search to full profiles

Search returns profile slugs, not full profiles. Pass any slug to /v1/enrich/person to get the full profile: current role, company, work history, education and skills. That call costs 1 credit, only when the profile is found.

Good to know

  • The title filter matches the current job title.
  • If a company or school slug is not known yet, the API answers 400 and nothing is charged. Use the numeric LinkedIn id instead.
  • A very broad search can time out. Add or narrow a filter and retry; nothing is charged for a search that fails.
// FAQ

Questions, answered

What does a search cost?

1 credit for each page that has at least one result. A page with no results is free, and so is a search that fails.

Does search return full profiles?

It returns profile slugs. Enrich the ones you need with /v1/enrich/person; you pay 1 credit for each profile that is found.

Does the API return emails or phone numbers?

No. The API returns public profile and company data. It does not return email addresses or phone numbers.

Can I find people who used to work at a company?

Yes, with the past_company filter. The company filter matches the current company.

Start enriching in the next 60 seconds

50 initial credits after email verification, subject to one-grant-per-person checks. No credit card. Pay only for what we find.

Create a free account →
Questions? Ask us 👋