POST /linkedin_job_search • Credits: 0.1 credits per returned job

LinkedIn Job Search returns LinkedIn job postings that match a job title, a company, a location, a job type and an experience level. The response holds one page of job postings in the elements array. Each POST call costs 0.1 credits per returned job, and a full page of 25 jobs costs 2.5 credits.

What does LinkedIn Job Search do?

Sales teams need to know which companies grow right now. A company that posts a job has budget and a plan to hire. LinkedIn Job Search reads LinkedIn job postings and returns them as structured records. Each record holds the job ID, the job title, the company name and the location. Every parameter is a filter, and every parameter is optional. The data source is LinkedIn. One call returns one page of job postings, and the page parameter moves through the pages.

Which endpoint does LinkedIn Job Search use?

Method: POST
URL: https://api.richapi.ai/api/v1/linkedin_job_search
Authentication: x-api-key header
Request format: JSON request body
Response: synchronous JSON
Page size: 25 job postings
Credits: 0.1 credits per returned job

LinkedIn Job Search accepts the POST method only. If you send GET, the API returns 405.

Send every parameter in the JSON request body. If you put a parameter in the query string, the API returns 400 with the error Query parameters are not supported for this endpoint.

How to send a LinkedIn Job Search request

Copy your API key from the RichAPI dashboard.
Choose the filters for the job postings that you want to find.
Set title to a job title keyword, for example Software Engineer.
Set location to a location text value, or set geoId to a LinkedIn geo ID.
Set page to 0 for the first page.
Send a POST request to https://api.richapi.ai/api/v1/linkedin_job_search.
Send the API key in the x-api-key header.
Read the job postings from the elements array in the response.

CAUTION: Count the pages that you request before you start. Each full page of 25 job postings costs 2.5 credits.

cURL

curl -X POST https://api.richapi.ai/api/v1/linkedin_job_search   
  -H "x-api-key: YOUR_API_KEY"   
  -H "Content-Type: application/json"   
  -d '{
    "title": "Software Engineer",
    "location": "San Francisco",
    "jobType": "full_time",
    "experienceLevel": "mid_senior_level",
    "page": 0
  }'

Python

import requests

response = requests.post(
    "https://api.richapi.ai/api/v1/linkedin_job_search",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "title": "Software Engineer",
        "location": "San Francisco",
        "jobType": "full_time",
        "experienceLevel": "mid_senior_level",
        "page": 0,
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())

Node.js

const response = await fetch("https://api.richapi.ai/api/v1/linkedin_job_search", {
  method: "POST",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    title: "Software Engineer",
    location: "San Francisco",
    jobType: "full_time",
    experienceLevel: "mid_senior_level",
    page: 0,
  }),
});

const data = await response.json();
console.log(data);

What parameters does LinkedIn Job Search accept?

LinkedIn Job Search accepts seven parameters. Every parameter is optional. Send at least one filter so that the search returns a useful list. The default "" means that RichAPI does not apply the filter.

Parameter	Type	Required	Default	Description
`title`	string	No	`""`	Job title keyword, for example `Software Engineer`.
`company`	string	No	`""`	Company name or LinkedIn company URL.
`location`	string	No	`""`	Location text filter, for example `San Francisco`.
`geoId`	string	No	`""`	LinkedIn geo ID for precise location filtering.
`jobType`	string	No	`""`	Job type filter. See the value table below.
`experienceLevel`	string	No	`""`	Experience level filter. See the value table below.
`page`	integer	No	`0`	Page number for pagination.

The parameter names in the request body are the same names that the RichAPI dashboard, the MCP tool linkedin_job_search and the n8n operation linkedin_job_search use. Match the capital letters exactly. An unknown field name returns 400 with the error Unknown input field(s) and a supported_fields list.

Which values does jobType accept?

Value

full_time

part_time

contract

temporary

internship

volunteer

other

Which values does experienceLevel accept?

Value

internship

entry_level

associate

mid_senior_level

director

executive

How do I find companies that hire right now?

A new job posting is a hiring signal. A company that posts a job has budget, and it plans to grow the team. Sales teams use that signal to time an outbound message. Follow these steps:

Set title to the role that your product supports, for example Sales Development Representative.
Set location or geoId to your target market.
Set experienceLevel to the seniority that matches your buyer.
Send the request and read the elements array.
Read companyName for each job posting. That company hires right now.
Find the LinkedIn company URL for that company name.
Send the LinkedIn company URL to Company Enrichment API for the size, the industry and the website.
Send the job id to LinkedIn Job Details API for the full job description.

A repeated search finds new job postings over time. Run the same filters once per week and compare the job id values against the results of the previous week.

What does LinkedIn Job Search return?

LinkedIn Job Search returns a JSON object with an elements array. The block below is an example response for the request above. The values are illustrative.

