按类别、商家名称与描述检索词、中心坐标与半径，以及一条筛选条件和排序规则，查找 DataForSEO 数据库中的 Google Maps 商家信息。最多返回三条已由店主验证的记录。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
DataForSEO
按类别、商家名称与描述检索词、中心坐标与半径，以及一条筛选条件和排序规则，查找 DataForSEO 数据库中的 Google Maps 商家信息。最多返回三条已由店主验证的记录。
获得符合本地检索条件的商家短名单。每条记录可包含名称、地址、电话、网站、评分、评价数量和营业时间。Agent 可将实际返回的信息整理对比，帮助你决定进一步了解或联系哪些商家。
查找[地点或地图分享链接]附近[10 公里]内的[披萨店]，最多显示 3 家，按评分从高到低排列。只看店主已确认资料且评分高于 3 星的商家；列出可查到的地址、电话、网站和营业时间，并注明缺少的信息。
结果来自 DataForSEO 数据库，最多三条，并非即时直接抓取 Google Maps，也不是当地商家的完整清单。信息可能缺失或过时，联系方式未经过独立核验，记录中的营业时间不能保证商家此刻正在营业。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
检索条件request | object | 必填 | 八项均需填写：类别、商家名称检索词、商家描述检索词、中心坐标与半径、一条筛选条件、一项排序规则，以及固定的 limit=3、is_claimed=true。
|
商家记录上限request.limit | integer | 必填 | 固定填写整数 3，表示最多返回三条商家记录，实际数量可能更少。
|
名称检索词request.title | string | 必填 | 用于检索商家名称的非空文字。原生长度为 1–256 个字符；为符合供应商要求，请控制在 200 个字符以内。不能据此假定逐字或整句匹配。
|
一条筛选条件request.filters | array | 必填 | 外层数组只放一条条件，内层按字段、运算符、比较值填写完整三项，例如 [["rating.value",">",3]]。不能组合多条条件。
|
筛选条件的组成request.filters[] | array | — | 这一条条件在结构上可含 1–3 项；要表达可用的比较条件，应完整提供字段、运算符和比较值三项。
|
字段、运算符或比较值request.filters[][] | string | integer | — | 每项为 1–256 个字符的非空字符串，或整数 3。字段与运算符须受供应商支持；数值比较值固定为 3，不能改成任意数值阈值。 |
一项排序规则request.order_by | array | 必填 | 数组中只放一项受支持的“字段,方向”字符串。方向为 asc 或 desc，例如 ["rating.value,desc"]。这是按字段排序，不表示 Google Maps 搜索名次。
|
排序字段与方向request.order_by[] | string | — | 用一个 1–256 个字符的非空字符串，以逗号连接受支持的字段和排序方向，例如 rating.value,desc。
|
一个商家类别request.categories | array | 必填 | 数组中填写且仅填写一个受支持的商家类别标识，例如 ["pizza_restaurant"]。
|
商家类别标识request.categories[] | string | — | 类别标识为 1–256 个字符的非空字符串，例如 pizza_restaurant；不要把任意展示名称当作可用标识。
|
店主已验证的商家信息request.is_claimed | boolean | 必填 | 固定填写 true，筛选已由店主在 Google Maps 验证的商家信息。这不代表商家质量或联系方式经过独立认证。
|
描述检索词request.description | string | 必填 | 用于检索商家描述的必填非空文字。原生长度为 1–256 个字符；请控制在供应商支持的 200 个字符以内。名称与描述检索词都要填写。
|
检索中心与半径request.location_coordinate | string | 必填 | 按“纬度,经度,半径”填写，字符串长度为 1–256 个字符。半径单位为公里，范围 1–100000；纬度和经度最多各 7 位小数。例如 53.476225,-2.243572,10。
|
{
"type": "object",
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"required": [
"categories",
"description",
"title",
"is_claimed",
"location_coordinate",
"order_by",
"filters",
"limit"
],
"properties": {
"limit": {
"type": "integer",
"const": 3
},
"title": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"filters": {
"type": "array",
"items": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 256,
"minLength": 1
},
{
"type": "integer",
"const": 3
}
]
},
"maxItems": 3,
"minItems": 1
},
"maxItems": 1,
"minItems": 1
},
"order_by": {
"type": "array",
"items": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"maxItems": 1,
"minItems": 1
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"maxItems": 1,
"minItems": 1
},
"is_claimed": {
"type": "boolean",
"const": true
},
"description": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"location_coordinate": {
"type": "string",
"maxLength": 256,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
检索字段及其含义见 DataForSEO 商家信息搜索文档。
最多显示 3 家店主已确认资料、评分高于 3 星的商家，并按评分从高到低排列。这些条件固定。
查找[地点或地图分享链接]附近[10 公里]内的[披萨店]，最多显示 3 家，按评分从高到低排列。只看店主已确认资料且评分高于 3 星的商家；列出可查到的地址、电话、网站和营业时间，并注明缺少的信息。
结果可能包含地址、电话、网站、评分、评价数和营业时间。信息可能缺失或过时，联系或到店前请直接向商家确认。
还需要商家名称和描述检索词，并填写一条完整筛选条件、一项排序规则、固定的 limit=3 和 is_claimed=true。两段检索文字各控制在 200 个字符以内。供应商没有说明名称与描述如何组合匹配，不能把结果理解为严格逐字匹配。
表示商家信息已由店主在 Google Maps 验证。这不等于独立核验了商家身份、服务质量或每项联系方式的准确性。
最多返回三条记录，只能提供一个类别、一条条件和一项排序规则。数值筛选值固定为 3，例如 rating.value >3；没有翻页输入。返回的数据库总数表示供应商库中与条件相关的记录数量，不是当地商家普查总数。
评分要结合返回的评分类型和上限阅读，评价数量不能证明服务质量。营业时间和营业状态来自已有商家信息，不能保证此刻正在营业；到店前应向商家确认。
联系方式可能来自不同来源，也可能缺失或过时。更新时间指供应商记录的更新；首次发现时间指爬虫首次找到该记录，不是商家开业日期。这些日期按 UTC 记录。字段缺失并不能证明商家没有对应信息。