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
Enhanced Company HQ Data + new Geographic Filters
Added llms.txt and llms-full.txt for AI-friendly implementation guidance
Improved job description handling and upcoming plain-text field removal
API access key management upgrades + company timestamps in Companies API
Added company website/domain filter to jobs endpoint
Removal of clearance_required field from job result structure
Optimized Vector Embeddings & Search
Query behavior changes for application_url, title, and location filters
Added salary estimates and converted values + location_string to download CSVs
Job filtering by vector embedding now available + added Apprenticeship job type
Added salary estimates + global currency conversion API endpoint
Added YouTube links to company profiles
New location, ID fields and filters
Improved Job States (geo) search, Markdown job descriptions, and lean data retrieval
Full job data downloads now available!
Maximum value for "page_size" parameter increased to 5000
Added source/ATS and company filtering + source ID fields
Added company open/total job counts + filters
Improved API query validation
New Jobs Deleted API Endpoint for Data Synchronization
Explore jobdata API with AI tools
Ask an AI assistant how to search and build with live job data.