jobdata

Enhanced multi-value parameters for Job and Company queries

jobdataapi.com v4.12 / API version 1.14

1 min read · March 4, 2025 · Markdown version
Table of contents

We significantly enhanced the functionality of our multi-value parameters, providing you with even greater flexibility and precision when querying job, expired job, and company data.

Key Enhancements

  • Expanded multi-value parameters: You can now utilize additional multi-value parameters across the /api/jobs/, /api/jobsexpired/, and /api/companies/ endpoints. This enhancement allows for more complex queries and combining multiple criteria seamlessly.

  • Improved inclusion and exclusion logic: The logic for including and excluding values has been refined. You can now specify multiple values for parameters such as company_type_id, industry_id, and type_id using the pipe (|) character for inclusion, and prefixing with a minus sign (-) for exclusion. This allows for more tailored searches, such as filtering jobs from specific industries while excluding certain job types.

  • Multi-keyword support for more query parameters: The name, description, and specialty parameters in the /api/companies/ endpoint as well as the application_url parameter in the /api/jobs/ and /api/jobsexpired/ endpoints now also support multi-keyword searches. Users can combine keywords using the |OR| operator, making it easier to find jobs and companies that match a variety of criteria.

Example Usage

To retrieve jobs from multiple job types while excluding specific ones:

https://jobdataapi.com/api/jobs/?type_id=1|2|-3|-4

To find jobs with titles containing either Data Engineer or Data Scientist while excluding those with Azure or Power BI:

https://jobdataapi.com/api/jobs/?title=data engineer|OR|data scientist|OR|-azure|OR|-power bi

For more detailed information on how to utilize these new features, please refer to the Multi-value Parameters Documentation. You'll also now see hints added to each parameter that supports multi-value filters in the API endpoint docs.

Related Docs

Added application URL query filter + (multi) country code parameter enhancements
Job filtering by vector embedding now available + added Apprenticeship job type
GeoNames upgrade, new population field and filters, expired field now in job results
Improved API query validation
Geo radius search expansion for Jobs API location filters
New Jobs Deleted API Endpoint for Data Synchronization
Maximum value for "page_size" parameter increased to 5000
Added default date window for Expired Jobs
Added Remote Work Mode Classification
Added source/ATS and company filtering + source ID fields
Annualized job downloads + denormalized Parquet export
API page-size maximum reduced to 4000
Added company website/domain filter to jobs endpoint
Added salary estimates and converted values + location_string to download CSVs
Added plain-text field for cleaned job description
API access key management upgrades + company timestamps in Companies API
Removal of clearance_required field from job result structure
Change of length for job title and location fields
Added company open/total job counts + filters
New location, ID fields and filters

Explore jobdata API with AI tools

Ask an AI assistant how to search and build with live job data.