Enhanced Company HQ Data + new Geographic Filters

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_hq field 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