Job Posting Search API

Overview

The Job Posting Search API allows you to search PDL's job posting dataset.

It lets you query and retrieve structured records from our full Job Posting Dataset without needing to host or manage the full dataset yourself.

With the Job Posting Search API, you can:

  • Search millions of active and historical job postings
  • Filter by company, title, location, salary, and more
  • Retrieve full job posting records, including descriptions and metadata
  • Access daily job posting data sourced directly from company career pages

In practice, this means you send a search request and the API returns matching job posting records from the dataset.

What Is It?

It is a search endpoint for job posting records.

Endpoint: https://api.peopledatalabs.com/v5/job_posting/search

You can use it to search for job postings and return complete records from our current Job Posting Dataset.

How it works

  1. You send a search request using either Field Filters or an Elasticsearch query
  2. The API returns any matching job posting records
  3. Each record returned consumes 1 credit
  4. Use scroll_token to paginate through large result sets

If you are new to the endpoint, start with Field Filters. They are the simplest way to search by things like company, title, location, or salary.

Access

The Job Posting API is in Beta. To request access, please reach out to your customer account team, or contact us. See the reference page for more details on access.

Billing

Each job posting returned = 1 credit.
Use the size parameter to control costs. See the reference page for more details on billing and credit usage.


Start Here

If this is your first time using the Job Posting API, this is the easiest way to get started:

  1. Read the Quickstart to make your first request
  2. Use the Use Cases page to see real-world applications of this endpoint
  3. Use the Reference to dive deeper into search modes, billing, and endpoint behavior

What's Next

Please check out the following pages for more information on the Job Posting API:

PageDescription
QuickstartA quick hands-on introduction to the API with simple code examples.
Use CasesCode examples for real-world use cases for the Job Posting API.
ReferenceDetailed descriptions of the technical specifications and usage constraints.
Input ParametersIn-depth explanations of the input parameters that the API supports.
Output ResponseIn-depth explanations of the output response object that the API returns.
ExamplesA collection of functional code examples and walkthroughs that illustrate various use cases and applications of the API.
FAQsAnswers to commonly asked questions and other good-to-know information.

Know someone who’d thrive building data products and helping us launch what’s next? We’d love to meet!

Check out our open roles