POST Requests

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 features three POST endpoints, making collecting job data records in bulk easier.

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