POST Requests: Base Jobs API

Data type:

URLs:

Base Jobs

https://api.coresignal.com/cdapi/v2/data_requests/job_base/filter https://api.coresignal.com/cdapi/v2/data_requests/job_base/id_file

---

Overview

Bulk Collect offers two POST endpoints that simplify large-scale collection of job data records. Each request draws from a deduplicated, globally sourced dataset that covers major job markets worldwide. Active postings are revisited within 24 hours, ensuring that bulk exports capture both the complete historical archive and near-real-time status.

Before you proceed with your Bulk Collect requests, test them in the Jobs data API first to avoid any unexpected costs.

Find step-by-step guides for making Bulk Collect POST requests in the following topic:

Bulk Collect POST requests guides

Search filter requests

Base Jobs API Search filters list

Use the endpoint /v2/data_requests/job_base/filter to request job posting data in bulk using search filters.

Endpoint usage example

Keep in mind that parameters webhook_url and limit are optional.

Example request

curl -X 'POST' \
  'https://api.coresignal.com/cdapi/v2/data_requests/job_base/filter' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: application/json' \
  -d '{
   "webhook_url": "{optional_webhook_url}",
   "limit": {optional_integer},
   "filters": { 
               "created_at_gte": "2023-05-01 00:00:01",
               "created_at_lte": "2023-05-07 00:00:01",
               "company_professional_network_url": "https://www.professional_network.com/company/thermo-fisher-scientific"
             }
}'

• Retrieve the request ID from the response body:

Request ID

{
  "request_id": "433869ec-0a98-4dcd-9b13-db4df58260f5"
}

• Location response header provides a URL where the results can be retrieved.

Location: /v2/data_requests/e000b0ec-0f00-0b00-0a0a-0b00fa0000d0/files

---

ID File requests

Use the endpoint /v2/data_requests/job_base/id_file to submit a list of IDs in a CSV or TXT file to request job posting data in bulk. Check the example for the IDs file request:

ID File request guide

Endpoint usage example

cURL request

curl -X 'POST' \
  'https://api.coresignal.com/cdapi/v2/data_requests/job_base/id_file' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: multipart/form-data' \
  -F 'ids_file=@id_list_example.csv;type=text/csv' \
  -F 'webhook_url={optional_webhook_url}'

• Retrieve the request_id from the response body:

Request ID

{
  "request_id": "433869ec-0a98-4dcd-9b13-db4df58260f5"
}

• Location response header provides a URL where the results can be retrieved.

Location: /v2/data_requests/e000b0ec-0f00-0b00-0a0a-0b00fa0000d0/files

---

Following steps

Make GET requests to download the data