API Reference/LinkedIn Specific/Perform LinkedIn search

Perform LinkedIn search

POSThttps://api.postpress.ai/v1/linkedin/search

Search people, companies, posts and jobs across LinkedIn Classic, Sales Navigator and Recruiter APIs.

LinkedIn does not accept raw text - it requires stable IDs. Resolve any human-readable filter values (locations, companies, industries, skills, ...) using GET /linkedin/search/parametersfirst, then pass the returned ids into this endpoint.

Authorization

X-API-KEYstringrequired
API key from your postpress dashboard. Sent as a request header.

Query parameters

account_idstringrequired
The linked LinkedIn account to perform the request from.
limitintegeroptional
Number of items returned. Up to 100 for Sales Navigator / Recruiter; should not exceed 50 for Classic. Defaults to 10.
cursorstringoptional
Pagination cursor returned by a previous call. For very long cursors, send it in the body instead.

Request body

The body is a discriminated union. Pick one variant - either by setting the api + category pair (Classic / Sales Navigator / Recruiter) or by using url (search-from-URL) or cursor only (pagination).

Classic - Peopleapi: classic, category: peopleoptional
LinkedIn Classic people search.
Classic - Companiesapi: classic, category: companiesoptional
LinkedIn Classic company search.
Classic - Postsapi: classic, category: postsoptional
LinkedIn Classic post search.
Classic - Jobsapi: classic, category: jobsoptional
LinkedIn Classic job-listing search.
Sales Navigator - Peopleapi: sales_navigator, category: peopleoptional
Sales Navigator lead search with extensive include/exclude filters.
Sales Navigator - Companiesapi: sales_navigator, category: companiesoptional
Sales Navigator account search.
Recruiter - Peopleapi: recruiter, category: peopleoptional
Recruiter talent search with priority/scope per filter.
Search from URL-optional
Pass a public LinkedIn search URL in `url`. Overrides all other body fields.
Cursor-optional
Pagination-only body for very long cursors. Pass `cursor` only.

Body - Classic - People

apistringclassicrequired
categorystringpeoplerequired
keywordsstring
Free-text keywords.
industryarray of strings
Industry IDs. Resolve via `type=INDUSTRY` on the parameters route.
locationarray of strings
Location IDs. Resolve via `type=LOCATION`.
profile_languagearray of strings
ISO 639-1 codes (2 letters).
network_distancearray of numbers
Connection degree: 1, 2, or 3.
companyarray of strings
Current company IDs. Resolve via `type=COMPANY`.
past_companyarray of strings
Past company IDs.
schoolarray of strings
School IDs. Resolve via `type=SCHOOL`.
servicearray of strings
Service category IDs. Resolve via `type=SERVICE`.
connections_ofarray of strings
Member IDs whose 1st-degree connections to search through.
followers_ofarray of strings
Member IDs whose followers to search through.
open_toarray of strings
proBonoboardMember
advanced_keywordsobject
Field-scoped keyword filters.
advanced_keywords object
first_namestring
last_namestring
titlestring
companystring
schoolstring

Body - Classic - Companies

apistringclassicrequired
categorystringcompaniesrequired
keywordsstring
industryarray of strings
locationarray of strings
has_job_offersboolean
headcountarray of objects
Company-size buckets. `min`/`max` use LinkedIn-fixed values (e.g. 1, 11, 51, 201, 501, 1001, 5001, 10001 / 10, 50, 200, 500, 1000, 5000, 10000).
headcount object
minnumber
maxnumber
network_distancearray of numbers
1, 2, or 3.

Body - Classic - Posts

apistringclassicrequired
categorystringpostsrequired
keywordsstring
sort_bystring
relevancedate
Default `relevance`.
date_postedstring
past_daypast_weekpast_month
content_typestring
videosimageslive_videoscollaborative_articlesdocuments
posted_byobject
At least one sub-field required.
posted_by object
memberarray of strings
companyarray of strings
meboolean
first_connectionsboolean
people_you_followboolean
mentioningobject
mentioning object
memberarray of strings
companyarray of strings
authorobject
author object
industryarray of strings
companyarray of strings
keywordsstring

