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

Added llms.txt and llms-full.txt for AI-friendly implementation guidance
Added salary estimates + global currency conversion API endpoint
Added salary estimates and converted values + location_string to download CSVs
Added API Access Lite Plan + Smarter Age-Window Defaults for Jobs API
Improved API query validation
Introducing Vector Embeddings and Vector Search in the jobdata API
Added YouTube links to company profiles
Annualized job downloads + denormalized Parquet export
GeoNames upgrade, new population field and filters, expired field now in job results
Added `ext_id` filtering to Jobs API + normalized future publish timestamps
Job filtering by vector embedding now available + added Apprenticeship job type
Enhanced Company HQ Data + new Geographic Filters
Maximum value for "page_size" parameter increased to 5000
API access key management upgrades + company timestamps in Companies API
Added new Job States (geo) endpoint, query filters, and more
Full job data downloads now available!
Geo radius search expansion for Jobs API location filters
Added company open/total job counts + filters
Improved Job States (geo) search, Markdown job descriptions, and lean data retrieval
Added plain-text field for cleaned job description

Explore jobdata API with AI tools

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