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 job posting IDs with relevant keywords.
Opt for this endpoint if you prefer uncomplicated queries. Details about filter explanations and how to use them are provided below.
Endpoint 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
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:
Example output:
created_at_lte
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:
Example output:
last_updated_gte
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:
Example output:
last_updated_lte
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:
Example output:
title
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:
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
Example output:
Use "\"{keyword}\"" format to find exact matches.
keyword_description
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:
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
Example output:
employment_type
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:
Possible input values can be found in general Search filters topic.
location
location
String
Hiring (employment) location
Use it to find job posting records based on location. You can use states, cities, and countries.
Example input:
Example output:
company_id
company_id
Integer
Company identification key
Find job postings from a specific company.
Example input:
Example output:
company_exact_website
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:
Example output:
company_professional_network_url
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:
Example output:
deleted
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:
Example output:
How does the deleted field work?
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
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:
Example output:
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
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:
Possible input values can be found in general Search filters topic.
Industry
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:
Possible input values can be found in general Search filters topic.
Use "\"{keyword}\"" format to find exact matches.
Last updated
Was this helpful?