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

Introducing Vector Embeddings and Vector Search in the jobdata API
Added Remote Work Mode Classification
Added company flag for recruiting/staffing firms + enhanced filtering options
Added company website/domain filter to jobs endpoint
Enhanced Company HQ Data + new Geographic Filters
Added YouTube links to company profiles
Added `ext_id` filtering to Jobs API + normalized future publish timestamps
Added salary estimates + global currency conversion API endpoint
Added plain-text field for cleaned job description
Added new Job States (geo) endpoint, query filters, and more
Geo radius search expansion for Jobs API location filters
Added source/ATS and company filtering + source ID fields
Removal of clearance_required field from job result structure
Full job data downloads now available!
API page-size maximum reduced to 4000
Added salary estimates and converted values + location_string to download CSVs
Added application URL query filter + (multi) country code parameter enhancements
Added company open/total job counts + filters
API access key management upgrades + company timestamps in Companies API
Change of length for job title and location fields

Explore jobdata API with AI tools

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