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

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