DataForSEODataForSEO

商家列表实时搜索

/business_data_business_listings_search_live

搜索 Google 地图中指定类别的商家实体,返回地址、联系方式、评分、营业时间及其他相关数据。结果取决于所选地点设置,地点取值参见地点列表。

最近 7 天完成的调用
0

统计不包含取消的调用。执行时间仅统计成功调用。

通过你的 Agent 使用

请安装 https://www.agentrouter.to/SKILL.md,然后通过 AgentRouter 使用 DataForSEO 的 /business_data_business_listings_search_live 接口。

输入参数

categories选填
商家分类。 可选字段。 使用指定分类搜索商家列表; 未使用此字段时,返回指定地区内找到的商家列表; 最多指定 10 个分类。
description选填
搜索结果页元素的描述。 可选字段。 要收集结果的商家实体描述,最多 200 个字符。
title选填
搜索结果页元素的标题。 可选字段。 要收集结果的商家实体名称,最多 200 个字符。
is_claimed选填
商家是否已由其所有者在 Google Maps 认证。 可选字段。
location_coordinate选填
地区 GPS 坐标,可选。location_coordinate 格式为 "latitude,longitude,radius";"latitude" 和 "longitude" 最多 7 位小数;"radius" 单位为公里(km),最小 1,最大 100000。例如:53.476225,-2.243572,200。此 API 地区参数设置详情参见帮助中心。
filters选填
结果筛选参数数组。 可选字段。 可同时添加多个筛选条件(最多 8 个)。 请在条件间设置逻辑运算符 and , or 。支持以下运算符: regex , not_regex , < , <= , > , >= , = , <> , in , not_in , like , not_like , ilike , not_ilike , match , not_match 可将 % 运算符与 like、not_like 配合使用,匹配任意零个或多个字符的字符串。 例如: ["rating.value",">",3];可单独请求下列地址获取可用筛选条件: https://api.dataforseo.com/v3/business_data/business_listings/available_filters 完整可用筛选条件列表参见此处。
order_by选填
结果排序规则。 可选字段。可使用 filters 数组中相同的字段值对结果排序。 可用排序类型: asc :按升序排列结果; desc :按降序排列结果; 请使用逗号指定排序参数。 例如: ["rating.value,desc"];注意:单次请求最多设置三条排序规则。 请使用逗号分隔多个排序规则。 例如: ["rating.value,desc","rating.votes_count,desc"]
limit必填
返回商家数上限。 可选字段。默认值: 100;最大值: 1000
offset选填
返回商家结果数组的偏移量。 可选字段。默认值: 0 指定为 10 时,跳过结果数组的前十个实体,返回后续实体。 注意: 建议仅在获取不超过 10,000 条结果时使用此参数;超过 10,000 条结果请使用 offset_token 。
offset_token选填
后续请求使用的令牌。 可选字段。 由每次请求响应中的同名字段提供。; 单次请求获取超过 100,000 条结果时,可用此参数避免超时; 指定唯一的 offset_token 响应数组中的值,可获取初始任务的后续结果; offset_token 各后续任务的值均唯一。 注意: 请求中指定 offset_token 时,所有其他参数应与上一请求相同。 此参数详情参见帮助中心。

输入示例

{
  "categories": [
    "pizza_restaurant"
  ],
  "description": "pizza",
  "title": "pizza",
  "is_claimed": true,
  "location_coordinate": "53.476225,-2.243572,10",
  "order_by": [
    "rating.value,desc"
  ],
  "filters": [
    [
      "rating.value",
      ">",
      3
    ]
  ],
  "limit": 3
}

输出

原生任务结果封装;在支持时包含条目、聚合结果和分页信息。