Foursquare Places API:地点与周边搜索
CloseFoursquare Places API:地点与周边搜索
Foursquare 官方 Place Search 使用新的 places-api.foursquare.com GET 路径,需 Bearer API key 与版本 header。可按关键词、坐标/地区、分类和连锁品牌过滤,最多50条;具体响应字段、费用与配额未知,未查询。
Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.
- Stable ID
- cap-22f8bf519866ac3e37ec81ac
- Card version
- 2
- Updated
- 2026-10-24T18:42:37.8199923+00:00
- Ownership state
- unclaimed
- Processing
- unknown
- Evidence level
- unknown
- Business execution
- unknown
Keep this fixed version · Original public source · Complete machine record
Published description
接口在FSQ Places数据库中搜索名称、类别、电话、taste或chain相关地点。位置可按ll/radius、near或ne/sw指定,省略位置则使用IP bias。本文明确参数和成功状态,但渲染页未给完整200响应字段,本次未运行Try It或读取地点数据。
Inputs
- 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互斥。
Outputs
- 成功200/application/json返回匹配地点;fields可指定返回字段,省略默认所有Pro Fields。
- 完整返回字段清单在未捕获的Places Response Fields页,当前渲染页无可核对的成功对象结构。
- 400为参数错误,401为未授权;不把Try It空响应框当作测试结果。
Invocation and authentication
{
"authentication": {
"kind": "api_key",
"notes": "\u9875\u9762Credentials\u4F7F\u7528Bearer\u5E76\u8BF4\u660E\u9700\u767B\u5F55\u53D6\u5F97API keys\uFF1B\u5B8C\u6574\u8BA4\u8BC1\u83B7\u53D6\u6D41\u7A0B\u5728\u672A\u6355\u83B7\u7684Authentication\u9875\uFF0C\u672A\u83B7\u53D6\u6216\u4F7F\u7528\u51ED\u636E\u3002"
},
"command": null,
"entry_url": "https://places-api.foursquare.com/places/search",
"kind": "http_api",
"method": "GET",
"request_example": {
"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"
},
"requirements": [
"\u9700\u9002\u5F53\u7684Foursquare Places API key/\u8D26\u53F7\u6743\u9650\uFF0C\u4EE5\u9875\u9762Bearer\u65B9\u5F0F\u8BA4\u8BC1\u3002",
"\u5FC5\u987B\u4F20X-Places-Api-Version\uFF0C\u672C\u9875\u5141\u8BB8\u503C/\u9ED8\u8BA4\u503C\u4E3A2025-06-17\u3002",
"\u663E\u5F0F\u9009\u62E9\u4F4D\u7F6E\u53EF\u907F\u514D\u9ED8\u8BA4IP bias\uFF1B\u672C\u6B21\u4E0D\u767B\u5F55\u3001\u8FD0\u884C\u4EA4\u4E92\u6D4B\u8BD5\u6216\u63D0\u4EA4\u67E5\u8BE2\u3002"
]
}Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.
Third-party pricing and data handling
{
"model": "unknown",
"notes": "Place Search\u53C2\u8003\u9875\u4EC5\u94FE\u63A5Pricing\uFF1BPro Fields/\u5730\u70B9\u4EF7\u683C\u8FC7\u6EE4\u4E0D\u6784\u6210API\u8D39\u7387\u6216\u514D\u8D39\u989D\u5EA6\u8BC1\u636E\u3002",
"source_url": "https://docs.foursquare.com/fsq-developers-places/reference/place-search"
}{
"location": "provider_server",
"notes": "\u5173\u952E\u8BCD\u3001\u5750\u6807/\u5730\u533A\u548C\u51ED\u636E\u7531Foursquare\u5904\u7406\uFF1B\u672A\u4F20\u4F4D\u7F6E\u65F6\u4F1AIP geolocation bias\u3002\u8BF7\u6C42\u65E5\u5FD7\u3001\u4F4D\u7F6E\u6570\u636E\u4FDD\u7559\u548C\u9690\u79C1\u653F\u7B56\u6B63\u6587\u672A\u5305\u542B\uFF0C\u672C\u6B21\u672A\u67E5\u8BE2\u3002"
}Unknown is not a claim that a service is free, anonymous, private or unavailable.
Limitations
- 应使用本页明确的新host/path,不从旧版Foursquare记忆补/v3等地址。
- 省略位置将按IP bias;near不可地理编码会报错,矩形需ne和sw配对。
- 指定open_at/open_now时缺营业时间的地点会被排除,结果不代表全部营业场所。
- min_price/max_price的1–4表示地点消费等级,不是API货币费用。
- 本页缺完整响应schema、计费、速率/配额、SLA与数据使用条款。
Unknowns
- 完整成功响应schema、key获取/权限、货币费用、数值限流/配额及SLA未知。
- 数据覆盖/更新时间、再利用与署名条款、日志/位置保留未验证。
Fixed profiles, conditions and evidence
Read state: not_checked; review state: unknown. Do not combine different profiles.
资料与来源声明不等于本站实测;未列出的条件仍未知。
结构化配方只按公开声明检查约束与接口,不执行任务或授予权限;缺失记录保持未知,接口兼容不证明实际成功。
Contributor-reported verification
{
"checked_at": "2026-10-24T18:41:41.8285139\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://docs.foursquare.com/fsq-developers-places/reference/place-search"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.
Dynamic observations and corrections
null
null
Add a public correction or observation
Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.
Propose a sourced summary correction
Report a conditional public observation
Complete fixed public record and original source fields
This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.
{
"author_name": "Foursquare",
"availability": "unknown",
"callability": "documentation_only",
"category": "physical",
"data_handling": {
"location": "provider_server",
"notes": "\u5173\u952E\u8BCD\u3001\u5750\u6807/\u5730\u533A\u548C\u51ED\u636E\u7531Foursquare\u5904\u7406\uFF1B\u672A\u4F20\u4F4D\u7F6E\u65F6\u4F1AIP geolocation bias\u3002\u8BF7\u6C42\u65E5\u5FD7\u3001\u4F4D\u7F6E\u6570\u636E\u4FDD\u7559\u548C\u9690\u79C1\u653F\u7B56\u6B63\u6587\u672A\u5305\u542B\uFF0C\u672C\u6B21\u672A\u67E5\u8BE2\u3002"
},
"description": "\u63A5\u53E3\u5728FSQ Places\u6570\u636E\u5E93\u4E2D\u641C\u7D22\u540D\u79F0\u3001\u7C7B\u522B\u3001\u7535\u8BDD\u3001taste\u6216chain\u76F8\u5173\u5730\u70B9\u3002\u4F4D\u7F6E\u53EF\u6309ll/radius\u3001near\u6216ne/sw\u6307\u5B9A\uFF0C\u7701\u7565\u4F4D\u7F6E\u5219\u4F7F\u7528IP bias\u3002\u672C\u6587\u660E\u786E\u53C2\u6570\u548C\u6210\u529F\u72B6\u6001\uFF0C\u4F46\u6E32\u67D3\u9875\u672A\u7ED9\u5B8C\u6574200\u54CD\u5E94\u5B57\u6BB5\uFF0C\u672C\u6B21\u672A\u8FD0\u884CTry It\u6216\u8BFB\u53D6\u5730\u70B9\u6570\u636E\u3002",
"inputs": [
"query\u5339\u914D\u5730\u70B9\u591A\u7C7B\u5185\u5BB9\uFF1B\u4F4D\u7F6E\u53EFll=latitude,longitude\u914Dradius\u3001near\u5730\u540D\u6216ne/sw\u77E9\u5F62\u3002",
"radius\u5355\u4F4D\u7C73\uFF0C\u8303\u56F40\u2013100000\uFF0C\u9ED8\u8BA422000\uFF1Blimit\u8303\u56F41\u201350\u3001\u9ED8\u8BA410\u3002",
"\u53EF\u6309fsq_category_ids\u3001fsq_chain_ids\u3001fields\u3001sort\u3001\u4EF7\u683C\u7EA7\u522B\u6216\u8425\u4E1A\u65F6\u95F4\u8FC7\u6EE4\uFF1Bopen_at\u4E0Eopen_now\u4E92\u65A5\u3002"
],
"invocation": {
"authentication": {
"kind": "api_key",
"notes": "\u9875\u9762Credentials\u4F7F\u7528Bearer\u5E76\u8BF4\u660E\u9700\u767B\u5F55\u53D6\u5F97API keys\uFF1B\u5B8C\u6574\u8BA4\u8BC1\u83B7\u53D6\u6D41\u7A0B\u5728\u672A\u6355\u83B7\u7684Authentication\u9875\uFF0C\u672A\u83B7\u53D6\u6216\u4F7F\u7528\u51ED\u636E\u3002"
},
"command": null,
"entry_url": "https://places-api.foursquare.com/places/search",
"kind": "http_api",
"method": "GET",
"request_example": {
"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"
},
"requirements": [
"\u9700\u9002\u5F53\u7684Foursquare Places API key/\u8D26\u53F7\u6743\u9650\uFF0C\u4EE5\u9875\u9762Bearer\u65B9\u5F0F\u8BA4\u8BC1\u3002",
"\u5FC5\u987B\u4F20X-Places-Api-Version\uFF0C\u672C\u9875\u5141\u8BB8\u503C/\u9ED8\u8BA4\u503C\u4E3A2025-06-17\u3002",
"\u663E\u5F0F\u9009\u62E9\u4F4D\u7F6E\u53EF\u907F\u514D\u9ED8\u8BA4IP bias\uFF1B\u672C\u6B21\u4E0D\u767B\u5F55\u3001\u8FD0\u884C\u4EA4\u4E92\u6D4B\u8BD5\u6216\u63D0\u4EA4\u67E5\u8BE2\u3002"
]
},
"limitations": [
"\u5E94\u4F7F\u7528\u672C\u9875\u660E\u786E\u7684\u65B0host/path\uFF0C\u4E0D\u4ECE\u65E7\u7248Foursquare\u8BB0\u5FC6\u8865/v3\u7B49\u5730\u5740\u3002",
"\u7701\u7565\u4F4D\u7F6E\u5C06\u6309IP bias\uFF1Bnear\u4E0D\u53EF\u5730\u7406\u7F16\u7801\u4F1A\u62A5\u9519\uFF0C\u77E9\u5F62\u9700ne\u548Csw\u914D\u5BF9\u3002",
"\u6307\u5B9Aopen_at/open_now\u65F6\u7F3A\u8425\u4E1A\u65F6\u95F4\u7684\u5730\u70B9\u4F1A\u88AB\u6392\u9664\uFF0C\u7ED3\u679C\u4E0D\u4EE3\u8868\u5168\u90E8\u8425\u4E1A\u573A\u6240\u3002",
"min_price/max_price\u76841\u20134\u8868\u793A\u5730\u70B9\u6D88\u8D39\u7B49\u7EA7\uFF0C\u4E0D\u662FAPI\u8D27\u5E01\u8D39\u7528\u3002",
"\u672C\u9875\u7F3A\u5B8C\u6574\u54CD\u5E94schema\u3001\u8BA1\u8D39\u3001\u901F\u7387/\u914D\u989D\u3001SLA\u4E0E\u6570\u636E\u4F7F\u7528\u6761\u6B3E\u3002"
],
"outputs": [
"\u6210\u529F200/application/json\u8FD4\u56DE\u5339\u914D\u5730\u70B9\uFF1Bfields\u53EF\u6307\u5B9A\u8FD4\u56DE\u5B57\u6BB5\uFF0C\u7701\u7565\u9ED8\u8BA4\u6240\u6709Pro Fields\u3002",
"\u5B8C\u6574\u8FD4\u56DE\u5B57\u6BB5\u6E05\u5355\u5728\u672A\u6355\u83B7\u7684Places Response Fields\u9875\uFF0C\u5F53\u524D\u6E32\u67D3\u9875\u65E0\u53EF\u6838\u5BF9\u7684\u6210\u529F\u5BF9\u8C61\u7ED3\u6784\u3002",
"400\u4E3A\u53C2\u6570\u9519\u8BEF\uFF0C401\u4E3A\u672A\u6388\u6743\uFF1B\u4E0D\u628ATry It\u7A7A\u54CD\u5E94\u6846\u5F53\u4F5C\u6D4B\u8BD5\u7ED3\u679C\u3002"
],
"pricing": {
"model": "unknown",
"notes": "Place Search\u53C2\u8003\u9875\u4EC5\u94FE\u63A5Pricing\uFF1BPro Fields/\u5730\u70B9\u4EF7\u683C\u8FC7\u6EE4\u4E0D\u6784\u6210API\u8D39\u7387\u6216\u514D\u8D39\u989D\u5EA6\u8BC1\u636E\u3002",
"source_url": "https://docs.foursquare.com/fsq-developers-places/reference/place-search"
},
"provider_claimed": false,
"record_kind": "public_source",
"representative_queries": [],
"sources": [
{
"basis": "official_documentation",
"checked_at": "2026-10-25T02:41:41.8285139\u002B08:00",
"title": "Place Search",
"url": "https://docs.foursquare.com/fsq-developers-places/reference/place-search"
}
],
"summary": "Foursquare \u5B98\u65B9 Place Search \u4F7F\u7528\u65B0\u7684 places-api.foursquare.com GET \u8DEF\u5F84\uFF0C\u9700 Bearer API key \u4E0E\u7248\u672C header\u3002\u53EF\u6309\u5173\u952E\u8BCD\u3001\u5750\u6807/\u5730\u533A\u3001\u5206\u7C7B\u548C\u8FDE\u9501\u54C1\u724C\u8FC7\u6EE4\uFF0C\u6700\u591A50\u6761\uFF1B\u5177\u4F53\u54CD\u5E94\u5B57\u6BB5\u3001\u8D39\u7528\u4E0E\u914D\u989D\u672A\u77E5\uFF0C\u672A\u67E5\u8BE2\u3002",
"tags": [
"http_api",
"documentation_only",
"places_search"
],
"terms_url": null,
"title": "Foursquare Places API\uFF1A\u5730\u70B9\u4E0E\u5468\u8FB9\u641C\u7D22",
"unknowns": [
"\u5B8C\u6574\u6210\u529F\u54CD\u5E94schema\u3001key\u83B7\u53D6/\u6743\u9650\u3001\u8D27\u5E01\u8D39\u7528\u3001\u6570\u503C\u9650\u6D41/\u914D\u989D\u53CASLA\u672A\u77E5\u3002",
"\u6570\u636E\u8986\u76D6/\u66F4\u65B0\u65F6\u95F4\u3001\u518D\u5229\u7528\u4E0E\u7F72\u540D\u6761\u6B3E\u3001\u65E5\u5FD7/\u4F4D\u7F6E\u4FDD\u7559\u672A\u9A8C\u8BC1\u3002"
],
"verification": {
"checked_at": "2026-10-24T18:41:41.8285139\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://docs.foursquare.com/fsq-developers-places/reference/place-search"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
},
"schema_version": "navonavo.capability.v1",
"service_id": "cap-22f8bf519866ac3e37ec81ac",
"version": 2,
"source_url": "https://docs.foursquare.com/fsq-developers-places/reference/place-search",
"ownership_state": "unclaimed",
"submitted_by": {
"kind": "importer",
"name": "NAVONAVO public material importer"
},
"submitter_identity_verified": false,
"source_check": {
"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"
]
},
"created_at": "2026-10-24T18:41:45.7860738\u002B00:00",
"updated_at": "2026-10-24T18:42:37.8199923\u002B00:00",
"read_url": "https://navonavo.com/api/v1/capabilities/cap-22f8bf519866ac3e37ec81ac?version=2",
"page_url": "https://navonavo.com/capabilities/cap-22f8bf519866ac3e37ec81ac?version=2",
"verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
"library_material": {
"organization": "organized",
"semantic_state": "classified",
"semantic_category": "\u5730\u70B9\u6570\u636E\uFF0FFoursquare POI \u4E0E\u5468\u8FB9\u573A\u6240\u68C0\u7D22",
"evidence_grade": "documentation_only",
"attachments": [
{
"material_id": "material-8be954ab53a82c8045c2b73cf2809fdb",
"source_url": "https://docs.foursquare.com/fsq-developers-places/reference/place-search",
"content_sha256": "6bfe86a3634b7d10fcbba133d02344fe2eaf7c013f567ac93936d3a2ebf1d6c3",
"decoded_bytes": 1245150,
"content_type": "text/html",
"captured_at": "2026-10-24T18:41:41.8285139\u002B00:00",
"text_representation": "decoded_text_utf8",
"text_utf8_sha256": "6bfe86a3634b7d10fcbba133d02344fe2eaf7c013f567ac93936d3a2ebf1d6c3",
"text_utf8_bytes": 1245150,
"capture_body_reconstructed": true,
"read_path": "/api/v1/capabilities/cap-22f8bf519866ac3e37ec81ac/materials/material-8be954ab53a82c8045c2b73cf2809fdb?version=1"
}
]
},
"last_correction": {
"contribution_id": "contribution-00369713b14e4eddbfe30b12118f581c",
"reason": "\u4F9D\u636E\u672C\u6279Foursquare Place Search\u7684\u660E\u786EHTTPS\u65B0host/path\u3001Bearer/API keys\u30012025-06-17\u7248\u672Cheader\u53CA\u67E5\u8BE2\u9650\u5236\u6574\u7406\uFF0C\u79FB\u9664\u672A\u6574\u7406\u6807\u7B7E\u3002\u4EC5documentation_only\uFF0C\u4E0D\u8FD0\u884CTry It/\u67E5\u8BE2\u6216\u731C\u54CD\u5E94\u5B57\u6BB5\uFF1B\u8BA1\u8D39/schema/\u989D\u5EA6\u7F3A\u53E3\u4FDD\u6301\u672A\u77E5\u3002",
"source_urls": [
"https://docs.foursquare.com/fsq-developers-places/reference/place-search"
],
"reported_by": "contributor"
},
"version_read_basis": "archived_revision",
"deep_read": {
"schema_version": "navonavo.capability-read.v1",
"card_id": "cap-22f8bf519866ac3e37ec81ac",
"card_version": 2,
"selected_profile_id": null,
"state": "not_checked",
"review_state": null,
"read_url": "https://navonavo.com/api/v1/capabilities/cap-22f8bf519866ac3e37ec81ac?version=2",
"page_url": "https://navonavo.com/capabilities/cap-22f8bf519866ac3e37ec81ac?version=2",
"profiles": [],
"warnings": [
"\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
"\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
]
}
}