Body - Classic - Jobs

apistringclassicrequired
categorystringjobsrequired
keywordsstring
sort_bystring
relevancedate
date_postednumber
Timespan in days since today.
regionstring
Single location ID for `GLOBAL LOCATION`.
locationarray of strings
Location IDs.
location_within_areanumber
Radius around the location in miles.
industryarray of strings
seniorityarray of strings
executivedirectormid_seniorassociateentryintern
functionarray of strings
Job function IDs (lowercase letters). Resolve via `type=JOB_FUNCTION`.
rolearray of strings
Title IDs. Resolve via `type=JOB_TITLE`.
job_typearray of strings
full_timepart_timecontracttemporaryvolunteerinternshipother
companyarray of strings
presencearray of strings
on_sitehybridremote
easy_applyboolean
has_verificationsboolean
under_10_applicantsboolean
in_your_networkboolean
fair_chance_employerboolean
benefitsarray of strings
medical_insurancevision_insurancedental_insurancedisability_insurance401(k)pension_planpaid_maternity_leavepaid_paternity_leavecommuter_benefitsstudent_loan_assistancetuition_assistance
commitmentsarray of strings
career_growth_and_learningdiversity_equity_and_inclusionenvironmental_sustainabilitysocial_impactwork_life_balance
minimum_salaryobject
Two shapes: dollar-based (USD/AUD/CAD with value in [40, 60, 80, 100, 120, 140, 160, 180, 200]) or pound-based (GBP with value in [20, 30, 40, 50, 60, 70, 80, 90, 100]).
minimum_salary object
currencystringrequired
USDAUDCADGBP
valuenumberrequired

Body - Sales Navigator - People

Sales Navigator filters typically use { include, exclude } objects of resolved IDs.

apistringsales_navigatorrequired
categorystringpeoplerequired
keywordsstring
first_namestring
last_namestring
last_viewed_atnumber
Unix timestamp - filter saved-search results newer than this.
saved_search_idstring
Overrides all other filters. Resolve via `type=SAVED_SEARCHES`.
recent_search_idstring
Overrides all other filters. Resolve via `type=RECENT_SEARCHES`.
locationobject
Geography (REGION IDs).
location object
includearray of strings
excludearray of strings
location_by_postal_codeobject
location_by_postal_code object
includearray of strings
POSTAL_CODE IDs.
excludearray of strings
within_areanumber
Radius in miles.
industryobject
SALES_INDUSTRY IDs.
industry object
includearray of strings
excludearray of strings
schoolobject
SCHOOL IDs.
school object
includearray of strings
excludearray of strings
companyobject
Current company (IDs or plain names).
company object
includearray of strings
excludearray of strings
past_companyobject
Past companies.
past_company object
includearray of strings
excludearray of strings
company_locationobject
Company HQ region.
company_location object
includearray of strings
excludearray of strings
functionobject
DEPARTMENT IDs.
function object
includearray of strings
excludearray of strings
roleobject
Current job titles (IDs or plain text).
role object
includearray of strings
excludearray of strings
past_roleobject
Past job-title IDs.
past_role object
includearray of strings
excludearray of strings
seniorityobject
Allowed values: `owner/partner`, `cxo`, `vice_president`, `director`, `experienced_manager`, `entry_level_manager`, `strategic`, `senior`, `entry_level`, `in_training`.
seniority object
includearray of strings
excludearray of strings
account_listsobject
ACCOUNT_LISTS IDs or `ALL`.
account_lists object
includearray of strings
excludearray of strings
lead_listsobject
LEAD_LISTS IDs or `ALL`.
lead_lists object
includearray of strings
excludearray of strings
tenurearray of objects
Years of experience. min in [0,1,3,6,10]; max in [1,2,5,10].
tenure object
minnumber
maxnumber
tenure_at_companyarray of objects
Years in current company. Same buckets as `tenure`.
tenure_at_company object
minnumber
maxnumber
tenure_at_rolearray of objects
Years in current position.
tenure_at_role object
minnumber
maxnumber
company_headcountarray of objects
Buckets for current-company headcount.
company_headcount object
minnumber
maxnumber
profile_languagearray of strings
ISO 639-1 codes.
company_typearray of strings
public_companyprivately_heldnon_profiteducational_institutionpartnershipself_employedself_ownedgovernment_agency
groupsarray of strings
GROUPS IDs.
network_distancearray
Numeric 1/2/3 or string `GROUP`.
connections_ofarray of strings
Member IDs whose connections to search through.
personaarray of strings
PERSONA IDs.
following_your_companyboolean
viewed_your_profile_recentlyboolean
past_colleagueboolean
shared_experiencesboolean
changed_jobsboolean
posted_on_linkedinboolean
mentionned_in_newsboolean
viewed_profile_recentlyboolean
People you interacted with / viewed profile.
messaged_recentlyboolean
People you interacted with / messaged.
include_saved_leadsboolean
include_saved_accountsboolean
save_searchobject
Persist this search.
save_search object
namestringrequired

