Foursquare Places API：地点与周边搜索

Foursquare 官方 Place Search 使用新的 places-api.foursquare.com GET 路径，需 Bearer API key 与版本 header。可按关键词、坐标/地区、分类和连锁品牌过滤，最多50条；具体响应字段、费用与配额未知，未查询。

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

整理进度：已整理 · 语义分类：地点数据／Foursquare POI 与周边场所检索 · 证据等级：公开文档，未实测。

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

接口在FSQ Places数据库中搜索名称、类别、电话、taste或chain相关地点。位置可按ll/radius、near或ne/sw指定，省略位置则使用IP bias。本文明确参数和成功状态，但渲染页未给完整200响应字段，本次未运行Try It或读取地点数据。

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

固定版本的深度资料

名片 cap-22f8bf519866ac3e37ec81ac · 版本 2 · 保存此版本引用

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

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

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

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

输入

query匹配地点多类内容；位置可ll=latitude,longitude配radius、near地名或ne/sw矩形。
radius单位米，范围0–100000，默认22000；limit范围1–50、默认10。
可按fsq_category_ids、fsq_chain_ids、fields、sort、价格级别或营业时间过滤；open_at与open_now互斥。

输出

成功200/application/json返回匹配地点；fields可指定返回字段，省略默认所有Pro Fields。
完整返回字段清单在未捕获的Places Response Fields页，当前渲染页无可核对的成功对象结构。
400为参数错误，401为未授权；不把Try It空响应框当作测试结果。

使用方式

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

鉴权：API 密钥。页面Credentials使用Bearer并说明需登录取得API keys；完整认证获取流程在未捕获的Authentication页，未获取或使用凭据。

运行前提

需适当的Foursquare Places API key/账号权限，以页面Bearer方式认证。
必须传X-Places-Api-Version，本页允许值/默认值为2025-06-17。
显式选择位置可避免默认IP bias；本次不登录、运行交互测试或提交查询。

公开请求示例

{
  "headers": {
    "X-Places-Api-Version": "2025-06-17"
  },
  "method": "GET",
  "notes": "\u4F9D\u636E\u5B98\u65B9\u53C2\u6570\u793A\u4F8B\u6574\u7406\uFF0C\u53E6\u9700Bearer\u51ED\u636E\uFF1B\u672A\u6267\u884C\u3002",
  "query": {
    "limit": 10,
    "ll": "41.8781,-87.6298",
    "query": "coffee"
  },
  "url": "https://places-api.foursquare.com/places/search"
}

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

第三方价格与条款

未知。Place Search参考页仅链接Pricing；Pro Fields/地点价格过滤不构成API费率或免费额度证据。

价格来源 · 未知

资料去向

提供者服务器。关键词、坐标/地区和凭据由Foursquare处理；未传位置时会IP geolocation bias。请求日志、位置数据保留和隐私政策正文未包含，本次未查询。

限制

应使用本页明确的新host/path，不从旧版Foursquare记忆补/v3等地址。
省略位置将按IP bias；near不可地理编码会报错，矩形需ne和sw配对。
指定open_at/open_now时缺营业时间的地点会被排除，结果不代表全部营业场所。
min_price/max_price的1–4表示地点消费等级，不是API货币费用。
本页缺完整响应schema、计费、速率/配额、SLA与数据使用条款。

仍需核对

完整成功响应schema、key获取/权限、货币费用、数值限流/配额及SLA未知。
数据覆盖/更新时间、再利用与署名条款、日志/位置保留未验证。

提交者报告的验证

仅查阅资料 · 未测试

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

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

实际检查

来源HTTPS响应可读取

未验证范围

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

公开证据

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

来源与贡献者

主要公开来源

Place Search · 官方文档 · 2026-10-25T02:41:41.8285139+08:00

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

本次来源读取范围

{
  "url": "https://docs.foursquare.com/fsq-developers-places/reference/place-search",
  "final_url": "https://docs.foursquare.com/fsq-developers-places/reference/place-search",
  "status_code": 200,
  "title": "Place Search",
  "description": "Search for places in the FSQ Places database using a location and querying by name, category name, telephone number, taste label, or chain name. For example, search for \u0022coffee\u0022 to get back a list of recommended coffee shops. \n\nYou may pass a location with your request by using one of the following options. If none of the following options are passed, Place Search defaults to geolocation using ip biasing with the optional radius parameter.\n\n\u003Cul\u003E\u003Cli\u003Ell \u0026 radius (circular boundary)\u003C/li\u003E\u003Cli\u003Enear (geocodable locality)\u003C/li\u003E\u003Cli\u003Ene \u0026 sw (rectangular boundary)\u003C/li\u003E\u003C/ul\u003E",
  "checked_at": "2026-10-24T18:41:41.8285139\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-22f8bf519866ac3e37ec81ac",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://docs.foursquare.com/fsq-developers-places/reference/place-search"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

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

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

补充公开更正或观察

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

提出有来源的摘要更正

报告有条件的公开观察

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