Apinoa Docs

Jobs

Search LinkedIn job postings.

View raw .mdx
GET | POST /v1/linkedin/jobs

Send parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.

What to Pass

PassReadsNotes
queryJob postings matching the keywordslocation narrows to a place (default worldwide)

Pass one source per call. Every identifier also takes the page URL.

Parameters

ParameterTypeRequiredNotes
cursorstringOpaque cursor from the previous page's cursor. Pass it alone for the next page.
locationstringLocation name (e.g. United States). Default: worldwide.
querystringJob search keywords (e.g. software engineer).

Request

curl "https://gateway.apinoa.com/v1/linkedin/jobs?query=software+engineer&location=United+States" \
  -H "x-api-key: $APINOA_API_KEY"

Response

Returns Page of Job in data. A real response, shortened: arrays keep their first entries and long text is cut.

{
  "success": true,
  "data": {
    "platform": "linkedin",
    "items": [
      {
        "platform": "linkedin",
        "id": "4419969671",
        "url": "https://www.linkedin.com/jobs/view/senior-software-engineer-%E2%80%93-go-golang-at-general-motors-4419969671",
        "title": "Senior Software Engineer – Go (Golang)",
        "company": {
          "name": "General Motors",
          "url": "https://www.linkedin.com/company/general-motors"
        },
        "location": "Warren, MI",
        "listedAt": "2026-10-04T00:00:00.000Z",
        "logoUrl": "https://media.licdn.com/dms/image/v2/D4E0BAQEfAZWzerj03w/company-logo_100_100/B4EZdkPGXYGcAQ-/0/1749733370529/general_m…"
      }
    ],
    "cursor": "h_TeY5EWj-37w_ujJXXHN6eeZOrORkaeSsEUKA69tm4TPSluwQfHvBfTozUFn5_nbiNu-IDKi84g4OL33eFYlGA42NNn9alAFWwQyWLmbZkF3r6nNl10nnG…"
  }
}

Errors

StatusCodeMeaning
400INVALID_CURSORThe cursor is not one this operation returned. Start again without it.
400INVALID_PARAMSA parameter is missing, unknown or out of range. The message names it.
401UNAUTHORIZEDThe x-api-key header is missing, or the key is revoked or unknown.
402INSUFFICIENT_BALANCEThe balance does not cover this call. Top up in the dashboard.
404NOT_FOUNDThe account, post or group does not exist, or is private, deleted or age-restricted.
429MARKETPLACE_SATURATEDToo many concurrent calls. Retry after the Retry-After seconds.
502UPSTREAM_ERRORThe platform answered with something unusable. Retry with backoff.

Every code is listed in Errors. Failed calls are not billed.

Pricing

Price $0.001 per call. List price; the rate steps down above 1,000 calls a day.

Notes

  • A LinkedIn-only record; its fields are shown in the response.

On this page