Search Filters: Base Jobs API

Data type:

Query type:

URL:

Base Jobs

Coresignal's custom filters

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

---

Overview

Explore the available filters, their explanations, potential applications, and helpful tips for the endpoint /v2/job_base/search/filter usage.

Use this endpoint to collect deduplicated job posting IDs with relevant keywords from a global dataset. Covering major job markets worldwide, with new postings discovered continuously around the clock.

Opt for this endpoint if you prefer uncomplicated queries. Details about filter explanations and how to use them are provided below.

Endpoint structure

Full structure

{
  "created_at_gte": "string",
  "created_at_lte": "string",
  "last_updated_gte": "string",
  "last_updated_lte": "string",
  "title": "string",
  "keyword_description": "string",
  "employment_type": "string",
  "location": "string",
  "company_id": 0,
  "company_name": "string",
  "company_domain": "string",
  "company_exact_website": "string",
  "company_professional_network_url": "string",
  "deleted": true,
  "application_active": true,
  "country": "string",
  "industry": "string"
}

Filter list

Example outputs are redacted and may not contain all the fields you would receive using the endpoint.

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

created_at_gte

Filter name	Data input type	Description	Usage
created_at_gte	String (date)	Date and time when the job record was created in our database	Find job posting records based on creation date. Use the YYYY-MM-DD hh:mm:ss date format. The output value will be greater than or equal to the input value.

Example input:

created_at_gte

{
  "created_at_gte": "2025-03-23 12:21:01"
}

Example output:

Example

"created": "2025-03-02 12:21:02",
"last_updated": "2025-04-01 16:32:12",
"time_posted": "1 month ago",

created_at_lte

Filter name	Data input type	Description	Usage
created_at_lte	String (date)	Date and time when the job record was created in our database	Find job posting records based on creation date. Use the YYYY-MM-DD hh:mm:ss date format. The output value will be less than or equal to the input value.

Example input:

created_at_lte

{
  "created_at_lte": "2025-03-23 12:21:01"
}

Example output:

Example

"created": "2025-02-14 14:11:57",
"last_updated": "2025-04-05 19:51:59",
"time_posted": "2 months ago",

last_updated_gte

Filter name	Data input type	Description	Usage
last_updated_gte	String (date)	Date and time when the job posting record was updated in our database	Find job posting records based on the last update date. Use the YYYY-MM-DD hh:mm:ss date format. The output value will be greater than or equal to the input value.

Example input:

last_updated_gte

{
  "last_updated_gte": "2025-03-23 12:21:01"
}

Example output:

Example

"created": "2024-11-14 14:11:44",
"last_updated": "2025-04-10 21:22:19",

last_updated_lte

Filter name	Data input type	Description	Usage
last_updated_gte	String (date)	Date and time when the job posting record was updated in our database	Find job posting records based on the last update date. Use the YYYY-MM-DD hh:mm:ss date format. The output value will be less than or equal to the input value.

Example input:

last_updated_lte

{
  "last_updated_lte": "2025-03-23 12:21:01"
}

Example output:

Example

"created": "2024-11-14 14:11:38",
"last_updated": "2025-04-10 17:16:15",

title

Filter name	Data input type	Description	Usage
title	String	Job title	Use to find job posting records based on desired job headline (title). Available operators: AND (both keywords need to be present) OR (one of the two input values).

Example input:

No operator

{
  "title": "data analyst"
}

OR operator

{
  "title": "(data analyst) OR (data scientist)"
}

AND operator

{
  "title": "data analyst AND data scientist"
}

Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.

Example output:

Example

"title": "Data Analyst / Data Scientist",

---

Use "\"{keyword}\"" format to find exact matches.

Exact match

{
  "title": "\"product manager\""
}

keyword_description

Filter name	Data input type	Description	Usage
keyword_description	String	Keywords found in the job posting description	Use it to find job postings based on keywords. Available operators: AND (both keywords need to be present) OR (one or the other keyword is present).

Example input:

No operator

{
  "keyword_description": "python"
}

OR operator

{
  "keyword_description": "python OR (software development)"
}

AND operator

{
  "keyword_description": "python AND SQL"
}

Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.

Example output:

Example

"description": "Work as part of the data science team, support the existing team and grow with them. Work with internal and external subject matter experts to drive the product’s road map, execution plan and milestones Participate actively in implementing complex algorithms Work with large, complex datasets of various vehicular subsystems; solve difficult, non-routine analysis problems, applying advanced analytical methods as needed. Conduct end-to-end analysis that includes data gathering and requirements specification, processing, analysis, ongoing deliverables and presentations. Build and prototype analysis pipelines iteratively to provide insights at scale. Develop comprehensive understanding of vehicular systems and data and offer security-focused insights regarding anomalies in the data sets. Requirements BA degree in a quantitative discipline (e.g., statistics, bioinformatics, economics, computer science, mathematics, physics, electrical engineering, industrial engineering) or equivalent practical experience. 1-2 years of relevant work experience in data analysis or related field (e.g., as a statistician / data scientist). Experience with statistical software (e.g., R, Python, MATLAB) and database languages (e.g., SQL). Independent self-starter and team player Passionate about constantly learning new skills in a fast-paced environment MSc or PhD student in a quantitative discipline 1-2 years of directly relevant, tech industry work experience, including deep expertise and experience with statistical data analysis such as linear models, multivariate analysis, deep learning, Bayesian inference. Applied experience with machine learning and deep learning on very large datasets. Experience articulating cybersecurity goals and using mathematical techniques to arrive at an answer using available data. Experience translating analysis results into actionable information. Demonstrated skills in selecting the right statistical tools given a data analysis problem. Demonstrated effective written and verbal communication skills.",

