jobdata

Query behavior changes for application_url, title, and location filters

jobdataapi.com 4.18.22 / API version 1.21

0 min read · Dec. 24, 2025
Table of contents

Multi-keyword queries removed for application_url

Support for multi-keyword ([mk]) queries on the application_url filter parameter has been removed effective immediately. As a result, queries using application_url as a filter parameter are no longer supported in multi-keyword mode on the following endpoints:

/api/jobs/ (see docs)

/api/jobsexpired/ (see docs)

Single-value filtering on application_url remains unchanged. Any existing queries relying on [mk] behavior for this parameter should be updated accordingly.

Minimum query length enforced for title and location

Queries using the title= or location= filter parameters on the /api/jobs/ endpoint now require a minimum keyword length of 3 characters. This change is due to these filters operating on a trigram-based index. Any title or location query containing keywords shorter than 3 characters will be ignored, including when used in multi-keyword [mk] mode.

We recommend adjusting client-side validation or query builders to enforce this minimum length to avoid unexpected results.

Related Docs

Removal of clearance_required field from job result structure
Introducing Vector Embeddings and Vector Search in the jobdata API
Enhanced Company HQ Data + new Geographic Filters
Maximum value for "page_size" parameter increased to 5000
Added plain-text field for cleaned job description
Added application URL query filter + (multi) country code parameter enhancements
Added salary estimates and converted values + location_string to download CSVs
New location, ID fields and filters
Added new Job States (geo) endpoint, query filters, and more
Added company flag for recruiting/staffing firms + enhanced filtering options
Added salary estimates + global currency conversion API endpoint
Full job data downloads now available!
GeoNames upgrade, new population field and filters, expired field now in job results
Added llms.txt and llms-full.txt for AI-friendly implementation guidance
Optimized Vector Embeddings & Search
jobdataapi.com now has Changelog section 🎉
Job filtering by vector embedding now available + added Apprenticeship job type
Improved Job States (geo) search, Markdown job descriptions, and lean data retrieval
Added company open/total job counts + filters
Added company website/domain filter to jobs endpoint