{
  "company_linkedin_urls": [
    "https://www.linkedin.com/company/salesforce/",
    { "value": "https://www.linkedin.com/company/competitor-co/", "exclude": true }
  ],
  "company_ids": [1441, { "value": 9876, "exclude": true }],
  "seniority": ["CXO", "Vice President"],
  "page": 1
}

{
  "success": true,
  "results": [
    {
      "full_name": "Jane Doe",
      "first_name": "Jane",
      "last_name": "Doe",
      "location": "San Francisco Bay Area",
      "title": "Chief Technology Officer",
      "company": "Stripe",
      "tenure_years": 3,
      "tenure_months": 2,
      "summary": null,
      "profile_url": "https://www.linkedin.com/sales/lead/ACwAAABcDeFgHiJkLmNoPqRsTuVwXyZ01234,NAME_SEARCH",
      "profile_picture": "https://media.licdn.com/dms/image/...",
      "open_link": false
    }
  ],
  "pagination": {
    "page": 1,
    "total": 247,
    "count": 25,
    "start": 0
  },
  "filters_applied": 4,
  "filter_errors": [],
  "credit_used": 10
}

POST

api

people-search

{
  "company_linkedin_urls": [
    "https://www.linkedin.com/company/salesforce/",
    { "value": "https://www.linkedin.com/company/competitor-co/", "exclude": true }
  ],
  "company_ids": [1441, { "value": 9876, "exclude": true }],
  "seniority": ["CXO", "Vice President"],
  "page": 1
}

{
  "success": true,
  "results": [
    {
      "full_name": "Jane Doe",
      "first_name": "Jane",
      "last_name": "Doe",
      "location": "San Francisco Bay Area",
      "title": "Chief Technology Officer",
      "company": "Stripe",
      "tenure_years": 3,
      "tenure_months": 2,
      "summary": null,
      "profile_url": "https://www.linkedin.com/sales/lead/ACwAAABcDeFgHiJkLmNoPqRsTuVwXyZ01234,NAME_SEARCH",
      "profile_picture": "https://media.licdn.com/dms/image/...",
      "open_link": false
    }
  ],
  "pagination": {
    "page": 1,
    "total": 247,
    "count": 25,
    "start": 0
  },
  "filters_applied": 4,
  "filter_errors": [],
  "credit_used": 10
}

ICP People Search

Cost: 10 credits per page. Search for people using Datamagnet’s ICP Search. Pass filter values as plain strings — the API handles all resolution internally.

Use GET /api/v1/people-search/filters to see all valid values for any filter. No credits consumed.

Request body

integer

default:1

Page number. Minimum value is 1.

string | string[]

Job title(s) to filter by.Example: "CTO" or ["CTO", "Chief Technology Officer"]

string | string[]

Company name(s). Resolved via Sales Navigator suggest API.Example: "Stripe" or ["Stripe", "Plaid"]

string | string[] | object[]

LinkedIn company page URL(s). The API scrapes each URL to extract the company’s LinkedIn ID and name — no manual lookup needed. Supports include/exclude.

"company_linkedin_urls": [
  "https://www.linkedin.com/company/salesforce/",
  { "value": "https://www.linkedin.com/company/competitor/", "exclude": true }
]

integer | integer[] | object[]

Raw LinkedIn company numeric ID(s). Builds the filter with the ID directly — no text resolution needed. Must be integers; strings will return a validation error. Supports include/exclude.

"company_ids": [1441, { "value": 9876, "exclude": true }]

string | string[]

City, region, or country.Example: "San Francisco" or ["San Francisco", "New York"]

string | string[]

Seniority level(s). See Filter Reference for all valid values.Example: ["CXO", "Vice President"]

string | string[]

Company size range(s). Valid values: 1-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, 10,001+.Example: ["501-1,000", "1,001-5,000"]

string | string[]

Industry name(s). Over 300 industries supported. See Filter Reference.Example: "Software Development"

string | string[]

