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

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

circle-info

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.

chevron-rightcreated_at_gtehashtag
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:

Example output:

chevron-rightcreated_at_ltehashtag
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:

Example output:

chevron-rightlast_updated_gtehashtag
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:

Example output:

chevron-rightlast_updated_ltehashtag
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:

Example output:

chevron-righttitlehashtag
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:

circle-check

Example output:


circle-check
chevron-rightkeyword_descriptionhashtag
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:

circle-check

Example output:

chevron-rightemployment_typehashtag
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:

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

chevron-rightlocationhashtag
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:

Example output:

chevron-rightcompany_idhashtag
Filter name
Data input type
Description
Usage

company_id

Integer

Company identification key

Find job postings from a specific company.

Example input:

Example output:

chevron-rightcompany_exact_websitehashtag
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:

Example output:

chevron-rightcompany_professional_network_urlhashtag
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:

Example output:

chevron-rightdeletedhashtag
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:

Example output:

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).

chevron-rightapplication_activehashtag
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:

Example output:

circle-info

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

chevron-rightcountryhashtag
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).

circle-check

Example input:

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

chevron-rightIndustryhashtag
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).

circle-check

Example input:

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


circle-info

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

Last updated

Was this helpful?