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

Added application URL query filter + (multi) country code parameter enhancements
Added company flag for recruiting/staffing firms + enhanced filtering options
Maximum value for "page_size" parameter increased to 5000
Full job data downloads now available!
Change of length for job title and location fields
jobdataapi.com now has Changelog section 🎉
Added company open/total job counts + filters
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 plain-text field for cleaned job description
Added new Job States (geo) endpoint, query filters, and more
Removal of clearance_required field from job result structure
Added company website/domain filter to jobs endpoint
New location, ID fields and filters