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 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 and 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.