Body - Sales Navigator - Companies

apistringsales_navigatorrequired
categorystringcompaniesrequired
keywordsstring
last_viewed_atnumber
saved_search_idstring
recent_search_idstring
industryobject
SALES_INDUSTRY include/exclude.
industry object
includearray of strings
excludearray of strings
locationobject
Headquarters location include/exclude.
location object
includearray of strings
excludearray of strings
location_by_postal_codeobject
location_by_postal_code object
includearray of strings
excludearray of strings
within_areanumber
has_job_offersboolean
headcountarray of objects
headcount object
minnumber
maxnumber
headcount_growthobject
headcount_growth object
minnumber
maxnumber
department_headcountobject
department_headcount object
departmentarray of stringsrequired
DEPARTMENT IDs.
minnumber
maxnumber
department_headcount_growthobject
department_headcount_growth object
departmentarray of stringsrequired
minnumber
maxnumber
network_distancearray of numbers
1, 2, or 3.
annual_revenueobject
Use `max=1001` for the `1000+` bucket. min/max in [0, 0.2, 1, 2.5, 5, 10, 20, 50, 100, 500, 1000, 1001].
annual_revenue object
currencystringrequired
ISO 4217 (3 letters).
minnumberrequired
maxnumberrequired
followers_countarray of objects
min in [1,51,101,1001,5001]; max in [50,100,1000,5000].
followers_count object
minnumber
maxnumber
fortunearray of objects
min in [0,51,101,251]; max in [50,100,250,500].
fortune object
minnumber
maxnumber
technologiesarray of strings
TECHNOLOGIES IDs.
recent_activitiesarray of strings
senior_leadership_changesfunding_events
saved_accountsarray of strings
SAVED_ACCOUNTS IDs.
account_listsobject
ACCOUNT_LISTS include/exclude.
account_lists object
includearray of strings
excludearray of strings
save_searchobject
save_search object
namestringrequired

Body - Recruiter - People

Recruiter filters expose priority (CAN_HAVE / MUST_HAVE /DOESNT_HAVE) and, where relevant, scope (e.g. CURRENT / PAST / OPEN_TO_WORK).

