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 underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
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.
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.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.
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).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.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.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).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).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+).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.
By Search: filter to profiles who previously worked at these companies. One per line. Up to 50 per run.Up to 50 items.
By Search: filter by current job title text (e.g. ‘product manager’). One per line. Up to 50 per run.Up to 50 items.
By Search: filter to alumni of these schools (e.g. Stanford, MIT). One per line. Up to 50 per run.Up to 50 items.
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.
By Search: filter to profiles whose company is headquartered in these locations. One per line. Up to 70 per run.Up to 70 items.
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.Example
Response fields
Each row indata is one profile, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
To find people by keyword, title, company or location uselinkedin/profiles/search; to list everyone at one company use linkedin/company-employees; for a work email use linkedin/emails.