Pagination

Overview

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

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 Company API.

Use parameter x-next-page-after to retrieve a second page of 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/company_base/search/filter?after="2025-03-17 13:23:06",4680650' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: application/json' \
  -d '{
  "industry": "Software Development",
  "country": "United States",
  "founded_year_lte": 2022
}'

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/company_base/search/filter?items_per_page=20' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: application/json' \
  -d '{
  "industry": "Analyst",
  "country": "Germany",
  "founded_year_lte": 2023
}'