Enhanced Company HQ Data + new Geographic Filters
jobdataapi.com v4.16 / API version 1.18
Table of contents
This update introduces significant enhancements to company headquarters data and geographic filtering capabilities across our companies and jobs API endpoints.
New Company HQ data fields
The /api/companies/ endpoint now includes several new fields to provide richer location data for company headquarters:
- info_hq_string: A GeoNames-optimized location of the company's headquarters (derived from the original
info_hqfield content). - info_hq_region: The ID of the region the company headquarters are located in.
- info_hq_country: The ID of the country the company headquarters are located in.
- info_hq_state: The ID of the state the company headquarters are located in.
- info_hq_city: The ID of the city the company headquarters are located in.
Advanced Company filtering by HQ info
New filters have been added to the /api/companies/ endpoint to search by headquarters location in a more structured way:
- hq_region_id: Filter companies by the ID of the region their headquarters are located in.
- hq_country_id: Filter companies by the ID of the country their headquarters are located in.
- hq_state_id Filter companies by the ID of the state their headquarters are located in.
- hq_city_id: Filter companies by the ID of the city their headquarters are located in.
Job search by Company HQ location
The /api/jobs/ endpoint now also supports filtering by the geographic location of company headquarters through new parameters:
- company_hq_region_id: Filters companies by the region ID their headquarters are located in.
- company_hq_country_id: Filters companies by the country ID their headquarters are located in.
- company_hq_state_id: Filters companies by the state ID their headquarters are located in.
- company_hq_city_id: Filters companies by the city ID their headquarters are located in.
For example, to find all jobs from companies headquartered in California:
https://jobdataapi.com/api/jobs/?company_hq_state_id=5332921
Note that not all companies come with comprehensive HQ info data (currently around 80% have it), so in some cases a fallback to searching by job location data is recommended where applicable.
All new features in this update require an access pro subscription or higher. For complete documentation, see the updated Companies API and Jobs API endpoint documentation.
Related Docs
Optimized Vector Embeddings & Search
Added Role Taxonomy Tags Endpoint + Job Role Filters
Added Remote Work Mode Classification
Added YouTube links to company profiles
Full job data downloads now available!
Added salary estimates + global currency conversion API endpoint
GeoNames upgrade, new population field and filters, expired field now in job results
Query behavior changes for application_url, title, and location filters
Added default date window for Expired Jobs
Added source/ATS and company filtering + source ID fields
Added `ext_id` filtering to Jobs API + normalized future publish timestamps
Added plain-text field for cleaned job description
Multi-value parameter limits now return an error
New Jobs Deleted API Endpoint for Data Synchronization
API page-size maximum reduced to 4000
Maximum value for "page_size" parameter increased to 5000
Improved Job States (geo) search, Markdown job descriptions, and lean data retrieval
Added visa sponsorship, layoff and other government records for companies
jobdataapi.com now has Changelog section 🎉
Added company website/domain filter to jobs endpoint
Explore jobdata API with AI tools
Ask an AI assistant how to search and build with live job data.