---
title: "Discover Job Openings"
method: GET
path: "/discover/job_openings"
tags: ["Job Openings Dataset"]
---

# Discover Job Openings

`GET /discover/job_openings`

Returns a list of Job Openings filtered by a given profession (e.g. "Sales Engineers" or "Marketing Managers") using O*NET occupation codes and/or location of the company.</br><strong>Note:</strong> This endpoint returns only job openings found within the last year.<br/><strong>Note:</strong> This endpoint returns an estimated count of all results.

## Query parameters

- `onet_codes` string[]
- `location` string
- `active_only` boolean
- `found_at_from` string, date
- `seniority` 'not_set' | 'founder' | 'c_level' | 'partner' | 'president' | 'vice_president' | 'head' | 'director' | 'manager' | 'mid_senior' | 'junior'
- `title` string
- `page` integer
- `limit` integer

## Response `200`

Request was successfully processed.

- JobOpeningsDataset — PredictLeads has historical jobs data since 2016 that includes over 270 million records, and is available for 2.7 million companies, which includes an average of 9.8 million active jobs at any given time. <br><br> Job Openings are sourced directly from company websites which includes their career subpages, and ATS integrations. All Jobs are categorized using industry-standard <a target="_blank" rel="noopener" href="https://www.onetonline.org/">O\*NET codes</a>. <br><br> The Job Openings Dataset includes fields such as Job Opening Title, Job Opening URL, First Seen At, Last Seen At, Location, Category, Seniority, Description, Salary, Contract Type, O\*NET Job Category Codes and other Job Opening information.
  - `data` JobOpening[], required — unresolved $ref
  - `included` CompanyLite[], required — Contains objects referenced in property `relationships`. — unresolved $ref
  - `meta` object — Meta information about `JobOpeningsDataset` object.
    - `schema_version` string, required — Represents schema version of objects.
    - `record_state` 'active', required — Represents record state of objects.
    - `count` integer — Total number of results. <br> **NOTE**: Only included in API responses when the request parameter `page` is provided, for performance reasons.
    - `crawler_potentially_blocked` boolean — Whether our crawlers returned errors indicating the website might be blocking us. <br> **NOTE**: Only shown in API responses.
    - `no_active_openings_confirmed` boolean, nullable — Whether the absence of active job openings has been confirmed by the company's jobs subpage. <br> `null` unless an `active_only=true` request returns no openings (i.e. not an `active_only` request, the website has not been processed yet, or active openings were returned). When set, `true` means the jobs subpage confirmed the absence and `false` means it did not. <br> **NOTE**: Only shown in API responses.

## Other responses

- `400` — Invalid request body or parameters.
- `401` — Authentication credentials are invalid or API subscription is not activated.
- `402` — Exceeded the monthly request limit.
- `403` — Request rate over limit.
- `404` — Record not found.
- `422` — Provided data failed to validate.
- `429` — Too many requests.
- `500` — Internal server error.
- `503` — Service temporarily unavailable.

---

[API](https://skmtc.dev/predictleads/apis/predictleads-api-reference.md) · [All operations](https://skmtc.dev/predictleads/apis/predictleads-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/predictleads/predictleads-api-reference/revisions/a56831a1efd4/schema)