> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peopledatalabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/docs/job-posting-data-overview) 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.

<Frame>
  <img src="https://mintcdn.com/peopledatalabs/YteP5zgY1fC23mEV/images/docs/171e7dac39bb662c1830716a533c4ceea9f7a068b03fd69f8133f99db53aec2c-PDL_APIs_Summary_-_Job_Posting_Search_API.png?fit=max&auto=format&n=YteP5zgY1fC23mEV&q=85&s=103ebbb4bb72f90db43c004f5621e31f" align="center" data-transcend-suppress width="960" height="540" data-path="images/docs/171e7dac39bb662c1830716a533c4ceea9f7a068b03fd69f8133f99db53aec2c-PDL_APIs_Summary_-_Job_Posting_Search_API.png" />
</Frame>

### 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](/docs/reference-job-posting-search-api#field-filters) or an [Elasticsearch query](/docs/reference-job-posting-search-api#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](/docs/reference-job-posting-search-api#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](https://www.peopledatalabs.com/job-posting-beta-sign-up).
See the [reference page](/docs/reference-job-posting-search-api#access) for more details on access.

### Billing

Each job posting returned = 1 credit.\
Use the `size` parameter to control costs.
See the [reference page](/docs/reference-job-posting-search-api#billing) for more details on billing and credit usage.

<br />

## 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](/docs/quickstart-job-posting-search-api) to make your first request
2. Use the [Use Cases](/docs/use-cases-job-posting-search-api) page to see real-world applications of this endpoint
3. Use the [Reference](/docs/reference-job-posting-search-api) to dive deeper into search modes, billing, and endpoint behavior

<br />

## What's Next

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

| Page                                                              | Description                                                                                                              |
| :---------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------- |
| [Quickstart](/docs/quickstart-job-posting-search-api)             | A quick hands-on introduction to the API with simple code examples.                                                      |
| [Use Cases](/docs/use-cases-job-posting-search-api)               | Code examples for real-world use cases for the Job Posting API.                                                          |
| [Reference](/docs/reference-job-posting-search-api)               | Detailed descriptions of the technical specifications and usage constraints.                                             |
| [Input Parameters](/docs/input-parameters-job-posting-search-api) | In-depth explanations of the input parameters that the API supports.                                                     |
| [Output Response](/docs/output-response-job-posting-search-api)   | In-depth explanations of the output response object that the API returns.                                                |
| [Examples](/docs/examples-job-posting-search-api)                 | A collection of functional code examples and walkthroughs that illustrate various use cases and applications of the API. |
| [FAQs](/docs/faqs-job-posting-search-api)                         | Answers to commonly asked questions and other good-to-know information.                                                  |

***

<Frame>
  <img align="center" src="https://mintcdn.com/peopledatalabs/YteP5zgY1fC23mEV/images/docs/891be0ed02ce4959796635e8174b6ed7798a85f2595404a0ac7609c814e3a71b-Recruiting_Banner_for_Docs.png?fit=max&auto=format&n=YteP5zgY1fC23mEV&q=85&s=abe1365e54a2f16de90de429336be8de" data-transcend-suppress width="1685" height="215" data-path="images/docs/891be0ed02ce4959796635e8174b6ed7798a85f2595404a0ac7609c814e3a71b-Recruiting_Banner_for_Docs.png" />
</Frame>

*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](https://www.peopledatalabs.com/company?utm_source=docs\&utm_medium=footer\&utm_campaign=cta#jobs) →*


## Related topics

- [Quickstart - Job Posting Search API](/docs/quickstart-job-posting-search-api.md)
- [Reference - Job Posting Search API](/docs/reference-job-posting-search-api.md)
- [Examples - Job Posting Search API](/docs/examples-job-posting-search-api.md)
- [Output Response - Job Posting Search API](/docs/output-response-job-posting-search-api.md)
- [Use Cases - Job Posting Search API](/docs/use-cases-job-posting-search-api.md)