employment_type

Filter name	Data input type	Description	Usage
employment_type	String	Employment type	Find job postings using any type of employment from the possible input values. Available operators: OR (one or the other keyword is present).

Example input:

OR operator

{
  "employment_type": "Full-time OR Part-time"
}

Possible input values can be found in general Search filters topic.

location

Filter name	Data input type	Description	Usage
location	String	Hiring (employment) location	Use it to find job posting records based on location. You can use states, cities, and countries.

Example input:

location

{
  "location": "Denver"
}

Example output:

Example

 "employment_type": "Full-time",
 "location": "Denver, CO",

company_id

Filter name	Data input type	Description	Usage
company_id	Integer	Company identification key	Find job postings from a specific company.

Example input:

company_id

{
  "company_id": 4678459
}

Example output:

Example

"company_id": 4678459,
"company_name": "Example Company",
"company_url": "https://www.professional-network.com/company/example-company",

company_exact_website

Filter name	Data input type	Description	Usage
company_exact_website	String	Exact domain of the company	Use it to find job posting records based on exact company domains. Possible URL formats: www.microsoft.com https://www.microsoft.com subdomain.microsoft.com Combine it with other filters to find job postings posted by a specific company (e.g., company_name).

Example input:

company_exact_website

{
  "company_exact_website": "https://company.com"
}

Example output:

Example

"company_id": 4678459,
"company_name": "Example Company",
"company_url": "https://www.professional-network.com/company/example-company"

company_professional_network_url

Filter name	Data input type	Description	Usage
company_professional_network_url	String	Company's profile on Professional Network	Find job postings using URLs of company profiles. Only the Professional Network company profile URL is accepted.

Example input:

company_professional_network_url

{
  "company_professional_network_url": "https://www.professional-network.com/company/example-company"
}

Example output:

Example

"url": "https://www.professional-network.com/jobs/view/information-technology-recruiter-at-example-company-3386002074",
"hash": "9a17b591b822509c096f8422d40a70b8",
"company_id": 2887846,
"company_name": "Example Company",
"company_url": "https://www.professional-network.com/company/tesla",

deleted

Filter name	Data input type	Description	Usage
deleted	String	Marks record's public availability	Use it to include historical job posting records in your search (true) or to filter them out to see only records of active job postings (false).

Example input:

true

{
  "deleted": true
}

false

{
  "deleted": false
}

Example output:

deleted: 0

 "deleted": 0,

How does the deleted field work?

Field	Explanation
deleted	Marks if the record is still publicly available: "deleted": 0 – the record can be seen publicly "deleted": 1 – the record was unavailable at the time of scraping (deleted or made private).

application_active

Filter name	Data input type	Description	Usage
application_active	Boolean	Marks whether the job ad is still active on the Professional Network	Use it to include active job posting records in your search (true) or historical/inactive job posting records (false).

Example input:

true

{
  "application_active": true
}

false

{
  "application_active": false
}

Example output:

application active: 0

"application_active": 0,

Data field application_active has one of two possible values:

0 – the last time we scraped the job posting, the job posting was no longer available

1 – as of the last time the job posting was scraped, the job posting was still active on the professional network

country

Filter name	Data input type	Description	Usage
country	String	Country the employer is hiring in (as parsed by Coresignal’s in-house country parser)	Filter our job posting records based on the job/employer location from the possible input values. Available operators: OR (one of the two input values).

Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.

Example input:

{
  "country": "(United Kingdom) OR Germany"
}

Possible input values can be found in general Search filters topic.

Industry

Filter name	Data input type	Description	Usage
industry	String	Associated industry	Filter out job posting records based on the associated industry. Available operators: AND (both of the input values need to be present) OR (one of the two input values).

Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.

Example input:

{
  "industry": "(Information technology) OR Internet"
}

Possible input values can be found in general Search filters topic.

---

Use "\"{keyword}\"" format to find exact matches.

Exact match

{
  "industry":  "\Information technology\""
}

Sample request

Request example

curl -X POST "https://api.coresignal.com/cdapi/v2/job_base/search/filter" 
-H  "accept: application/json" 
-H  "apikey: {API Key}" 
-H  "Content-Type: application/json" 
-d "{
  "last_updated_gte": "2025-05-26 00:00:01",
  "employment_type": "full-time"
}