Skip to main content
Use these public endpoints to inspect the country values supported by Fetch Hive search workflow services. These endpoints do not require authentication.

​
Endpoints

GET /v1/public/search_services/countries
GET /v1/public/search_services/{service}/countries
Supported service keys:
  • google_search
  • google_news
  • google_ai_mode
  • google_ai_overview
  • bing_search
Hyphenated service keys are also accepted in the path, such as google-ai-overview.

​
Response Fields

Each service catalog includes:
FieldDescription
serviceService key.
nameHuman-readable service name.
country_value_fieldWorkflow setting field that consumes the country value.
country_value_formatValue format for this service. Either country_name or alpha2.
countriesAvailable countries for the service.
Each country includes:
FieldDescription
country_nameDisplay name, such as United States.
alpha2ISO 3166-1 alpha-2 code, such as US.
valueThe value to send for this service’s country/location setting.

​
Value Formats

Use the value field when configuring the workflow step.
ServiceCountry Value FormatExample Value
google_searchcountry_nameUnited States
google_newscountry_nameUnited States
google_ai_modecountry_nameUnited States
google_ai_overviewalpha2US
bing_searchcountry_nameUnited States
Google AI Overview uses alpha-2 country values because its runtime request maps the selected country to Google’s gl parameter. The other listed services use country names for their location setting.

​
Example

curl https://api.fetchhive.com/v1/public/search_services/google_ai_overview/countries
Example response: 
{
  "service": "google_ai_overview",
  "name": "Google AI Overview",
  "country_value_field": "google_location_name",
  "country_value_format": "alpha2",
  "countries": [
    {
      "country_name": "United States",
      "alpha2": "US",
      "value": "US"
    }
  ]
}