# Added new Job States (geo) endpoint, query filters, and more

jobdataapi.com v4.6 / API version 1.9

---

The latest update to the jobdata API introduces significant enhancements to geographic filtering and data relationships, making it easier to perform highly targeted job and city searches. The `/api/jobs/` endpoint now supports filtering by a combination of `country_code` and `state_code`, or by using a single `state_id`. This addition enables you to focus on specific regions, whether targeting states within a country or pinpointing individual states by their unique identifiers. Similarly, the connection between jobs and states has been streamlined, with state relationships derived from the cities where jobs are listed. This ensures accurate regional filtering while leveraging existing city-to-state mappings.

A newly introduced `/api/jobstates/` endpoint now provides access to a comprehensive list of states, provinces, or administrative regions based on GeoNames data. This endpoint enables you to refine your API queries by focusing on specific states, offering a new level of geographic precision (see our [Job States API Endpoint Documentation](/c/job-states-api-endpoint-documentation/) for more details).

Nested city information has also been added to the `/api/jobs/` results, providing a more comprehensive view of the geographic context for each job posting. You can now explore city-level job data with clear associations to states and countries. Moreover, the inclusion of `country_id` in the results adds a new dimension of detail, simplifying integrations that rely on country-specific identifiers for analysis or visualization.

New filters have also been introduced for both cities and jobs (see [Job Cities API Endpoint Documentation](/c/job-cities-api-endpoint-documentation/) and [Jobs API Endpoint Documentation](/c/jobs-api-endpoint-documentation/) respectively). You can now filter cities by `country_id`, `state_id`, or `state_code`, while jobs can be filtered by additional criteria such as `city_id`, `state_id`, or `country_id`.

Together, these improvements make the API more powerful and flexible, catering to advanced use cases like regional market analysis, targeted job searches, and refined data categorization for recruitment or research applications.