Output Response

Response Data Structure

Here is an example response from the Job Posting Search API:

{
    "status": 200,
    "data": [
        {
          "id": "mCxejm1sT+Q",
          "first_seen": "2025-02-27",
          "last_verified": "2025-02-27",
          ... // Rest of the details for this Job Posting record
        },
        ... // Rest of the Job Posting records in the response
    ],
    "total": 6,
    "scroll_token": "13.312621$543927",
    "dataset_version": "34.0"
}

Response Fields

data.*

The data list is made up of objects that contain the full PDL record for each job posting that matches the API request. Any fields within these records that we do not have data for will have a null value.

See the Example Job Posting Record for an example of a full job posting record that would be contained in the data array.

📘

Sorting

Job posting records are sorted in the data array based the most recent records first (using the first_seen field of each record.

status

total

scroll_token

If your query matches more records than are returned in the current response, use the scroll_token value in your next request to retrieve the next batch.

Example:

{
  "company_name": "openai",
  "title_role": "engineering",
  "size": 3,
  "scroll_token": "PASTE_SCROLL_TOKEN_HERE",
  "api_key": "YOUR_API_KEY"
}

Keep sending the same query with the newest scroll_token until you have the records you need or the pagination is complete.

For a complete working example, see Examples.

dataset_version

This field indicates which underlying Job Posting dataset release was used to generate the response.