POI 关键词搜索 APIPOI Search

按关键词/类别/城市检索兴趣点

POI 搜索接口路径 /v3/place/text默认 QPS 30已售 1,652 个次数包数据更新：按月

接口介绍

按关键词、类别编码、城市范围检索兴趣点（POI），返回名称、地址、坐标、电话、类别、营业信息等字段，支持分页与结果排序。适用于门店查询、竞品分析、地址联想等场景。

适用场景

连锁品牌门店查询与展示
商圈、竞品门店分布分析
本地生活类 App 的商户检索
地址补全前置检索

请求参数

参数	类型	必填	说明
`keywords`	string	是	查询关键词，多个以 \| 分隔
`city`	string	否	城市名或 citycode，不填为全国
`types`	string	否	POI 类别编码，多个以 \| 分隔
`offset`	int	否	每页条数，默认 20，最大 25
`page`	int	否	页码，默认 1
`key`	string	是	接口密钥（AppKey），在控制台申请
`output`	string	否	返回格式，json（默认）或 xml
`sig`	string	否	数字签名，开启签名校验后必填

请求示例

GET https://api.sbkj99.top/v3/place/text?key=您的AppKey&keywords=...

支持 GET / POST，需使用 HTTPS；返回默认 JSON，可用 output=xml 切换。签名校验与 IP 白名单在控制台开启，见开发文档 · 鉴权。

返回示例

{
  "status": "1", "count": "138",
  "pois": [{
    "id": "B0FFH3ZKQ7", "name": "全家便利店(天河北路店)",
    "type": "购物服务;便利店;便利店", "typecode": "060200",
    "address": "天河北路 118 号", "location": "120.131004,30.281733",
    "tel": "0571-88XXXXXX", "pname": "广东省", "cityname": "广州市", "adname": "天河区"
  }]
}

错误码

错误码	说明	处理建议
`10000`	请求成功	-
`10001`	key 不正确或过期	检查控制台密钥状态
`10003`	访问已超出日访问量	购买次数包或次日再试
`10004`	单位时间内访问过于频繁	降低并发，或升级套餐提升 QPS
`10005`	IP 白名单出错	在控制台配置服务器 IP
`20000`	请求参数非法	按文档检查参数名与取值
`20001`	缺少必填参数	补齐参数后重试
`20003`	请求协议非法	请使用 HTTPS
`30001`	引擎返回数据异常	稍后重试，持续出现请提交工单