# Enhanced Company HQ Data + new Geographic Filters

jobdataapi.com v4.16 / API version 1.18

---

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:

```bash
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](/c/companies-api-endpoint-documentation/) and [Jobs API](/c/jobs-api-endpoint-documentation/) endpoint documentation.