apistringrecruiterrequired
categorystringpeoplerequired
keywordsstring
Boolean modifiers supported, e.g. `developers AND product owners NOT managers`.
localestring
Application locale, defaults to `english`. Supports the 36 LinkedIn-supported locales (arabic, bangla, czech, danish, german, greek, english, spanish, persian, finnish, french, hindi, hungarian, indonesian, italian, hebrew, japanese, korean, marathi, malay, dutch, norwegian, punjabi, polish, portuguese, romanian, russian, swedish, telugu, thai, tagalog, turkish, ukrainian, vietnamese, chinese_simplified, chinese_traditional).
saved_searchobject
Overrides all other filters.
saved_search object
idstringrequired
project_idstringrequired
newest_results_onlyboolean
saved_filterstring
SAVED_FILTERS id.
locationarray of objects
location object
idstringrequired
LOCATION id.
prioritystring
CAN_HAVEMUST_HAVEDOESNT_HAVE
scopestring
CURRENTOPEN_TO_RELOCATE_ONLYCURRENT_OR_OPEN_TO_RELOCATE
titlestring
Only needed when `scope=CURRENT_OR_OPEN_TO_RELOCATE`.
location_within_areanumber
industryobject
INDUSTRY include/exclude.
industry object
includearray of strings
excludearray of strings
rolearray of objects
Job titles. Each entry is either ID-based (`id` + `is_selection`) or keywords-based (`keywords`). Both accept `priority` and `scope`.
role object
idstring
JOB_TITLE id.
is_selectionboolean
Required with `id`. Whether the title is used as a strict filter or as a selection.
keywordsstring
prioritystring
CAN_HAVEMUST_HAVEDOESNT_HAVE
scopestring
CURRENT_OR_PASTCURRENTPASTPAST_NOT_CURRENTOPEN_TO_WORK
skillsarray of objects
Either `{ id, priority }` (SKILL id) or `{ keywords, priority }`.
skills object
idstring
keywordsstring
prioritystring
CAN_HAVEMUST_HAVEDOESNT_HAVE
companyarray of objects
Either ID-based (`id` + optional `name`) or keywords-based. Both accept `priority` and `scope` (CURRENT_OR_PAST/CURRENT/PAST/PAST_NOT_CURRENT).
company object
idstring
namestring
keywordsstring
prioritystring
CAN_HAVEMUST_HAVEDOESNT_HAVE
scopestring
CURRENT_OR_PASTCURRENTPASTPAST_NOT_CURRENT
current_companyarray of objects
current_company object
idstringrequired
prioritystring
CAN_HAVEMUST_HAVEDOESNT_HAVE
past_companyarray of objects
past_company object
idstringrequired
prioritystring
CAN_HAVEMUST_HAVEDOESNT_HAVE
schoolarray of objects
school object
idstringrequired
prioritystring
CAN_HAVEMUST_HAVEDOESNT_HAVE
degreeobject
DEGREE include/exclude.
degree object
includearray of strings
excludearray of strings
employment_typearray of strings
FULL_TIMEPART_TIMECONTRACTINTERNSHIP
Recruiter PRO only.
groupsarray of strings
graduation_yearobject
graduation_year object
minnumber
1000-9999.
maxnumber
company_headcountarray of objects
company_headcount object
minnumber
maxnumber
tenureobject
tenure object
minnumber
maxnumber
tenure_in_companyobject
tenure_in_company object
minnumber
maxnumber
tenure_in_positionobject
tenure_in_position object
minnumber
maxnumber
seniorityobject
Allowed: `owner`, `partner`, `cxo`, `vp`, `director`, `manager`, `senior`, `entry`, `training`, `unpaid`.
seniority object
includearray of strings
excludearray of strings
functionarray of strings
DEPARTMENT IDs.
network_distancearray
Numeric 1/2/3 or string `GROUP`.
spoken_languagesarray of objects
Recruiter PRO only.
spoken_languages object
languagestringrequired
prioritystring
CAN_HAVEMUST_HAVEDOESNT_HAVE
scopestring
ELEMENTARYLIMITED_WORKINGPROFESSIONAL_WORKINGFULL_PROFESSIONALNATIVE_OR_BILINGUAL
hide_previously_viewedobject
hide_previously_viewed object
timespannumberrequired
Days.
profile_languagearray of strings
ISO 639-1 codes.
recently_joinedarray of objects
min in [2,8,15,31]; max in [1,7,14,30,90].
recently_joined object
minnumber
maxnumber
spotlightsarray of strings
OPEN_TO_WORKACTIVE_TALENTREDISCOVERED_CANDIDATESINTERNAL_CANDIDATESINTERESTED_IN_YOUR_COMPANYHAVE_COMPANY_CONNECTIONS
first_namearray of strings
Boolean modifiers supported.
last_namearray of strings
has_military_backgroundboolean
past_applicantsboolean
hiring_projectsobject
HIRING_PROJECTS include/exclude.
hiring_projects object
includearray of strings
excludearray of strings
recruiting_activityarray of objects
recruiting_activity object
idstringrequired
messagestagsnotesprojectsresumesreviews
prioritystring
CAN_HAVEMUST_HAVEDOESNT_HAVE
timespannumber
Days.
notesarray of strings

