Job Posting Data

Jobs Data API

10min

This section covers general details about Jobs data API. Follow the links inside the topics to find out more details on the API and its endpoints.

You can try out the Jobs Data API playground on Coresignal's Self-service.

Jobs data API endpoints

Our API is a data retrieval tool. The endpoints do not support analytic features.

Jobs data API features two search and one collect endpoints. Use the endpoints with any API-compatible application to retrieve Professional Network Job posting data.

Request type

Endpoint

POST

/v2/job_base/search/filter

POST

/v2/job_base/search/es_dsl

GET

/v2/job_base/collect/{job_id}

Bulk API (Bulk collect) expands on Jobs data API's functionality and consists of two POST and two GET endpoints. It allows you to perform batch searches and data collection using ID lists, search filters, or ES DSL queries.

Request type

Endpoint

POST

/v2/data_requests/job_base/id_file

POST

/v2/data_requests/job_base/filter

GET

/v2/data_requests/{data_request_id}/files

GET

/v2/data_requests/{data_request_id}/files/{file_name}

Available formats

Coresignal provides JSON and CSV formats for Self-Service and API. The CSV format is only available while using Bulk Collect endpoints.

Read more about Bulk Collect in the following articles:

Request types

All Jobs data API requests must be made over HTTPS. Requests made over HTTP will fail.

Jobs data API supports two types of requests:

  • Search endpoints support POST HTTP requests only.
  • Collect endpoints support the GET HTTP requests only.

Request type

Endpoint

Function

POST

/v2/job_base/search/filter

Search for relevant job postings using search filters

POST

/v2/job_base/search/es_dsl

Search for relevant job postings using Elasticsearch DSL schema

GET

/v2/job_base/collect/{job_id}

Collect Job posting data using IDs

Rate limits

Jobs data API endpoints restrict the number of requests allowed per second for each client's API token.

Jobs data API search endpoints

Jobs data API collection endpoints

Bulk Collect POST endpoints

Bulk Collect GET endpoints

Allow 18 requests per second.

Allow 54 requests per second.

Allow 27 requests per second.

Allow 27 requests per second.

Credits and tokens

The token issued for you has a set amount of search and collect credits.

One search credit is deducted for one successful (200) request in the search endpoints:

  • /v2/job_base/search/filter
  • /v2/job_base/search/es_dsl


One collect credit is deducted for one successful (200) request in the collection endpoint:

  • /v2/job_base/collect/{job_id}

Remember that making one Bulk Collect request will consume more credits as you get bigger data batches.

Data dictionaries and samples

Explore what data points we offer in our API jobs data: