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

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