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
- You send a search request using either Field Filters or an Elasticsearch query
- The API returns any matching job posting records
- Each record returned consumes 1 credit
- Use
scroll_tokento 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:
- Read the Quickstart to make your first request
- Use the Use Cases page to see real-world applications of this endpoint
- 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:
| Page | Description |
|---|---|
| Quickstart | A quick hands-on introduction to the API with simple code examples. |
| Use Cases | Code examples for real-world use cases for the Job Posting API. |
| Reference | Detailed descriptions of the technical specifications and usage constraints. |
| Input Parameters | In-depth explanations of the input parameters that the API supports. |
| Output Response | In-depth explanations of the output response object that the API returns. |
| Examples | A collection of functional code examples and walkthroughs that illustrate various use cases and applications of the API. |
| FAQs | Answers 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 →
Updated about 2 hours ago
