Skip to main content
POST
LinkedIn Profile Search + Email

Authorizations

Authorization
string
header
default:YOUR_ANYAPI_KEY
required

Your AnyAPI key as a Bearer token.

Headers

Idempotency-Key
string

Optional wallet idempotency key, scoped to this customer for 24 hours. When the gateway honors the key, this synchronous in-process execution can continue after the caller disconnects, bounded by its execution deadline. A completed replayable result charges normally exactly once and can be replayed without another provider run or charge. A pending duplicate returns 409 idempotency_in_progress; reuse with different request semantics returns 409 idempotency_conflict.

Required string length: 1 - 255

Query Parameters

fields
string

Optional. Comma-separated keys (dotted paths like author.name descend into nested objects) to keep on each result item. Keys are matched relative to each result item after the data/items envelope is unwrapped, not against the top-level response envelope, so use jq to reshape the whole envelope. Shrinks the response without changing cost.

max_items
integer

Optional. Cap the number of result rows returned; a _truncated note reports how many were withheld so you can page via the API's own limit. Does not change cost.

Required range: x >= 0
summary
boolean

Optional. Return only a structural outline (top-level keys, item counts, and per-field byte sizes) instead of the full data. Does not change cost.

jq
string

Optional. A jq expression applied to the result envelope; its output replaces output (multiple outputs collect into an array). Reshape freely, e.g. jq=.data | {title, description, md: .markdown[:3500]}. Runs sandboxed with a 250ms / 2MB budget; on failure the full result is returned with a jqError. Does not change cost.

Body

application/json
query
string
required

Search query for LinkedIn profiles: a role, name, or keywords (e.g. 'Marketing Manager').

companyHeadcount
enum<string>[]

Filter by current company size (employee count). Codes: A=Self-Employed, B=1-10, C=11-50, D=51-200, E=201-500, F=501-1,000, G=1,001-5,000, H=5,001-10,000, I=10,001+.

Available options:
A,
B,
C,
D,
E,
F,
G,
H,
I
companyHeadquarterLocations
string[]

Filter by the location of the person's current company headquarters, by place name (e.g. ['United States']).

currentCompanies
string[]

Filter to people who currently work at any of these companies, by name (e.g. ['Google','Meta']). Multiple names widen the match (OR).

excludeCompanyHeadquarterLocations
string[]

Exclude people whose current company is headquartered in any of these locations.

excludeCurrentCompanies
string[]

Exclude people who currently work at any of these companies, by name.

excludeCurrentJobTitles
string[]

Exclude people whose current job title matches any of these.

excludeFunctionIds
enum<string>[]

Exclude these job functions (same codes as functionIds).

Available options:
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26
excludeLocations
string[]

Exclude people in any of these locations, by place name.

excludePastCompanies
string[]

Exclude people who previously worked at any of these companies, by name.

excludePastJobTitles
string[]

Exclude people who held any of these past job titles.

excludeSchools
string[]

Exclude people who attended any of these schools, by name.

excludeSeniorityLevelIds
enum<string>[]

Exclude these seniority levels (same codes as seniorityLevelIds).

Available options:
100,
110,
120,
130,
200,
210,
220,
300,
310,
320
firstNames
string[]

Filter to people whose first name matches any of these.

functionIds
enum<string>[]

Filter by job function. Codes: 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, 11=Healthcare Services, 12=Human Resources, 13=Information Technology, 14=Legal, 15=Marketing, 16=Media and Communication, 17=Military and Protective Services, 18=Operations, 19=Product Management, 20=Program and Project Management, 21=Purchasing, 22=Quality Assurance, 23=Real Estate, 24=Research, 25=Sales, 26=Customer Success and Support.

Available options:
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26
jobTitle
string

Optional current job title filter (e.g. 'Software Engineer').

lastNames
string[]

Filter to people whose last name matches any of these.

limit
integer

Maximum number of full profiles (with email) to return (1-25, default 10). You are billed per profile returned, so a lower limit costs less.

Required range: 1 <= x <= 25
location
string

Optional location filter (e.g. 'San Francisco').

pastCompanies
string[]

Filter to people who previously worked at any of these companies, by name.

pastJobTitles
string[]

Filter by a past job title the person held (e.g. ['Product Manager']).

profileLanguages
enum<string>[]

Filter by the profile's primary language.

Available options:
Arabic,
English,
Spanish,
Portuguese,
Chinese,
French,
Italian,
Russian,
German,
Dutch,
Turkish,
Tagalog,
Polish,
Korean,
Japanese,
Malay,
Norwegian,
Danish,
Romanian,
Swedish,
Bahasa Indonesia,
Czech
recentlyChangedJobs
boolean

When true, only return people who recently changed jobs (a strong sales/recruiting signal).

recentlyPostedOnLinkedIn
boolean

When true, only return people who recently posted on LinkedIn (an activity signal).

schools
string[]

Filter to people who attended any of these schools, by name.

seniorityLevelIds
enum<string>[]

Filter by seniority level. Codes: 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.

Available options:
100,
110,
120,
130,
200,
210,
220,
300,
310,
320
yearsAtCurrentCompanyIds
enum<string>[]

Filter by tenure at the current company. Codes: 1=Less than 1 year, 2=1 to 2 years, 3=3 to 5 years, 4=6 to 10 years, 5=More than 10 years.

Available options:
1,
2,
3,
4,
5
yearsOfExperienceIds
enum<string>[]

Filter by total years of experience. Codes: 1=Less than 1 year, 2=1 to 2 years, 3=3 to 5 years, 4=6 to 10 years, 5=More than 10 years.

Available options:
1,
2,
3,
4,
5

Response

Normalized result.

costUsd
number
required

USD charged on the original run. On a replay this value is echoed for parity; the replay itself is free.

output
LinkedIn profile search + email output · object | null
required

Normalized output, or null when the replay payload was not retained.

provider
string
required

Always "AnyAPI".

replayed
boolean
required

True when this response replays the durable result of an earlier run without billing or upstream execution.

items
integer

Number of result rows returned. For per-result SKUs the per-item cost is charged against this count; for input-priced SKUs the charge is per submitted input, independent of this count.

jqError
string

Present only when a jq expression failed; output then carries the full unshaped result and this explains why the reshape did not apply.

resultId
string

Opaque handle to the full unshaped result, cached ~15 min. Re-shape it for free (fields/max_items/summary/jq) via GET /v1/results/{id}, no re-billing. Absent when the result was too large to cache.