Skip to main content
GET
SERP API 的 Google 地理位置列表
返回 Google SERP API 支持的全部地理位置,用于在提交 SERP 任务时解析 location_code。每条记录包含 location_code、location_name、location_code_parent、country_iso_code 与 location_type。💰 上游免费 —— DataForSEO 对该字典端点不收费;AIsa 按家族统一 flat 价 $0.012 计费。响应为 DataForSEO 标准信封:数据在 tasks[0].result,结果状态在 tasks[0].status_code —— 请求被拒仍返回 HTTP 200。

示例

第一次用? 把任意 MCP 客户端指向 https://mcp.aisa.one/mcp —— Claude Code、 Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次 Allow,不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

响应

Successful response

version
string

The current version of the API

status_code
integer

General status code

status_message
string

General informational message

time
string

Execution time, seconds

cost
number

Total tasks cost, USD (0 for these free dictionary endpoints)

tasks_count
integer

The number of tasks in the tasks array

tasks_error
integer

The number of tasks in the tasks array returned with an error

tasks
string[]

Array of tasks

tasks[].result
string[]

可用地理位置数组

tasks[].result[].location_code
integer

地理位置代码 —— 提交 SERP 任务时作为 location_code 传入

tasks[].result[].location_name
string

地理位置全称

tasks[].result[].location_code_parent
integer

上级地理位置代码(如城市所属国家)

tasks[].result[].country_iso_code
string

国家 ISO 代码

tasks[].result[].location_type
string

地理位置类型(国家、地区、城市等)