{
  "elements": [
    {
      "id": "4388248291",
      "title": "Senior Software Engineer",
      "companyName": "Datadog",
      "location": {
        "linkedinText": "San Francisco, California, United States"
      }
    },
    {
      "id": "4390117562",
      "title": "Staff Software Engineer, Platform",
      "companyName": "Ramp",
      "location": {
        "linkedinText": "New York, New York, United States"
      }
    }
  ]
}

Which fields does the LinkedIn Job Search response hold?

Field	Type	Description
`elements`	array	The list of matched job postings for this page. RichAPI bills 0.1 credits per element.
`elements[].id`	string	The LinkedIn job identifier. Send this value to LinkedIn Job Details.
`elements[].title`	string	The job title of the posting.
`elements[].companyName`	string	The name of the company that posted the job.
`elements[].location`	object	The location of the job posting.
`elements[].location.linkedinText`	string	The location text from LinkedIn.

How does LinkedIn Job Search pagination work?

LinkedIn Job Search returns one page of up to 25 job postings per call. The page parameter selects the page, and the default value is 0. To read the next page, send the same filters again with the page value increased by 1. When the elements array comes back empty, stop. Each page is a separate call, and each page costs 0.1 credits per returned job posting.

How much does LinkedIn Job Search cost?

LinkedIn Job Search costs 0.1 credits for each job posting in the elements array. One credit costs $0.02 on the 1,000 and 5,000 credit packs, so one job posting costs $0.002 there. Larger packs cost less per credit. A full page of 25 job postings costs 25 x 0.1 = 2.5 credits. That is $0.05.

Cost of one call, by the number of job postings returned:

Job postings returned	Credits	Cost
0	0	$0.00
5	0.5	$0.01
10	1	$0.02
25 (one full page)	2.5	$0.05

Cost of many calls, with a full page of 25 job postings per call:

Calls	Job postings	Credits	Cost
1	25	2.5	$0.05
10	250	25	$0.50
40	1,000	100	$2.00
100	2,500	250	$5.00
400	10,000	1,000	$20.00

RichAPI reserves 2.5 credits before each call. That reservation is the page size of 25 multiplied by 0.1 credits. After the response arrives, RichAPI charges 0.1 credits per returned job posting and releases the rest of the reservation. RichAPI refunds the full reservation for any response outside the 200 range.

Which errors can LinkedIn Job Search return?

Status	Meaning	What to do
`400`	The request body failed validation. An unknown field name, a wrong value type, or a parameter in the query string causes this failure.	Correct the parameter that the error message names. Read the `supported_fields` list in the error response.
`401`	The API key is missing, wrong or revoked.	Send a valid key in the `x-api-key` header.
`402`	`Insufficient credits`: the organization has too few credits for the 2.5 credit reservation. Or `Monthly spend limit reached`: the team hit its monthly spend limit.	Buy credits in the RichAPI dashboard, or ask the organization owner to raise the spend limit.
`403`	`Endpoint not available on your plan`: this API key has no access to this endpoint.	Call `GET /api/v1/my-endpoints` to list the endpoints this key can use. Contact support for access.
`405`	The request used a method other than `POST`.	Send the request again with the `POST` method.
`429`	Too many requests for the rate limit of the organization.	Read the `Retry-After` header. Wait that many seconds, then send the request again.
`500`	The API failed.	Send the request again. If the failure repeats, contact support.
`502`	The upstream data provider failed.	Send the request again after a short wait.
`504`	The upstream data provider timed out.	Send the request again after a short wait.

Frequently asked questions

Does LinkedIn Job Search use GET or POST?

LinkedIn Job Search uses POST. Send every parameter in the JSON request body, because the API rejects a query string parameter with a 400 error.

How many job postings does one LinkedIn Job Search page return?

One LinkedIn Job Search page returns up to 25 job postings in the elements array. To read the next page, send the same filters again with the page value increased by 1.

Does a LinkedIn Job Search call that returns zero job postings cost credits?

No. RichAPI charges 0.1 credits per job posting in the elements array, so an empty elements array costs 0 credits. RichAPI releases the whole reservation after the response arrives.

Is any LinkedIn Job Search parameter required?

No. All seven LinkedIn Job Search parameters are optional. Send at least one filter, such as title or company, so that the search returns a useful list.

How do I use LinkedIn Job Search as a hiring signal for sales?

Search for the job titles that your product supports in your target market. Each result in elements names a company that hires right now. A company that hires has growth and budget.

How do I get the full description of a job posting?

Send the id value of the job posting to the LinkedIn Job Details API. LinkedIn Job Details costs 1 credit per call and returns the full job description, the employment type and the workplace type.

What is the difference between location and geoId?

The location parameter takes a location text value, for example San Francisco. The geoId parameter takes a LinkedIn geo ID, and it filters the search to an exact LinkedIn location.

LinkedIn Job Search API