Search Preview: Base Jobs API

Data type:

Query type:

URLs:

Base Jobs

Coresignal's custom filters and Elasticsearch DSL

https://api.coresignal.com/cdapi/v2/job_base/search/filter/preview https://api.coresignal.com/cdapi/v2/job_base/search/es_dsl/preview

---

Overview

Retrieve a limited set of fields from top-matching records in real time, and search suggestion features. Here, Base Jobs API search /v2/job_base/search/filter/preview and /v2/job_base/search/es_dsl/preview endpoints' usage is reviewed.

General information about search preview

Request queries

See the request examples of preview endpoints. Search Preview endpoints accept the same query structure as their corresponding Search endpoints.

Search Filter request

Search Filter request

curl -X 'POST' \
'https://api.coresignal.com/cdapi/v2/job_base/search/filter/preview' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: application/json' \
  -d '{
  "created_at_gte": "2025-08-01 00:00:00",
  "title": "Data Analyst",
  "employment_type": "Full-time"
}'

Elasticsearch DSL request

Response structure

Here is an overview of the fields that are retrieved using the Base Jobs API search preview endpoints.

Data field	Description	Data type
id	Identification key for a job posting record	Integer
created	The time and date when we first scraped the record	String
title	Job title	String
location	Job location	String
company_name	Company name	String
_score	Elasticsearch score	Float

Refer to the data example here:

All personal/company information mentioned within this context is entirely fictional and is solely intended for illustrative purposes.

Search Filter response

Search Filter response

  {
    "id": 123456789,
    "created": "2025-09-01 00:00:00",
    "title": "Data Analyst",
    "location": "New York, NY",
    "company_name": "Example Company",
    "_score": 10.1233456
  }

Elasticsearch DSL response

Pagination

Examples of the request using pagination query parameter page.

Search Filter request

Search Filter request

curl -X 'POST' \
'https://api.coresignal.com/cdapi/v2/job_base/search/filter/preview?page=3' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: application/json' \
  -d '{
  "created_at_gte": "2025-08-01 00:00:00",
  "title": "Data Analyst",
  "employment_type": "Full-time"
}'

Elasticsearch DSL request