Skip to main content
POST /v1/data/linkedin/profiles/run Pricing: $0.004 per profile ($4.00 per 1,000). Search mode adds $0.05 per search page of up to 25, and a search that finds nothing still bills its one page.

Ways to call it

  • URL: set queries
  • Search (optional: searchQuery, locations, seniorityLevel, function, industry, yearsOfExperience, yearsAtCompany, companyHeadcount, …)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
LinkedIn profile URLs to fetch full details for (By URL mode). One per line.
string
By Search mode: keyword full-text search only, a single domain/role keyword (e.g. ‘fintech’, ‘founder’, ‘product manager’). Do NOT include years, school names, company names, or job titles here. Use the structured filters for those.
integer
By Search mode: how many matching profiles to enrich, as a multiple of 25 (each search page holds up to 25 profiles). Billed as $0.05 per search page pulled (a search that finds nobody still bills its one page) PLUS $0.004 per enriched profile. Leave blank for ALL available matches (up to 2500 / 100 pages).Max 2500.
string[]
By Search: filter to profiles in these locations (e.g. ‘San Francisco’, ‘London’). One per line. Up to 70 per run.Up to 70 items.
string[]
By Search: filter to profiles at this seniority level.Allowed values: 100 (In Training), 110 (Entry Level), 120 (Senior), 130 (Strategic), 200 (Entry Level Manager), 210 (Experienced Manager), 220 (Director), 300 (Vice President), 310 (CXO), 320 (Owner / Partner).
string[]
By Search: filter to profiles in this job function.26 allowed values, for example 1 (Accounting), 2 (Administrative), 3 (Arts and Design), 4 (Business Development), 5 (Community and Social Services), 6 (Consulting), 7 (Education), 8 (Engineering), 9 (Entrepreneurship), 10 (Finance). Fetch the full list with GET /v1/data/linkedin/profiles?expand=options.
string[]
By Search: filter to profiles in this industry. Up to 50 per run.Up to 50 items.434 allowed values, for example 2190 (Accommodation Services), 34 (Accommodation Services > Food and Beverage Services), 2217 (Accommodation Services > Food and Beverage Services > Bars, Taverns, and Nightclubs), 2212 (Accommodation Services > Food and Beverage Services > Caterers), 2214 (Accommodation Services > Food and Beverage Services > Mobile Food Services), 32 (Accommodation Services > Food and Beverage Services > Restaurants), 31 (Accommodation Services > Hospitality), 2197 (Accommodation Services > Hospitality > Bed-and-Breakfasts, Hostels, Homestays), 2194 (Accommodation Services > Hospitality > Hotels and Motels), 1912 (Administrative and Support Services). Fetch the full list with GET /v1/data/linkedin/profiles?expand=options.
string[]
By Search: filter by total career experience. Also the proxy for graduation year: ‘1’ = <1y (just graduated), ‘2’ = 1-2y, ‘3’ = 3-5y, ‘4’ = 6-10y, ‘5’ = >10y.Allowed values: 1 (Less than 1 year), 2 (1-2 years), 3 (3-5 years), 4 (6-10 years), 5 (More than 10 years).
string[]
By Search: filter to profiles with this tenure at their current company.Allowed values: 1 (Less than 1 year), 2 (1-2 years), 3 (3-5 years), 4 (6-10 years), 5 (More than 10 years).
string[]
By Search: filter to profiles working at companies of this size.Allowed values: A (Self-Employed (1)), B (1-10), C (11-50), D (51-200), E (201-500), F (501-1000), G (1001-5000), H (5001-10000), I (10001+).
string[]
By Search: filter to profiles currently at these companies (e.g. Google, Stripe). One per line. Up to 50 per run.Up to 50 items.
string[]
By Search: filter to profiles who previously worked at these companies. One per line. Up to 50 per run.Up to 50 items.
string[]
By Search: filter by current job title text (e.g. ‘product manager’). One per line. Up to 50 per run.Up to 50 items.
string[]
By Search: filter by past job title text. One per line. Up to 50 per run.Up to 50 items.
string[]
By Search: filter to alumni of these schools (e.g. Stanford, MIT). One per line. Up to 50 per run.Up to 50 items.
string[]
By Search: filter to profiles by name. One per line, full name (“Sam Altman”) or first/last only (“Sam”). Up to 50 per run.Up to 50 items.
string[]
By Search: filter to profiles whose company is headquartered in these locations. One per line. Up to 70 per run.Up to 70 items.
string[]
By Search: filter to profiles written in these LinkedIn profile languages.Allowed values: Arabic, English, Spanish, Portuguese, Chinese, French, Italian, Russian, German, Dutch, Turkish, Tagalog, Polish, Korean, Japanese, Malay, Norwegian, Danish, Romanian, Swedish, Bahasa Indonesia, Czech.
boolean
By Search: only profiles who recently changed jobs.
boolean
By Search: only profiles who posted on LinkedIn recently.

Example

Response fields

Each row in data is one profile, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
To find people by keyword, title, company or location use linkedin/profiles/search; to list everyone at one company use linkedin/company-employees; for a work email use linkedin/emails.