Saltar al contenido principal

​
Países de servicios de búsqueda

Usa estos endpoints públicos para inspeccionar los valores de país soportados por los servicios de búsqueda de Fetch Hive en flujos de trabajo. Estos endpoints no requieren autenticación.

​
Endpoints

GET /v1/public/search_services/countries
GET /v1/public/search_services/{service}/countries
Claves de servicio soportadas:
  • google_search
  • google_news
  • google_ai_mode
  • google_ai_overview
  • bing_search
Las claves de servicio con guiones también se aceptan en la ruta, como google-ai-overview.

​
Campos de respuesta

Cada catálogo de servicio incluye:
CampoDescripción
serviceClave del servicio.
nameNombre legible para humanos del servicio.
country_value_fieldCampo de configuración del flujo de trabajo que consume el valor de país.
country_value_formatFormato del valor para este servicio. Puede ser country_name o alpha2.
countriesPaíses disponibles para el servicio.
Cada país incluye:
CampoDescripción
country_nameNombre de visualización, como United States.
alpha2Código ISO 3166-1 alpha-2, como US.
valueEl valor a enviar para el ajuste de país/ubicación de este servicio.

​
Formatos de valor

Usa el campo value al configurar el paso del flujo de trabajo.
ServicioFormato del valor de paísValor de ejemplo
google_searchcountry_nameUnited States
google_newscountry_nameUnited States
google_ai_modecountry_nameUnited States
google_ai_overviewalpha2US
bing_searchcountry_nameUnited States
Google AI Overview usa valores de país alpha-2 porque su solicitud de runtime mapea el país seleccionado al parámetro gl de Google. Los otros servicios listados usan nombres de país para su ajuste de ubicación.

​
Ejemplo

curl https://api.fetchhive.com/v1/public/search_services/google_ai_overview/countries
Respuesta de ejemplo: 
{
  "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"
    }
  ]
}