Jobs Data API

Endpoints

Search Filters

12min

Data type: Jobs
Query type: Coresignal's custom filters
URL: /v1/professional_network/job/search/filter.
Explore the available filters, their explanations, potential applications, and helpful tips for the endpoint /v1​/professional_network/job/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"
}
{
  "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.
﻿Response codes﻿
See the list of possible error codes. 
﻿Request examples﻿
Test out the endpoint with suggested examples.
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": "2021-06-26 12:21:01"
}
{
  "created_at_gte": "2021-06-26 12:21:01"
}
﻿
Example output:
Example
"created": "2021-06-26 12:21:02",
"last_updated": "2021-08-24 16:32:12",
"time_posted": "1 month ago",
"created": "2021-06-26 12:21:02",
"last_updated": "2021-08-24 16:32:12",
"time_posted": "1 month ago",
﻿
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": "2021-06-26 12:21:01"
}
{
  "created_at_lte": "2021-06-26 12:21:01"
}
﻿
Example output:
Example
"created": "2020-08-14 14:11:57",
"last_updated": "2021-01-25 19:51:59",
"time_posted": "2 months ago",
"created": "2020-08-14 14:11:57",
"last_updated": "2021-01-25 19:51:59",
"time_posted": "2 months ago",
﻿
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.
last_updated_gte
{
  "last_updated_gte": "2021-06-26 12:21:01"
}
{
  "last_updated_gte": "2021-06-26 12:21:01"
}
﻿
Example output:
Example
"created": "2020-08-14 14:11:44",
"last_updated": "2023-04-29 21:22:19",
"created": "2020-08-14 14:11:44",
"last_updated": "2023-04-29 21:22:19",
﻿
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": "2021-06-26 12:21:01"
}
{
  "last_updated_lte": "2021-06-26 12:21:01"
}
﻿
Example output:
Example
"created": "2020-08-14 14:11:38",
"last_updated": "2020-11-17 17:16:15",
"created": "2020-08-14 14:11:38",
"last_updated": "2020-11-17 17:16:15",
﻿
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
OR operator
AND operator
{
  "title": "data analyst"
}
{
  "title": "data analyst"
}
﻿
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",
"title": "Data Analyst / Data Scientist",
﻿
﻿
Use "\"{keyword}\"" format to find exact matches.
Exact match
{
  "title": "\"product manager\""
}
{
  "title": "\"product manager\""
}
﻿
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
OR operator
AND operator
{
  "keyword_description": "python OR (software development)"
}
{
  "keyword_description": "python OR (software development)"
}
﻿
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.",
"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.",
﻿
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"
}
{
  "employment_type": "Full-time OR Part-time"
}
﻿
Possible input values:
Employment type list
"Full-time"
"Part-time"
"Contract"
"Internship"
"Temporary"
"Volunteer"
"Other"
"Full-time"
"Part-time"
"Contract"
"Internship"
"Temporary"
"Volunteer"
"Other"
﻿
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"
}
{
  "location": "Denver"
}
﻿
 Example output:
Example
 "employment_type": "Full-time",
 "location": "Denver, CO",
 "employment_type": "Full-time",
 "location": "Denver, CO",
﻿
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
}
{
  "company_id": 4678459
}
﻿
Example output:
Example
"company_id": 4678459,
"company_name": "Example Company",
"company_url": "https://www.professional-network.com/company/example-company",
"company_id": 4678459,
"company_name": "Example Company",
"company_url": "https://www.professional-network.com/company/example-company",
﻿
Filter name
Data input type
Description
experience_company_website_url
String
Company's web domain
Usage
Use it to find job records based on the company's web domain.

Possible URL formats include:

microsoft.com

subdomain.microsoft.com

www.microsoft.com

https://www.microsoft.com 

Any other format will return no results, even though your query will be shown as successful (200 response code).

Combine it with other filters to find job postings posted by a specific company (e.g., company_name).
Example input:
experience_company_website_url
{
  "experience_company_website_url": "https://www.company.com"
}
{
  "experience_company_website_url": "https://www.company.com"
}
﻿
Example output:
Example
"company_name": "company",
"company_url": "https://www.professional-network.com/company/company",
"company_name": "company",
"company_url": "https://www.professional-network.com/company/company",
﻿
Filter name
Data input type
Description
company_exact_website
String
Exact domain of the company
Usage
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

Any other formats will return no results, even though your query will be shown as successful (200 response code).

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"
}
{
  "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_id": 4678459,
"company_name": "Example Company",
"company_url": "https://www.professional-network.com/company/example-company"
﻿
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"
}
{
  "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",
"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",
﻿
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 only to see records of active job postings (false).
Example input:
true
false
{
  "deleted": false
}
{
  "deleted": false
}
﻿
Example output:
deleted: 0
deleted: 1
 "deleted": 1,
 "deleted": 1,
﻿
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). 
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
false
{
  "application_active": false
}
{
  "application_active": false
}
﻿
Example output:
application_active: 0
application_active: 1
"application_active": 1,
"application_active": 1,
﻿
Data point application_active has one of two possible values - 1 or 0.

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
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. 
Phrases
{
  "country": "(United Kingdom) OR Germany"
}
{
  "country": "(United Kingdom) OR Germany"
}
﻿
Possible input values:
dist_job_countries.txt
﻿
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. 
Phrases
{
  "industry": "(Information technology) OR Internet"
}
{
  "industry": "(Information technology) OR Internet"
}
﻿
﻿
Use "\"{keyword}\"" format to find exact matches.
Exact match
{
  "title":  "\Information technology\""
}
{
  "title":  "\Information technology\""
}
﻿
﻿
﻿
﻿
﻿
﻿

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.

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.

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.

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.

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

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

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

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.

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

Filter name	Data input type	Description
experience_company_website_url	String	Company's web domain

Usage
Use it to find job records based on the company's web domain. Possible URL formats include: microsoft.com subdomain.microsoft.com www.microsoft.com https://www.microsoft.com Any other format will return no results, even though your query will be shown as successful (200 response code). Combine it with other filters to find job postings posted by a specific company (e.g., company_name).

Filter name	Data input type	Description
company_exact_website	String	Exact domain of the company

Usage
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 Any other formats will return no results, even though your query will be shown as successful (200 response code). Combine it with other filters to find job postings posted by a specific company (e.g., company_name).

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.

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 only to see records of active job postings (false).

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

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

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

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

Updated 29 Aug 2024

Did this page help you?

Endpoints

Pagination

Search Filters

Overview

Endpoint structure

Filter list

Response codes

Request examples

Created_at_gte

Created_at_lte

Last_updated_gte

Last_updated_lte

Title

Keyword_description

Employment_type

Location

Company_id

Experience_company_website_url

Company_exact_website

Company_professional_network_url

Deleted

How does the deleted field work?

Application_active

Country

Industry

Search Filters

Overview

Endpoint structure

Filter list

﻿Response codes﻿

﻿Request examples﻿

Created_at_gte

Created_at_lte

Last_updated_gte

Last_updated_lte

Title

Keyword_description

Employment_type

Location

Company_id

Experience_company_website_url

Company_exact_website

Company_professional_network_url

Deleted

How does the deleted field work?

Application_active

Country

Industry

Response codes

Request examples