跳转到主要内容

搜索服务国家/地区

使用这些公开接口可查看 Fetch Hive 搜索工作流服务所支持的国家/地区值。这些接口不需要身份验证。

接口

GET /v1/public/search_services/countries
GET /v1/public/search_services/{service}/countries
支持的服务键:
  • google_search
  • google_news
  • google_ai_mode
  • google_ai_overview
  • bing_search
路径中也接受带连字符的服务键,如 google-ai-overview

响应字段

每个服务目录包含:
字段描述
service服务键。
name人类可读的服务名称。
country_value_field使用该国家/地区值的工作流设置字段。
country_value_format该服务的值格式。可为 country_namealpha2
countries该服务可用的国家/地区。
每个国家/地区包含:
字段描述
country_name展示名称,如 United States
alpha2ISO 3166-1 alpha-2 代码,如 US
value在该服务的国家/位置设置中应发送的值。

值格式

配置工作流步骤时使用 value 字段。
服务国家/地区值格式示例值
google_searchcountry_nameUnited States
google_newscountry_nameUnited States
google_ai_modecountry_nameUnited States
google_ai_overviewalpha2US
bing_searchcountry_nameUnited States
Google AI Overview 使用 alpha-2 国家/地区值,因为其运行时请求会将所选国家/地区映射到 Google 的 gl 参数。其他列出的服务在其位置设置中使用国家/地区名称。

示例

curl https://api.fetchhive.com/v1/public/search_services/google_ai_overview/countries
示例响应:
{
  "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"
    }
  ]
}