{
"keyword": "software engineer",
"cities": ["San Francisco"],
"company_linkedin_urls": ["https://www.linkedin.com/company/stripe/"],
"exclude_company_linkedin_urls": ["https://www.linkedin.com/company/competitor-co/"],
"job_titles": ["Backend Engineer"],
"open_to_work": true,
"limit": 50,
"offset": 0
}
{
"message": [
{
"id": 10432,
"entity_urn": "ACoAAC8Np1kB17Ro_b3eo8YZWUZFudbt9lrg1Tw",
"username": "jane-doe-1234",
"full_name": "Jane Doe",
"display_name": "Jane Doe",
"profile_headline": "Backend Engineer at Stripe",
"description": "Building payments infrastructure.",
"profile_link": "https://linkedin.com/in/jane-doe-1234",
"location": "San Francisco, California, United States",
"location_city": "San Francisco",
"location_state": "California",
"country": "United States",
"followers": 1240,
"connections": 500,
"is_premium": true,
"is_creator": false,
"is_influencer": false,
"is_job_seeker": false,
"is_openlink": false,
"is_retired": false,
"open_to_work": true,
"avatar_url": "https://media.licdn.com/dms/image/...",
"profile_picture": "https://media.licdn.com/dms/image/...",
"email": null,
"linkedin_url": "https://linkedin.com/in/jane-doe-1234",
"current_job_title": "Backend Engineer",
"current_company": "Stripe",
"current_job_location": "San Francisco, CA",
"current_employment_type": "Full-time"
}
],
"credit_used": 10,
"total": 1
}
People Search DB
Search Datamagnet’s own database of previously enriched LinkedIn profiles by keyword, location, company, job title, and more — with include/exclude support for company LinkedIn URLs.
POST
/
api
/
v1
/
people
/
search
/
db
{
"keyword": "software engineer",
"cities": ["San Francisco"],
"company_linkedin_urls": ["https://www.linkedin.com/company/stripe/"],
"exclude_company_linkedin_urls": ["https://www.linkedin.com/company/competitor-co/"],
"job_titles": ["Backend Engineer"],
"open_to_work": true,
"limit": 50,
"offset": 0
}
{
"message": [
{
"id": 10432,
"entity_urn": "ACoAAC8Np1kB17Ro_b3eo8YZWUZFudbt9lrg1Tw",
"username": "jane-doe-1234",
"full_name": "Jane Doe",
"display_name": "Jane Doe",
"profile_headline": "Backend Engineer at Stripe",
"description": "Building payments infrastructure.",
"profile_link": "https://linkedin.com/in/jane-doe-1234",
"location": "San Francisco, California, United States",
"location_city": "San Francisco",
"location_state": "California",
"country": "United States",
"followers": 1240,
"connections": 500,
"is_premium": true,
"is_creator": false,
"is_influencer": false,
"is_job_seeker": false,
"is_openlink": false,
"is_retired": false,
"open_to_work": true,
"avatar_url": "https://media.licdn.com/dms/image/...",
"profile_picture": "https://media.licdn.com/dms/image/...",
"email": null,
"linkedin_url": "https://linkedin.com/in/jane-doe-1234",
"current_job_title": "Backend Engineer",
"current_company": "Stripe",
"current_job_location": "San Francisco, CA",
"current_employment_type": "Full-time"
}
],
"credit_used": 10,
"total": 1
}
People Search DB
Cost:10 credits/search.
Search Datamagnet’s internal database of already-enriched LinkedIn profiles. Unlike People Search, which queries LinkedIn live, this endpoint searches previously collected profile records — so it returns instantly and doesn’t consume LinkedIn scraping capacity. Each page returns up to 50 results.
People search DB endpoint
Most filter fields accept multiple values. Values within the same field are OR’d together (e.g.["San Francisco", "New York"] matches either city); different fields are AND’d together. open_to_work is the exception and takes a single boolean.
Optional attributes
string
General keyword search across name and headline. Example:
software engineerstring[]
Filter by country. Partial match. Example:
["United States", "Canada"]string[]
Filter by full location string. Partial match. Example:
["Greater New York City Area"]string[]
Filter by city. Partial match. Example:
["San Francisco", "Austin"]string[]
Filter by state/region. Partial match. Example:
["California"]string[]
Filter by current company name. Partial match. Example:
["Stripe", "Plaid"]string[]
Filter by current company using its LinkedIn URL. Accepts a full URL, universal name, or numeric LinkedIn company ID.Example:
["https://www.linkedin.com/company/stripe/"]string[]
Exclude profiles whose current company matches any of these LinkedIn URLs. Accepts the same formats as
company_linkedin_urls (full URL, universal name, or numeric ID). Useful for filtering out a competitor or your own company from results.Example: ["https://www.linkedin.com/company/competitor-co/"]string[]
Filter by job title. Partial match. Example:
["CTO", "VP of Engineering"]boolean
Filter by the LinkedIn open-to-work badge.This filter is tri-state rather than a plain on/off switch.
true returns profiles where the badge was seen. false returns profiles that were checked by a provider that reads the badge and did not have it. Profiles nobody has checked yet hold no badge information at all and are excluded from both sides, so false is not the complement of true, and leaving the field out is not the same as sending false.Example: trueinteger
default:50
Maximum number of results to return per page. Maximum value is
50.integer
default:0
Number of results to skip, for pagination.
Response
{
"keyword": "software engineer",
"cities": ["San Francisco"],
"company_linkedin_urls": ["https://www.linkedin.com/company/stripe/"],
"exclude_company_linkedin_urls": ["https://www.linkedin.com/company/competitor-co/"],
"job_titles": ["Backend Engineer"],
"open_to_work": true,
"limit": 50,
"offset": 0
}
{
"message": [
{
"id": 10432,
"entity_urn": "ACoAAC8Np1kB17Ro_b3eo8YZWUZFudbt9lrg1Tw",
"username": "jane-doe-1234",
"full_name": "Jane Doe",
"display_name": "Jane Doe",
"profile_headline": "Backend Engineer at Stripe",
"description": "Building payments infrastructure.",
"profile_link": "https://linkedin.com/in/jane-doe-1234",
"location": "San Francisco, California, United States",
"location_city": "San Francisco",
"location_state": "California",
"country": "United States",
"followers": 1240,
"connections": 500,
"is_premium": true,
"is_creator": false,
"is_influencer": false,
"is_job_seeker": false,
"is_openlink": false,
"is_retired": false,
"open_to_work": true,
"avatar_url": "https://media.licdn.com/dms/image/...",
"profile_picture": "https://media.licdn.com/dms/image/...",
"email": null,
"linkedin_url": "https://linkedin.com/in/jane-doe-1234",
"current_job_title": "Backend Engineer",
"current_company": "Stripe",
"current_job_location": "San Francisco, CA",
"current_employment_type": "Full-time"
}
],
"credit_used": 10,
"total": 1
}
The response model
Properties
array
List of matching profiles.
Show Profile object
Show Profile object
integer
Internal Datamagnet profile ID.
string
LinkedIn entity URN.
string
LinkedIn username/vanity URL.
string
Full name of the person.
string
Display name as shown on LinkedIn.
string
LinkedIn profile headline.
string
Profile description/about section.
string
LinkedIn profile URL.
string
Full location string.
string
City of the profile’s location.
string
State/region of the profile’s location.
string
Country of the profile’s location.
integer
Number of LinkedIn followers.
integer
Number of LinkedIn connections.
boolean
Whether the person has LinkedIn Premium.
boolean
Whether the person is a LinkedIn creator.
boolean
Whether the person is a LinkedIn influencer.
boolean
Whether the person is marked as a job seeker.
boolean
Whether the person uses OpenLink.
boolean
Whether the person is marked as retired.
boolean
Whether the person carries the LinkedIn open-to-work badge.
string
Profile picture URL.
string
Profile picture URL (alternate source).
string
Email address, when available. May be
null.string
Computed LinkedIn profile URL, built from
username.string
Job title of the profile’s current position, when available.
string
Name of the profile’s current company, when available.
string
Location of the profile’s current position, when available.
string
Employment type of the current position (e.g.
Full-time), when available.integer
Number of credits used for this request. Example:
10integer
Number of results returned in this response.
Was this page helpful?