Enhanced multi-value parameters for Job and Company queries
jobdataapi.com v4.12 / API version 1.14
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, andtype_idusing 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, andspecialtyparameters in the/api/companies/endpoint as well as theapplication_urlparameter 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
Annualized job downloads + denormalized Parquet export
Added company open/total job counts + filters
Added source/ATS and company filtering + source ID fields
Added salary estimates and converted values + location_string to download CSVs
Job filtering by vector embedding now available + added Apprenticeship job type
New location, ID fields and filters
Added Remote Work Mode Classification
Added API Access Lite Plan + Smarter Age-Window Defaults for Jobs API
Added YouTube links to company profiles
Added company website/domain filter to jobs endpoint
Added plain-text field for cleaned job description
Geo radius search expansion for Jobs API location filters
Added Role Taxonomy Tags Endpoint + Job Role Filters
Added salary estimates + global currency conversion API endpoint
Removal of clearance_required field from job result structure
Added new Job States (geo) endpoint, query filters, and more
jobdataapi.com now has Changelog section 🎉
Added company flag for recruiting/staffing firms + enhanced filtering options
Enhanced Company HQ Data + new Geographic Filters
Explore jobdata API with AI tools
Ask an AI assistant how to search and build with live job data.