LinkedIn

Search LinkedIn jobs

Job search by keywords, companies, or filters; a jobs search URL replaces them all. location, industries, jobTitles and jobFunctions take ids from GET /api/v1/linkedin/search/parameters.

POST

/api/v1/linkedin/jobs/search

Request bodyrequired

connectedAccountIdrequired

string · uuid

Connected account to act as

keywordsoptional

string

companiesoptional

string[]

Companies to search within. Each non-numeric identifier costs one extra lookup call.

locationoptional

string

A single location id from GET /api/v1/linkedin/search/parameters?type=LOCATION. One location per search.

industriesoptional

string[]

Industry ids from GET /api/v1/linkedin/search/parameters?type=INDUSTRY.

jobTitlesoptional

string[]

Job title ids from GET /api/v1/linkedin/search/parameters?type=JOB_TITLE.

jobFunctionsoptional

string[]

Job function ids from GET /api/v1/linkedin/search/parameters?type=JOB_FUNCTION.

seniorityoptional

"executive" | "director" | "mid_senior" | "associate" | "entry" | "intern"[]

jobTypeoptional

"full_time" | "part_time" | "contract" | "temporary" | "volunteer" | "internship" | "other"[]

workplaceoptional

"on_site" | "hybrid" | "remote"[]

postedWithinDaysoptional

integer

sortByoptional

"relevance" | "date"

Defaults to relevance.

searchUrloptional

string · uri

A LinkedIn jobs search URL, which cannot be combined with the filter fields above. Use it for filters this endpoint does not expose, such as salary.

cursoroptional

string

limitoptional

integer

Page size, capped at 50 for a classic job search. Use cursor for the next page.

Response

200Jobs and an optional cursor.

jobs

object[]

cursor

string | null

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy