{
"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"],
"keywords": "Representative Director",
"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
Find decision-makers with ICP filters for job title, seniority, function, company name, LinkedIn URL, company ID, location, and industry.
POST
/
api
/
v1
/
people-search
/
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"],
"keywords": "Representative Director",
"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
Free-text query, matched across the whole profile (headline, summary, positions) rather than one attribute. Applied alongside the structured filters, so it narrows them rather than replacing them. Maximum 500 characters.Example:
"Representative Director"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"Company filter options
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"],
"keywords": "Representative Director",
"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
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
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.Was this page helpful?