# POST Requests: Base Jobs API

{% columns %}
{% column width="16.666666666666664%" %}
Data type:

URLs:
{% endcolumn %}

{% column %}
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>
{% endcolumn %}
{% endcolumns %}

***

## Overview

Bulk Collect features three POST endpoints, making collecting job data records in bulk easier.

{% hint style="danger" %}
Before you proceed with your Bulk Collect requests, test them in the Jobs data API first to avoid any unexpected costs.
{% endhint %}

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

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Bulk Collect POST requests guides</td><td><a href="../../../../api-introduction/requests/bulk-collect/post-requests">post-requests</a></td></tr></tbody></table>

## Search filter requests

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Base Jobs API Search filters list</td><td><a href="../search-filters">search-filters</a></td></tr></tbody></table>

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

### Endpoint usage example

{% hint style="info" %}
Keep in mind that parameters `webhook_url` and `limit` are **optional.**
{% endhint %}

{% code title="Example request" %}

```json
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"
             }
}'
```

{% endcode %}

* Retrieve the `request ID` from the response body:

{% code title="Request ID" %}

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

{% endcode %}

* `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:

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>ID File request guide</td><td><a href="../../../../../api-introduction/requests/bulk-collect/post-requests#id-file-requests">#id-file-requests</a></td></tr></tbody></table>

### Endpoint usage example

{% code title="cURL request" %}

```json
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}'
```

{% endcode %}

* Retrieve the `request_id` from the response body:

{% code title="Request ID" %}

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

{% endcode %}

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

> Location: /v2/data\_requests/e000b0ec-0f00-0b00-0a0a-0b00fa0000d0/files

***

## Following steps

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Make GET requests to download the data</td><td><a href="../../../../api-introduction/requests/bulk-collect/get-requests">get-requests</a></td></tr></tbody></table>