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

Enhanced multi-value parameters for Job and Company queries
Added salary estimates and converted values + location_string to download CSVs
Optimized Vector Embeddings & Search
Maximum value for "page_size" parameter increased to 5000
Added YouTube links to company profiles
Improved API query validation
Job filtering by vector embedding now available + added Apprenticeship job type
Removal of clearance_required field from job result structure
API access key management upgrades + company timestamps in Companies API
Added source/ATS and company filtering + source ID fields
Added company flag for recruiting/staffing firms + enhanced filtering options
Enhanced Company HQ Data + new Geographic Filters
Added plain-text field for cleaned job description
Added application URL query filter + (multi) country code parameter enhancements
Query behavior changes for application_url, title, and location filters
Added Role Taxonomy Tags Endpoint + Job Role Filters
Introducing Vector Embeddings and Vector Search in the jobdata API
Full job data downloads now available!
Added `ext_id` filtering to Jobs API + normalized future publish timestamps
Added company open/total job counts + filters