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 · Markdown version

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

Improved API query validation
Added source/ATS and company filtering + source ID fields
Maximum value for "page_size" parameter increased to 5000
Query behavior changes for application_url, title, and location filters
GeoNames upgrade, new population field and filters, expired field now in job results
Enhanced multi-value parameters for Job and Company queries
Geo radius search expansion for Jobs API location filters
Removal of clearance_required field from job result structure
Added salary estimates + global currency conversion API endpoint
Added company flag for recruiting/staffing firms + enhanced filtering options
Added API Access Lite Plan + Smarter Age-Window Defaults for Jobs API
API page-size maximum reduced to 4000
Added salary estimates and converted values + location_string to download CSVs
Job filtering by vector embedding now available + added Apprenticeship job type
Added `ext_id` filtering to Jobs API + normalized future publish timestamps
Added company open/total job counts + filters
Added new Job States (geo) endpoint, query filters, and more
Added plain-text field for cleaned job description
Enhanced Company HQ Data + new Geographic Filters
New location, ID fields and filters

Explore jobdata API with AI tools

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