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

Optimized Vector Embeddings & Search
Query behavior changes for application_url, title, and location filters
Added Role Taxonomy Tags Endpoint + Job Role Filters
Added salary estimates + global currency conversion API endpoint
New location, ID fields and filters
GeoNames upgrade, new population field and filters, expired field now in job results
Added application URL query filter + (multi) country code parameter enhancements
Improved API query validation
Added source/ATS and company filtering + source ID fields
Added Remote Work Mode Classification
Full job data downloads now available!
Added API Access Lite Plan + Smarter Age-Window Defaults for Jobs API
Change of length for job title and location fields
Added `ext_id` filtering to Jobs API + normalized future publish timestamps
Jobs API query scope limits for more reliable large requests
Maximum value for "page_size" parameter increased to 5000
jobdataapi.com now has Changelog section 🎉
API access key management upgrades + company timestamps in Companies API
Added plain-text field for cleaned job description
Added company flag for recruiting/staffing firms + enhanced filtering options

Explore jobdata API with AI tools

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