Body - Search from URL

urlstringrequired
Public LinkedIn search URL. Overrides every other body field.

Body - Cursor

cursorstringrequired
Pagination cursor returned by a previous call.

Response 200 OK

objectstringLinkedinSearchrequired
itemsarrayrequired
Each entry is one of the SearchResult variants: PEOPLE, COMPANY, POST, or JOB (see Result variants below).
configobjectrequired
Echo of the resolved search parameters. `config.params` mirrors the request body variant.
pagingobjectrequired
paging object
startnumberrequired
page_countnumberrequired
total_countnumberrequired
cursorstringrequired
Pass back to fetch the next page.
metadataobject
metadata object
search_history_idstring
search_context_idstring
search_request_idstring

Result variant - PEOPLE

objectstringSearchResultrequired
typestringPEOPLErequired
idstringrequired
public_identifierstringrequired
public_profile_urlstringrequired
profile_urlstringrequired
profile_picture_urlstringrequired
profile_picture_url_largestringrequired
member_urnstringrequired
namestringrequired
first_namestring
last_namestring
network_distancestringrequired
SELFDISTANCE_1DISTANCE_2DISTANCE_3OUT_OF_NETWORK
locationstringrequired
industrystringrequired
keywords_matchstring
headlinestringrequired
connections_countnumber
followers_countnumber
pending_invitationboolean
can_send_inmailboolean
premiumboolean
verifiedboolean
open_profileboolean
shared_connections_countnumber
recent_posts_countnumber
recently_hiredboolean
mentioned_in_the_newsboolean
hiddenCandidateboolean
interestLikelihoodstring
privacySettingsobject
privacySettings object
allowConnectionsBrowsebooleanrequired
showPremiumSubscriberIconbooleanrequired
skillsarray of objects
skills object
namestringrequired
endorsement_countnumberrequired
recruiter_candidate_idstring
recruiter_pipeline_categorystring
last_outreach_activityobject
last_outreach_activity object
typestringrequired
SEND_MESSAGEACCEPT_INVITATION
performed_atstringrequired
current_positionsarray of objects
Each entry includes `company`, `company_id`, `company_url`, `company_description`, `company_headcount` (min/max), `logo`, `description`, `role`, `location`, `industry[]`, `tenure_at_role` (years/months), `tenure_at_company`, `start` (year/month), `end`, `skills[]`.
educationarray of objects
Each entry: `degree`, `field_of_study`, `school`, `school_id`, `start`, `end`, `school_details` (name/employeeCount/location/description/url/logo).
work_experiencearray of objects
Past positions with same shape as `current_positions`.
certificationsarray of objects
`name`, `organization`, `organization_id`, `url`, `start.year`, `end.year`.
projectsarray of objects
`name`, `description`, `skills[]`, `start.year`, `end.year`.
interestsstring
tagsarray of objects
`{ id, name }`.
notesarray of objects
`project_id`, `content`, `created_at`, `author` (`id`, `seat_id`, `first_name`, `last_name`, `public_profile_url`).

Result variant - COMPANY

objectstringSearchResultrequired
typestringCOMPANYrequired
idstringrequired
namestringrequired
locationstringrequired
profile_urlstringrequired
industrystringrequired
summarystringrequired
followers_countnumber
job_offers_countnumber
headcountstring
revenue_rangeobject
revenue_range object
minnumberrequired
maxnumberrequired
currencystringrequired

Result variant - POST

