Docs / Jobs

list_job_postings

List your job postings: open, drafts or closed.

This action only reads. It changes nothing, so it is safe to try.

What you give it

InputWhat it isWhere to get it
category
optional
One of: active, draft, closed. Which postings (default active).You write it.
limit
optional
A number, 1 to 100. How many to return (1–100, default 25).You write it.
cursor
optional
A cursor. nextCursor from the previous call, to get the next page. Keep the other arguments the same.The nextCursor from the last answer of list_job_postings.
connectionId
optional
A connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.Run list_linkedin_accounts and use accounts[].id from its answer.
15 more places to get it

Call it

curl -X POST https://api.heyreagent.com/v1/actions/list_job_postings \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{}'
The same call in JavaScript
const response = await fetch("https://api.heyreagent.com/v1/actions/list_job_postings", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_KEY",
    "content-type": "application/json",
  },
  body: JSON.stringify({}),
});
const answer = await response.json();
console.log(answer);
The same call in Python
import requests

response = requests.post(
    "https://api.heyreagent.com/v1/actions/list_job_postings",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={},
)
print(response.json())
The same call in n8n

Add an HTTP Request node and fill it in like this:

MethodPOST
URLhttps://api.heyreagent.com/v1/actions/list_job_postings
Send HeadersOn. Name Authorization, Value Bearer YOUR_KEY
Send BodyOn. Body Content Type JSON, Specify Body Using JSON, then paste the body below
{}

Put your own key where it says YOUR_KEY. New here? Start with your first call.

What you get back

When it worked, the answer is { "ok": true, "result": { … } }. Inside result:

returnednumber
nextCursorA cursor. Other actions take it.
jobPostings[].idA job id. Other actions take it.
jobPostings[].stateactive | draft | review | closed | paused
jobPostings[].titlestring
jobPostings[].descriptionstring
jobPostings[].companystring
jobPostings[].companyIdstring
jobPostings[].locationstring
jobPostings[].applicantsCounternumber
jobPostings[].viewsCounternumber
jobPostings[].costnumber
jobPostings[].createdAtnumber
jobPostings[].publishedAtnumber
jobPostings[].closedAtnumber
jobPostings[].applyUrlstring
jobPostings[].salarystring
jobPostings[].workplacestring
jobPostings[].senioritystring
jobPostings[].skillsstring[]
jobPostings[].functionsstring[]
jobPostings[].industriesstring[]

A field that does not apply to an answer is left out, or is null. There are 7 more fields nested inside these.

When it did not work, the answer is { "ok": false, "error": "…", "message": "…" }. What each error means.

Good to know

What its answer goes into

Guides that use it

In Claude or ChatGPT

Once connected, ask in your own words. The assistant sees this action as a tool with the same name, list_job_postings, and the same inputs.

More in Jobs