> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# SERP API 的 Google 地理位置列表
> 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。
## 示例
```bash REST theme={null}
curl -X GET "https://api.aisa.one/apis/v1/dataforseo/serp/google/locations" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```jsonc MCP theme={null}
// 把整段复制给 Claude Code、Codex、Cursor 或任意 coding agent。
// 连接、授权、跑通这个例子需要的东西都在里面 ——
// 不用粘贴任何 key，浏览器里点一次 Allow 就好。
{
"operation_id": "get_dataforseo_serp_google_locations",
"arguments": {},
"max_price_usd": 0.05
}
// ── for the agent ─────────────────────────────────────────────────────────
// Register the AIsa MCP server, then call its `use` tool with the JSON above.
// name aisa
// endpoint https://mcp.aisa.one/mcp
// transport streamable-http
// auth OAuth. The server publishes RFC 9728 metadata, so open a
// browser and the user clicks Allow once — nothing to paste.
// If AISA_API_KEY is set, send it as a bearer header instead.
// Use your own MCP mechanism, not a hand-edited config file:
// Codex codex mcp add aisa --url https://mcp.aisa.one/mcp
// Claude Code claude mcp add --transport http -s user aisa https://mcp.aisa.one/mcp
// Cursor / VS Code a "url" entry for https://mcp.aisa.one/mcp in the MCP config
// The server lists five tools over https://mcp.aisa.one/servers worth of APIs:
// search, get_details, use, batch_use, list_categories. search and
// get_details are free; use is billed per call and max_price_usd refuses
// anything above the cap before spending. This operation's full contract —
// every argument, the response shape, the price and the pitfalls — is at
// https://aisa.one/docs/zh/api-reference/dataforseo/get_dataforseo-serp-google-locations.md
// Then run the call and show me the result.
```
**第一次用？** 把任意 MCP 客户端指向 `https://mcp.aisa.one/mcp` —— Claude Code、
Codex、Cursor、VS Code 都可以。鉴权走 OAuth：客户端打开浏览器，你点一次
Allow，不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见
[aisa.one/zh-cn/mcp](https://aisa.one/zh-cn/mcp#connect)。
[在你的 agent 里把这个端点跑起来 →](https://aisa.one/mcp?from=/zh/api-reference/dataforseo/get_dataforseo-serp-google-locations)
## OpenAPI
````yaml openapi/zh/dataforseo.json GET /dataforseo/serp/google/locations
openapi: 3.0.3
info:
title: DataForSEO API
version: 1.0.0
description: 通过 AIsa 统一网关提供的 DataForSEO API 端点。
servers:
- url: https://api.aisa.one/apis/v1
security:
- BearerAuth: []
paths:
/dataforseo/serp/google/locations:
get:
summary: SERP API 的 Google 地理位置列表
description: >-
返回 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。
operationId: get_dataforseo_serp_google_locations
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
version:
type: string
description: The current version of the API
status_code:
type: integer
description: General status code
status_message:
type: string
description: General informational message
time:
type: string
description: Execution time, seconds
cost:
type: number
description: >-
Total tasks cost, USD (0 for these free dictionary
endpoints)
tasks_count:
type: integer
description: The number of tasks in the tasks array
tasks_error:
type: integer
description: >-
The number of tasks in the tasks array returned with an
error
tasks:
type: array
items:
type: string
description: Array of tasks
tasks[].result:
type: array
items:
type: string
description: 可用地理位置数组
tasks[].result[].location_code:
type: integer
description: 地理位置代码 —— 提交 SERP 任务时作为 location_code 传入
tasks[].result[].location_name:
type: string
description: 地理位置全称
tasks[].result[].location_code_parent:
type: integer
description: 上级地理位置代码(如城市所属国家)
tasks[].result[].country_iso_code:
type: string
description: 国家 ISO 代码
tasks[].result[].location_type:
type: string
description: 地理位置类型(国家、地区、城市等)
'400':
description: Bad request
'401':
description: Unauthorized
'429':
description: Rate limit exceeded
'500':
description: Internal server error
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
````