objectstringSearchResultrequired
typestringPOSTrequired
providerstringLINKEDINrequired
idstringrequired
social_idstringrequired
Use with comment/reaction endpoints.
share_urlstringrequired
titlestring
textstringrequired
datestringrequired
parsed_datetimestringrequired
reaction_counternumberrequired
comment_counternumberrequired
repost_counternumberrequired
impressions_counternumberrequired
user_reactedstring
LIKEPRAISEAPPRECIATIONEMPATHYINTERESTENTERTAINMENT
authorobjectrequired
author object
public_identifierstringrequired
idstringrequired
namestringrequired
is_companybooleanrequired
headlinestring
profile_picture_urlstring
written_byobject
written_by object
idstringrequired
public_identifierstringrequired
namestringrequired
permissionsobjectrequired
permissions object
can_reactbooleanrequired
can_sharebooleanrequired
can_post_commentsbooleanrequired
is_repostbooleanrequired
repost_idstring
reposted_byobject
Same shape as `author`.
repost_contentobject
Original `{ id, date, parsed_datetime, author, text }` when this post reshares another.
mentionsarray of objectsrequired
`{ url, start, length }`.
attachmentsarray of objectsrequired
Variants: `img`, `video`, `audio`, `file`, `linkedin_post`, `video_meeting`. Common fields: `id`, `unavailable`, `mimetype`, `url`, `url_expires_at`, plus type-specific `size`/`duration`/`file_name`/`starts_at`/`expires_at`/`time_range`.
pollobject
`{ id, total_votes_count, question, is_open, options[] (id/text/win/votes_count) }`.
groupobject
`{ id, name, private }`.
analyticsobject
`impressions`, `engagements`, `engagement_rate`, `clicks`, `clickthrough_rate`, `page_viewers_from_this_post`, `followers_gained_from_this_post`, `members_reached`.

Result variant - JOB

objectstringSearchResultrequired
typestringJOBrequired
idstringrequired
reference_idstringrequired
titlestringrequired
locationstringrequired
posted_atstringrequired
ISO 8601 UTC datetime.
repostedbooleanrequired
urlstringrequired
promotedbooleanrequired
benefitsarray of stringsrequired
easy_applybooleanrequired
companyobjectrequired
company object
idstringrequired
public_identifierstringrequired
namestringrequired
profile_urlstringrequired
profile_picture_urlstringrequired

Example request

curl --request POST \
  --url 'https://api.postpress.ai/api/v1/linkedin/search?account_id=acc_linkedin_01HXYZ4QK3WJ8FN3M6QH7TZ8GR&limit=10' \
  --header 'X-API-KEY: pp_live_...' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "api": "classic",
    "category": "people",
    "keywords": "software engineer",
    "location": ["102277331"],
    "network_distance": [1, 2]
  }'

Example response

{
  "object": "LinkedinSearch",
  "items": [
    {
      "object": "SearchResult",
      "type": "PEOPLE",
      "id": "ACoAAA...",
      "public_identifier": "jordan-walke",
      "public_profile_url": "https://www.linkedin.com/in/jordan-walke",
      "profile_url": "https://www.linkedin.com/in/jordan-walke",
      "profile_picture_url": "https://media.licdn.com/.../picture.jpg",
      "profile_picture_url_large": "https://media.licdn.com/.../picture-large.jpg",
      "member_urn": "urn:li:member:1234567",
      "name": "Jordan Walke",
      "first_name": "Jordan",
      "last_name": "Walke",
      "network_distance": "DISTANCE_2",
      "location": "San Francisco, California, United States",
      "industry": "Software Development",
      "headline": "Software Engineer at Acme",
      "connections_count": 500,
      "followers_count": 1280,
      "pending_invitation": false,
      "can_send_inmail": true,
      "premium": false,
      "verified": true,
      "current_positions": [
        {
          "company": "Acme",
          "company_id": "9374000",
          "company_url": "https://www.linkedin.com/company/acme",
          "role": "Staff Software Engineer",
          "location": "San Francisco, California",
          "industry": ["Software Development"],
          "tenure_at_role":    { "years": 2, "months": 4 },
          "tenure_at_company": { "years": 3, "months": 0 },
          "start": { "year": 2023, "month": 1 }
        }
      ]
    }
  ],
  "config": {
    "params": { "api": "classic", "category": "people", "keywords": "software engineer" }
  },
  "paging":   { "start": 0, "page_count": 10, "total_count": 1248 },
  "cursor":   "eyJzdGFydCI6MTB9",
  "metadata": { "search_history_id": "hist_01HXYZ", "search_context_id": "ctx_01HXYZ", "search_request_id": "req_01HXYZ" }
}

