Search Filters Pagination: Base Jobs API

Overview

General information about the pagination is listed in Results Pagination topic.

Pagination is essential when working with Base Jobs API – the dataset spans global job markets with records going back to August 2020, which means result sets for broad queries can be large and frequently changing.

Here you can find:

Pagination using cURL requests

Examples of pagination usage with cURL requests.

Using pagination in cURL requests

This tutorial requires prior knowledge of how to compile and execute POST requests in Base Jobs API.

Use parameter x-next-page-after to retrieve a second page of of deduplicated job postings IDs.

1. Navigate to the Headers section and click it:

1. Find the following information: – x-next-page-after – x-total-pages – x-total-results

2. Add parameter ?after={x-next-page-after} to the POST request to see the next results page:

Pagination example

curl -X 'POST' \
  'https://api.coresignal.com/cdapi/v2/job_base/search/filter?after="2025-03-19 13:39:50",340784135' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: application/json' \
  -d '{
  "last_updated_gte": "2022-05-26 00:00:01",
  "employment_type": "full-time", 
  "company_domain": "example-company.com"
}'

1. Execute the request, and you will see the next page in the Body section:

[
1000,
1001,
3000,
4004
]

Limiting search results per page

Query parameter ?items_per_page={int} allows you to specify the number of results retrieved per Search results page. The current limit is 1,000. Thus, this parameter lets you set a smaller limit value for the results page.

Items per page

curl -X 'POST' \
  'https://api.coresignal.com/cdapi/v2/job_base/search/filter?items_per_page=100' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: application/json' \
  -d '{
  "last_updated_gte": "2022-05-26 00:00:01",
  "employment_type": "full-time", 
  "company_domain": "example-company.com"
}'