Jobs API query scope limits for more reliable large requests

jobdataapi.com v4.35 / API version 1.35

0 min read · Sept. 12, 2026 · Markdown version

Starting September 20, 2026, the /api/jobs/ endpoint will reject query shapes that could require excessively broad database work. Effective published-date ranges are limited to 365 days, and explicit min_id / max_id ranges are limited to 10,000,000 IDs, calculated inclusively.

Date and ID limits are checked independently. For example, adding max_age=180 does not allow an ID range wider than 10,000,000. Unbounded historical requests such as max_age=off must include a safe date or bounded ID scope. Requests that exceed these limits return 400 Bad Request.

These limits improve responsiveness and reduce wasted database resources as the job database continues to grow. See the Date, ID, and Age Slicing Parameters Documentation for migration guidance and examples.

Related Docs

Improved job description handling and upcoming plain-text field removal
More precise work mode and remote classification
New location, ID fields and filters
Added company flag for recruiting/staffing firms + enhanced filtering options
jobdataapi.com now has Changelog section 🎉
Improved API query validation
Change of length for job title and location fields
Added application URL query filter + (multi) country code parameter enhancements
Added `ext_id` filtering to Jobs API + normalized future publish timestamps
Added salary estimates and converted values + location_string to download CSVs
Enhanced multi-value parameters for Job and Company queries
Added default date window for Expired Jobs
Query behavior changes for application_url, title, and location filters
Added plain-text field for cleaned job description
Maximum value for "page_size" parameter increased to 5000
Added Remote Work Mode Classification
Introducing Vector Embeddings and Vector Search in the jobdata API
New Jobs Deleted API Endpoint for Data Synchronization
Removal of clearance_required field from job result structure
Optimized Vector Embeddings & Search

Explore jobdata API with AI tools

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