Errors

Every error response follows the same envelope:

titlestringrequired
Short error title.
detailstringoptional
Human-readable explanation.
instancestringoptional
Request identifier for support.
typestringrequired
Error type identifier.
statusnumberrequired
HTTP status code.
400 Bad Request8 types

The request body is malformed or the body variant is invalid.

  • errors/invalid_parameters - One or more parameters are invalid (wrong enum, wrong shape, unknown filter for the chosen `api`/`category`).
  • errors/malformed_request - The request is malformed.
  • errors/content_too_large - The request body is too large.
  • errors/invalid_url - When using the `Search from URL` body, the URL is not a valid LinkedIn search URL.
  • errors/too_many_characters - A string field exceeds the allowed length.
  • errors/unescaped_characters - A field contains characters that must be encoded.
  • errors/missing_parameters - A required field (`api`/`category`, `account_id`, ...) is missing.
  • errors/limit_too_high - `limit` exceeds the maximum (50 for Classic, 100 for Sales Navigator / Recruiter).
401 Unauthorized13 types

Credentials are missing, expired, or otherwise invalid.

  • errors/missing_credentials - Some credentials are necessary to perform the request.
  • errors/multiple_sessions - LinkedIn limits multiple sessions on certain Recruiter accounts. Use the cookie connection method.
  • errors/wrong_account - The provided credentials do not match the correct account.
  • errors/invalid_credentials - The provided credentials are invalid.
  • errors/invalid_proxy_credentials - The provided proxy credentials are invalid.
  • errors/invalid_checkpoint_solution - The checkpoint resolution did not pass successfully. Retry.
  • errors/checkpoint_error - The checkpoint does not appear to be resolvable.
  • errors/expired_credentials - Credentials have expired. Reconnect the account.
  • errors/expired_link - This link has expired. Generate a new one.
  • errors/insufficient_privileges - This resource is out of your API-key scopes.
  • errors/disconnected_account - The account is disconnected from the provider service.
  • errors/disconnected_feature - The service you're trying to reach is disconnected.
  • errors/invalid_credentials_but_valid_account_imap - IMAP/SMTP credentials are invalid but the account is otherwise valid.
403 Forbidden9 types

Authenticated but the account is restricted or the action is not allowed.

  • errors/insufficient_permissions - Valid authentication but insufficient permissions to perform the request.
  • errors/account_restricted - The account has been restricted by the provider.
  • errors/account_mismatch - This action cannot be done with your account.
  • errors/unknown_authentication_context - An additional step seems necessary to complete login.
  • errors/session_mismatch - Token user id does not match client session id.
  • errors/feature_not_subscribed - Sales Navigator or Recruiter is not subscribed on this account.
  • errors/subscription_required - A subscription is required to use this feature.
  • errors/resource_access_restricted - You don't have access to this resource.
  • errors/action_required - An additional step is required.
404 Not Found2 types

The targeted account or resource does not exist.

  • errors/resource_not_found - The requested resource was not found.
  • errors/invalid_resource_identifier - The provided identifier is not valid for this resource.
500 Internal Server Error3 types

Something went wrong on our side or with the upstream provider.

  • errors/unexpected_error - Something went wrong.
  • errors/provider_error - The provider is experiencing operational problems. Retry later.
  • errors/authentication_intent_error - The current authentication intent was killed after failure.
503 Service Unavailable5 types

postpress is temporarily unable to handle the request.

  • errors/no_client_session - No client session is currently running.
  • errors/no_channel - No channel to client session.
  • errors/no_handler - Handler missing for that request.
  • errors/network_down - Network is down on the server side. Retry shortly.
  • errors/service_unavailable - Service temporarily unavailable. Retry later.
504 Gateway Timeout1 types

The upstream provider did not respond in time.

  • errors/request_timeout - Request timed out. Retry, and contact support if it persists.
Updated May 2026