jobdata

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

jobdataapi.com v4.6 / API version 1.9

1 min read · Nov. 30, 2024

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.

Related Docs

jobdataapi.com now has Changelog section 🎉
New location, ID fields and filters
Change of length for job title and location fields
Added plain-text field for cleaned job description
Maximum value for "page_size" parameter increased to 5000
Removal of clearance_required field from job result structure
Full job data downloads now available!
Added company website/domain filter to jobs endpoint
Added company open/total job counts + filters