SuperAPI AI 工具集

local-pois

通用与其它

查看项目

更新于 10-15 17:29

技能介绍

用途:Local POIs 是 Brave Search API 的一个端点,用于根据 POI ID 获取本地商家/兴趣点的完整详情。它采用两步流程:先通过 local-place-search 或 web-search(result_filter=locations)拿到 locations.results[].id,再把这些 ID 传给本接口。

主要能力:返回商家名称、规范 URL、地址(displayAddress、街道、城市、州、邮编、国家)、联系方式(电话、邮箱)、评分(ratingValue、bestRating、reviewCount、评分来源)、营业时间(当天与整周)、坐标、距离、类别、价格区间、菜系、缩略图、外部资料、照片、相关网页结果、时区等。

使用方式:GET https://api.search.brave.com/res/v1/local/pois,认证头 X-Subscription-Token: <API_KEY>。必填参数 ids(1-20 个),可选 search_lang、ui_lang、units(metric 或 imperial)。可加 X-Loc-Lat、X-Loc-Long 头以计算距离。cURL 示例:curl -s "https://api.search.brave.com/res/v1/local/pois" -H "Accept: application/json" -H "Accept-Encoding: gzip" -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" -G --data-urlencode "ids=loc4CQWMJWLD4VBEBZ62XQLJTGK6YCJEEJDNAAAAAAA="。

适用场景:本地商家查询、餐厅发现与筛选、营业时间检查、基于位置的附近 POI 距离计算。

限制:POI ID 为不透明字符串,约 8 小时后过期,需重新获取;单次最多 20 个 ID;ID 可能含 =,cURL 中应使用 --data-urlencode。需 API Key,具体收费与套餐信息暂未提供。