# Search Filters: Base Jobs API

{% columns %}
{% column width="16.666666666666664%" %}
Data type:

Query type:

URL:
{% endcolumn %}

{% column %}
Base Jobs

Coresignal's custom filters

<https://api.coresignal.com/cdapi/v2/job\\_base/search/filter>
{% endcolumn %}
{% endcolumns %}

***

## 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

{% code title="Full structure" %}

```json
{
  "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"
}
```

{% endcode %}

## Filter list

{% hint style="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.
{% endhint %}

<details>

<summary>created_at_gte</summary>

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

**Example input:**

{% code title="created\_at\_gte" %}

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

{% endcode %}

**Example output:**

{% code title="Example" %}

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

{% endcode %}

</details>

<details>

<summary>created_at_lte</summary>

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

**Example input:**

{% code title="created\_at\_lte" %}

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

{% endcode %}

**Example output:**

{% code title="Example" %}

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

{% endcode %}

</details>

<details>

<summary>last_updated_gte</summary>

| 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 | <p>Find job posting records based on the last update date.<br>Use the <code>YYYY-MM-DD hh:mm:ss</code> date format.<br>The output value will be greater than or equal to the input value.</p> |

**Example input:**

{% code title="last\_updated\_gte" %}

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

{% endcode %}

**Example output:**

{% code title="Example" %}

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

{% endcode %}

</details>

<details>

<summary>last_updated_lte</summary>

| 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 | <p>Find job posting records based on the last update date.<br>Use the <code>YYYY-MM-DD hh:mm:ss</code> date format.<br>The output value will be less than or equal to the input value.</p> |

**Example input:**

{% code title="last\_updated\_lte" %}

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

{% endcode %}

**Example output:**

{% code title="Example" %}

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

{% endcode %}

</details>

<details>

<summary>title</summary>

| Filter name | Data input type | Description | Usage                                                                                                                                                                                                                             |
| ----------- | --------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `title`     | String          | Job title   | <p>Use to find job posting records based on desired job headline (title).<br>Available operators:</p><ul><li><code>AND</code> (both keywords need to be present)</li><li><code>OR</code> (one of the two input values).</li></ul> |

**Example input:**

{% code title="No operator" %}

```json
{
  "title": "data analyst"
}
```

{% endcode %}

{% code title="OR operator" %}

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

{% endcode %}

{% code title="AND operator" %}

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

{% endcode %}

{% hint style="success" %}
Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together.
{% endhint %}

**Example output:**

{% code title="Example" %}

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

{% endcode %}

***

{% hint style="success" %}
Use `"\"{keyword}\""` format to find exact matches.
{% endhint %}

{% code title="Exact match" %}

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

{% endcode %}

</details>

<details>

<summary>keyword_description</summary>

| Filter name           | Data input type | Description                                   | Usage                                                                                                                                                                                                             |
| --------------------- | --------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `keyword_description` | String          | Keywords found in the job posting description | <p>Use it to find job postings based on keywords.<br>Available operators:</p><ul><li><code>AND</code> (both keywords need to be present)</li><li><code>OR</code> (one or the other keyword is present).</li></ul> |

**Example input:**

{% code title="No operator" %}

```json
{
  "keyword_description": "python"
}
```

{% endcode %}

{% code title="OR operator" %}

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

{% endcode %}

{% code title="AND operator" %}

```json
{
  "keyword_description": "python AND SQL"
}
```

{% endcode %}

{% hint style="success" %}
Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together.
{% endhint %}

**Example output:**

{% code title="Example" %}

```json
"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.",
```

{% endcode %}

</details>

<details>

<summary>employment_type</summary>

| Filter name       | Data input type | Description     | Usage                                                                                                                                                                                 |
| ----------------- | --------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `employment_type` | String          | Employment type | <p>Find job postings using any type of employment from the possible input values.<br>Available operators:</p><ul><li><code>OR</code> (one or the other keyword is present).</li></ul> |

**Example input:**

{% code title="OR operator" %}

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

{% endcode %}

Possible input values can be found in general [Search filters](https://docs.coresignal.com/api-introduction/requests/search-filters#possible-input-values) topic.

</details>

<details>

<summary>location</summary>

| Filter name | Data input type | Description                  | Usage                                                                                                                                                         |
| ----------- | --------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `location`  | String          | Hiring (employment) location | <p>Use it to find job posting records based on location.<br>You can use <strong>states</strong>, <strong>cities</strong>, and <strong>countries</strong>.</p> |

**Example input:**

{% code title="location" %}

```json
{
  "location": "Denver"
}
```

{% endcode %}

**Example output:**

{% code title="Example" %}

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

{% endcode %}

</details>

<details>

<summary>company_id</summary>

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

**Example input:**

{% code title="company\_id" %}

```json
{
  "company_id": 4678459
}
```

{% endcode %}

**Example output:**

{% code title="Example" %}

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

{% endcode %}

</details>

<details>

<summary>company_exact_website</summary>

| Filter name             | Data input type | Description                 | Usage                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------- | --------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `company_exact_website` | String          | Exact domain of the company | <p>Use it to find job posting records based on exact company domains.<br>Possible URL formats:</p><p><code>[www.microsoft.com](http://www.microsoft.com)</code></p><p><code><https://www.microsoft.com></code></p><p><code>subdomain.microsoft.com</code><br>Combine it with other filters to find job postings posted by a specific company (e.g., <code>company\_name</code>).</p> |

**Example input:**

{% code title="company\_exact\_website" %}

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

{% endcode %}

**Example output:**

{% code title="Example" %}

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

{% endcode %}

</details>

<details>

<summary>company_professional_network_url</summary>

| Filter name                        | Data input type | Description                               | Usage                                                                                                                      |
| ---------------------------------- | --------------- | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `company_professional_network_url` | String          | Company's profile on Professional Network | <p>Find job postings using URLs of company profiles.<br>Only the Professional Network company profile URL is accepted.</p> |

**Example input:**

{% code title="company\_professional\_network\_url" overflow="wrap" %}

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

{% endcode %}

**Example output:**

{% code title="Example" %}

```json
"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",
```

{% endcode %}

</details>

<details>

<summary>deleted</summary>

| 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:**

{% code title="true" %}

```json
{
  "deleted": true
}
```

{% endcode %}

{% code title="false" %}

```json
{
  "deleted": false
}
```

{% endcode %}

**Example output:**

{% code title="deleted: 0" %}

```json
 "deleted": 0,
```

{% endcode %}

**How does the** `deleted` **field work?**

| Field     | Explanation                                                                                                                                                                                                                               |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `deleted` | <p>Marks if the record is still publicly available:</p><p><code>"deleted": 0</code> – the record can be seen publicly</p><p><code>"deleted": 1</code> – the record was unavailable at the time of scraping (deleted or made private).</p> |

</details>

<details>

<summary>application_active</summary>

| 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:**

{% code title="true" %}

```json
{
  "application_active": true
}
```

{% endcode %}

{% code title="false" %}

```json
{
  "application_active": false
}
```

{% endcode %}

**Example output:**

{% code title="application active: 0" %}

```json
"application_active": 0,
```

{% endcode %}

{% hint style="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
{% endhint %}

</details>

<details>

<summary>country</summary>

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

{% hint style="success" %}
Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together.
{% endhint %}

**Example input:**

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

Possible input values can be found in general [Search filters](https://docs.coresignal.com/api-introduction/requests/search-filters#possible-input-values) topic.

</details>

<details>

<summary>Industry</summary>

| Filter name | Data input type | Description         | Usage                                                                                                                                                                                                                                  |
| ----------- | --------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `industry`  | String          | Associated industry | <p>Filter out job posting records based on the associated industry.<br>Available operators:</p><ul><li><code>AND</code> (both of the input values need to be present)</li><li><code>OR</code> (one of the two input values).</li></ul> |

{% hint style="success" %}
Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together.
{% endhint %}

**Example input:**

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

Possible input values can be found in general [Search filters](https://docs.coresignal.com/api-introduction/requests/search-filters#possible-input-values) topic.

***

{% hint style="info" %}
Use `"\"{keyword}\""` format to find exact matches.
{% endhint %}

{% code title="Exact match" %}

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

{% endcode %}

</details>