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

jobdataapi.com v4.11 / API version 1.13

---

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](/c/jobs-api-endpoint-documentation/) and [CSV File Downloads Documentation](/c/csv-file-downloads-documentation/).
