jobdata

Enhanced multi-value parameters for Job and Company queries

jobdataapi.com v4.12 / API version 1.14

1 min read · March 4, 2025
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

New location, ID fields and filters
Full job data downloads now available!
Added new Job States (geo) endpoint, query filters, and more
Added company website/domain filter to jobs endpoint
Added company open/total job counts + filters
Maximum value for "page_size" parameter increased to 5000
Removal of clearance_required field from job result structure
Improved Job States (geo) search, Markdown job descriptions, and lean data retrieval
GeoNames upgrade, new population field and filters, expired field now in job results
Added company flag for recruiting/staffing firms + enhanced filtering options
Added application URL query filter + (multi) country code parameter enhancements
Optimized Vector Embeddings & Search
Introducing Vector Embeddings and Vector Search in the jobdata API
jobdataapi.com now has Changelog section 🎉
Added plain-text field for cleaned job description
Change of length for job title and location fields