Skip to main content
POST
/
v2
/
recruiter
Get Job Posts
curl --request POST \
  --url https://api.example.com/v2/recruiter \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "account_id": "<string>",
  "action": "<string>",
  "params": {
    "job_id": "<string>",
    "count": 123,
    "offset": 123,
    "fetch_details": true
  }
}
'
{
  "success": true,
  "data": {
    "posts": [
      {
        "linkedin_job_id": "4178681638",
        "title": "Growth Hacker",
        "company_name": "Acme Corp",
        "location": "France",
        "job_state": "CLOSED",
        "employment_status": "Full-time",
        "workplace_type": "",
        "created_at": 1741369464000,
        "listed_at": 1761591723000,
        "closed_at": 1762167565000,
        "num_views": 962,
        "num_applies": 100,
        "job_url": "https://www.linkedin.com/jobs/view/4178681638/",
        "contact_email": "[email protected]",
        "industry": ["Software Development"],
        "budget": {
          "total_charge": "277.20",
          "currency": "EUR",
          "buffered_total_charge": "417.00",
          "daily_budget": "88.0"
        }
      }
    ],
    "total_results": 1,
    "total_available_results": 1,
    "pagination": {
      "offset": 0,
      "count": 1,
      "next_offset": null,
      "has_more": false,
      "results_per_page": 25
    }
  },
  "metadata": {
    "action": "get_posts",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

Overview

Retrieve job postings from your LinkedIn recruiter account. Pass job_id to fetch a specific job (with full details) or omit it to list all jobs (offset-based pagination).
This endpoint consumes 1 credit per 10 results returned.

Request

x-api-key
string
required
Your API key for authentication.
account_id
string
required
The unique identifier of the account to use.
action
string
required
Must be "get_posts".
params
object

Response

success
boolean
Indicates whether the request was successful.
data
object
metadata
object
{
  "success": true,
  "data": {
    "posts": [
      {
        "linkedin_job_id": "4178681638",
        "title": "Growth Hacker",
        "company_name": "Acme Corp",
        "location": "France",
        "job_state": "CLOSED",
        "employment_status": "Full-time",
        "workplace_type": "",
        "created_at": 1741369464000,
        "listed_at": 1761591723000,
        "closed_at": 1762167565000,
        "num_views": 962,
        "num_applies": 100,
        "job_url": "https://www.linkedin.com/jobs/view/4178681638/",
        "contact_email": "[email protected]",
        "industry": ["Software Development"],
        "budget": {
          "total_charge": "277.20",
          "currency": "EUR",
          "buffered_total_charge": "417.00",
          "daily_budget": "88.0"
        }
      }
    ],
    "total_results": 1,
    "total_available_results": 1,
    "pagination": {
      "offset": 0,
      "count": 1,
      "next_offset": null,
      "has_more": false,
      "results_per_page": 25
    }
  },
  "metadata": {
    "action": "get_posts",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}