Company type(s). Valid values: Public, Private, Non Profit, Educational, Government.Example: "Public"

string | string[]

Department/function. Valid values include: Engineering, Marketing, Sales, Finance, Operations, Product Management, and more.Example: "Engineering"

string | string[]

University or school name(s).Example: "MIT"

string | string[]

Technologies used by the person’s company.Example: "Salesforce"

string | string[]

Years in current role. Valid values: Less than 1 year, 1 to 2 years, 3 to 5 years, 6 to 10 years, More than 10 years.Example: "1 to 2 years"

string | string[]

LinkedIn follower count range. Valid values: 1-50, 51-100, 101-1000, 1001-5000, 5001+.Example: "1001-5000"

string | string[]

Language the profile is written in. Valid values include English, Spanish, French, German, and more.Example: "English"

Three ways to filter by company — use whichever fits your data:

Field	What you provide
`company_name`	Company name as a string
`company_linkedin_urls`	LinkedIn company page URL(s)
`company_ids`	LinkedIn numeric company ID(s)

All three fields can be combined in the same request.

Include / exclude

Every filter supports negative matching. Wrap a value in an object with "exclude": true to exclude it:

{
  "company_linkedin_urls": [
    "https://www.linkedin.com/company/salesforce/",
    { "value": "https://www.linkedin.com/company/competitor-co/", "exclude": true }
  ],
  "company_ids": [
    1441,
    { "value": 9876, "exclude": true }
  ],
  "seniority": "CXO"
}

Response

{
  "company_linkedin_urls": [
    "https://www.linkedin.com/company/salesforce/",
    { "value": "https://www.linkedin.com/company/competitor-co/", "exclude": true }
  ],
  "company_ids": [1441, { "value": 9876, "exclude": true }],
  "seniority": ["CXO", "Vice President"],
  "page": 1
}

{
  "success": true,
  "results": [
    {
      "full_name": "Jane Doe",
      "first_name": "Jane",
      "last_name": "Doe",
      "location": "San Francisco Bay Area",
      "title": "Chief Technology Officer",
      "company": "Stripe",
      "tenure_years": 3,
      "tenure_months": 2,
      "summary": null,
      "profile_url": "https://www.linkedin.com/sales/lead/ACwAAABcDeFgHiJkLmNoPqRsTuVwXyZ01234,NAME_SEARCH",
      "profile_picture": "https://media.licdn.com/dms/image/...",
      "open_link": false
    }
  ],
  "pagination": {
    "page": 1,
    "total": 247,
    "count": 25,
    "start": 0
  },
  "filters_applied": 4,
  "filter_errors": [],
  "credit_used": 10
}

Response fields

boolean

true on success.

array

List of matching people profiles.

Show Profile object

string

Full name.

string

First name.

string

Last name.

string

Geographic region.

string

Current job title.

string

Current company name.

integer

Years in current role (nullable).

integer

Months in current role (nullable).

string

Profile summary (nullable).

string

Sales Navigator lead URL. The person is identified by URN rather than a vanity slug, so this URL does not resolve anonymously — fetching it unauthenticated returns HTTP 999 from LinkedIn. Treat it as a stable identifier for the lead, not as a page to fetch.

string

Profile picture URL (nullable).

boolean

Whether the profile is an OpenLink profile.

object

Show Pagination object

integer

Current page number.

integer

Total results across all pages.

integer

Results on this page.

integer

Offset of the first result.

integer

Number of filters applied to this search.

array

Any filter values that could not be resolved. The search proceeds with the remaining valid filters.

integer

Credits actually charged for this request. A request that returns no results, or that fails before reaching the search, is charged 0.

People

Company

Jobs

Posts

Signals

ICP Search

Utilities

ICP People Search

ICP People Search

Request body

Include / exclude

Response

Response fields

​ICP People Search

​Request body

​Company filter options

​Include / exclude

​Response

​Response fields

ICP People Search

Request body

Company filter options

Include / exclude

Response

Response fields