jobdata

Improved Job States (geo) search, Markdown job descriptions, and lean data retrieval

jobdataapi.com v4.11 / API version 1.13

1 min read · Feb. 28, 2025

This update introduces several improvements to the jobdata API, focusing on job search precision and data retrieval efficiency. State-based job searches (state_code and state_id) now directly match against states mentioned in job locations, even when no specific city has been identified internally (used as a bridge between jobs and states before this update). This enhances the accuracy and availability of job listings by state. A new states field has been added to the /api/jobs/ endpoint response, and the updated state mapping is also included in the job_job_states.csv file for access ultra subscribers.

A new description_md field has been added, providing job descriptions in Markdown format. Use the description_md=true parameter to include this field in API responses, offering an alternative to the existing HTML and stripped text (description_str) versions.

To streamline data retrieval, the description_off=true parameter now allows you to exclude the HTML job description entirely. This is useful when only specific fields (e.g., job title, location, or salary) are needed. It can be combined with description_md=true or description_str=true to retrieve only the Markdown or stripped text versions of the description.

These API updates are available across all access plans. For more details, refer to the updated Jobs API Endpoint Documentation and CSV File Downloads Documentation.

Related Docs

Added company website/domain filter to jobs endpoint
Added new Job States (geo) endpoint, query filters, and more
Added company open/total job counts + filters
Change of length for job title and location fields
Added application URL query filter + (multi) country code parameter enhancements
jobdataapi.com now has Changelog section 🎉
Removal of clearance_required field from job result structure
New location, ID fields and filters
Maximum value for "page_size" parameter increased to 5000
Full job data downloads now available!
GeoNames upgrade, new population field and filters, expired field now in job results
Added company flag for recruiting/staffing firms + enhanced filtering options
Added plain-text field for cleaned job description