> ## 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](https://docs.peopledatalabs.com/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.

<Image align="center" border={true} src="https://files.readme.io/171e7dac39bb662c1830716a533c4ceea9f7a068b03fd69f8133f99db53aec2c-PDL_APIs_Summary_-_Job_Posting_Search_API.png" className="border" />

### 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](https://docs.peopledatalabs.com/docs/reference-job-posting-api#field-filters) or an [Elasticsearch query](https://docs.peopledatalabs.com/docs/reference-job-posting-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](https://docs.peopledatalabs.com/docs/reference-job-posting-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](https://docs.peopledatalabs.com/docs/reference-job-posting-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](https://docs.peopledatalabs.com/docs/reference-job-posting-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](https://docs.peopledatalabs.com/docs/quickstart-job-posting-api) to make your first request
2. Use the [Use Cases](https://docs.peopledatalabs.com/docs/use-cases-job-posting-api) page to see real-world applications of this endpoint
3. Use the [Reference](https://docs.peopledatalabs.com/docs/reference-job-posting-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](https://docs.peopledatalabs.com/docs/quickstart-job-posting-api)             | A quick hands-on introduction to the API with simple code examples.                                                      |
| [Use Cases](https://docs.peopledatalabs.com/docs/use-cases-job-posting-api)               | Code examples for real-world use cases for the Job Posting API.                                                          |
| [Reference](https://docs.peopledatalabs.com/docs/reference-job-posting-api)               | Detailed descriptions of the technical specifications and usage constraints.                                             |
| [Input Parameters](https://docs.peopledatalabs.com/docs/input-parameters-job-posting-api) | In-depth explanations of the input parameters that the API supports.                                                     |
| [Output Response](https://docs.peopledatalabs.com/docs/output-response-job-posting-api)   | In-depth explanations of the output response object that the API returns.                                                |
| [Examples](https://docs.peopledatalabs.com/docs/examples-job-posting-api)                 | A collection of functional code examples and walkthroughs that illustrate various use cases and applications of the API. |
| [FAQs](https://docs.peopledatalabs.com/docs/faqs-job-posting-api)                         | Answers to commonly asked questions and other good-to-know information.                                                  |

***

<Image align="center" src="https://files.readme.io/891be0ed02ce4959796635e8174b6ed7798a85f2595404a0ac7609c814e3a71b-Recruiting_Banner_for_Docs.png" />

*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) →*