API Reference/Endpoints

Retrieve search parameters

GET/api/linkedin/gateway/linkedin/search/parameters

LinkedIn's own search filters mostly don't take free text — a location, school or company filter has to reference LinkedIn's internal id for that entity. This resolves a human search term (like a city or company name) into the ids that Search people & companies actually expects for that filter.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Query parameters

FieldTypeDescription

account_id *stringA connected account's id.

type *stringWhich kind of filter to resolve, e.g. LOCATION, COMPANY, SCHOOL, INDUSTRY, SKILL, JOB_TITLE. Sales Navigator and Recruiter add more of their own, like PERSONA, LEAD_LISTS or HIRING_PROJECTS.

service"CLASSIC" | "RECRUITER" | "SALES_NAVIGATOR"Which search surface this is for. Defaults to CLASSIC.

keywordsstringThe term to resolve, e.g. a city or company name.

limitnumber1–100. Defaults to 10.

Response fields

FieldTypeDescription

object"LinkedinSearchParametersList"Always this value.

items[].idstringThe internal id to pass into the matching search filter.

items[].titlestringThe human-readable label for that id.

items[].picture_urlstringPresent for entities that have one, like companies and schools.

type and service together decide which set of ids come back — resolve against the same service you intend to search with.

Errors

·400 Bad Request. account_id or type is missing.·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key, or the account has no contract for that service.