Yelp Places Business Search API

Yelp 官方 GET /v3/businesses/search 按位置和筛选返回商户基础资料，需有范围权限的 Bearer API key；半径与排序是建议，部分过滤需Premium，未实际查询。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：本地商户与地点条件检索 · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · d90d822d4c2b2e2b9487f9f702364a5a659866d9f578a3a5a35235af33c09775

本次官方Search参考页明确 https://api.yelp.com/v3/businesses/search，按location或经纬度及关键词、类别、价格等级、营业时间等检索商户。正文称最多返回240个商户且不包含没有任何评论的商户；limit单页默认20、最多50。半径与sort_by均是搜索建议，不保证严格地理边界或按原始评分排序。本文不将侧栏的预订、广告或写入端点当作本搜索权限。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-84bab1a22336522fd0d07bb5 · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-84bab1a22336522fd0d07bb5
名片版本: 2
资料更新: 2026-10-24T18:43:02.5898972+00:00
原作者 / 提供者: 未知
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

location字符串，或latitude/longitude坐标对；term、categories、locale及price等级等可选。
radius建议半径，最多40,000米；sort_by默认best_match，也可rating/review_count/distance，均为建议。
open_now与open_at不能同用；attributes组合为AND，类别列表可按OR筛选。
limit默认20、最多50；offset参数文档范围0–1000，但正文仍限定此搜索最多240个商户。

输出

成功为HTTP200 application/json，返回符合检索条件的商户基础信息。
本次捕获正文未展开具体JSON字段/分页对象schema；错误含400/401/403/404/413/429/500/503。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: GET

鉴权：API 密钥。页面Credentials为Bearer，401说明key过期或缺少本端点scope，并列无效key/authorization header错误。有效API key及访问权限由使用者自行提供，未推定OAuth流程。

运行前提

由使用者自行提供对该端点有权限的API key。
提供location，或同时提供latitude与longitude。
使用Premium专属attributes时需对应Yelp Places Premium Plan及账户权限。

公开请求示例

{
  "credential_requirement": "\u4F7F\u7528\u8005\u81EA\u884C\u63D0\u4F9B\u5177\u5907scope\u7684Yelp API key",
  "documentation_text": "\u5B98\u65B9\u8BF7\u6C42\u5F62\u72B6\uFF08\u672A\u6267\u884C\uFF09\uFF1AGET https://api.yelp.com/v3/businesses/search\uFF0C\u63D0\u4F9Blocation\u6216\u5B8C\u6574latitude/longitude\u3002\u8BA4\u8BC1\u4F7F\u7528Bearer API key\uFF0C\u51ED\u636E\u7531\u4F7F\u7528\u8005\u81EA\u884C\u63D0\u4F9B\uFF1B\u793A\u4F8B\u4E0D\u5305\u542B\u4EFB\u4F55key\u503C\u3002",
  "method": "GET",
  "url": "https://api.yelp.com/v3/businesses/search"
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。本页说明部分Premium Search Filters需Yelp Places Premium Plan，但未给搜索API价格、免费额度或配额；另一Yelp AI playground的免费提示不等同本端点免费。

价格来源 · 未知

资料去向

提供者服务器。位置、筛选和认证key发送至Yelp托管API；查询日志保留、驻留及商户资料展示/再使用条件未由本页展开。

限制

不返回没有任何评论的商户，不能当作全部商户的完整名录。
位置字符串和radius不保证严格范围；sort_by只是算法建议，rating也可能使用调整评分。
正文最多240结果，不由offset上限推定能获取1000条或全量。
部分attributes要求Premium计划；job_alias等还依额外资源访问条件。
429可能是日额度或QPS超限，具体数值未给。
未查询商户、下单、预订或修改商户资料。

仍需核对

实际API key scope、账户计划与Premium过滤可用性未知。
价格、免费额度、每日配额及QPS数值未知。
具体成功JSON schema、覆盖/更新时效和搜索结果准确性未验证。
位置查询保留、驻留及数据再使用条款未知。
未认证或执行任何查询/预订/下单。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:42:07.9964950+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

Search · 官方文档 · 2026-10-24T18:42:07.9964950+00:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://docs.developer.yelp.com/reference/v3_business_search",
  "final_url": "https://docs.developer.yelp.com/reference/v3_business_search",
  "status_code": 200,
  "title": "Search",
  "description": "This endpoint returns up to 240 businesses with some basic information based on the provided search criteria. Explore our new Yelp AI API for conversational search experiences. Try it for free in our playground and see real-time conversational responses in action. Note: The API does not return busin...",
  "checked_at": "2026-10-24T18:42:07.996495\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-84bab1a22336522fd0d07bb5",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://docs.developer.yelp.com/reference/v3_business_search"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。