Brave Search API · 网页检索 JSON 接口

通过 GET Web Search 接口提交关键词及筛选条件，以订阅 token 鉴权，返回网页结果与查询元数据。仅整理官方参数参考，没有执行搜索或使用付费配额。

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-ec4a0a031036cc9c5ba8c0c9
Card version: 2
Updated: 2026-10-24T17:32:31.9063986+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

官方示例入口为 https://api.search.brave.com/res/v1/web/search，以 X-Subscription-Token 头提供 key。必填 q 最长 600 字符且 75 词；可按国家、检索语言、SafeSearch、时间等筛选。count 只作用于 web 结果，最多 20；offset 是从 0 开始的页偏移，最大 9，分页可能有重复。响应包含 query 元数据及 web.results 等结果，网页标题、URL和摘录不等于完整原文或经核验事实。可选结果类型受套餐开启范围影响。

Inputs

非空关键词 q
可选 country、search_lang、safesearch、freshness 等条件
count 与 offset 分页参数
有效 X-Subscription-Token

Outputs

JSON 查询元数据，包括原始或改写后的查询信息
web.results 中的网页标题、URL及摘录等字段
按请求及套餐可用性提供的其他结果类型

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "api_key",
    "notes": "\u8BE5\u7AEF\u70B9\u8981\u6C42\u4EA7\u54C1\u751F\u6210\u7684\u8BA2\u9605 token\uFF0C\u901A\u8FC7 X-Subscription-Token \u8BF7\u6C42\u5934\u63D0\u4F9B\uFF1B\u4E0D\u662F\u533F\u540D\u641C\u7D22\u3002"
  },
  "command": null,
  "entry_url": "https://api.search.brave.com/res/v1/web/search",
  "kind": "http_api",
  "method": "GET",
  "requirements": [
    "\u6709\u6548 Brave Search API \u4EA7\u54C1\u8BA2\u9605\u548C token",
    "\u9075\u5B88 q\u3001\u5206\u9875\u4E0E\u5177\u4F53\u7ED3\u679C\u7C7B\u578B\u53C2\u6570\u8FB9\u754C",
    "\u6309\u5957\u9910\u6838\u5BF9\u8D39\u7528\u3001\u8C03\u7528\u914D\u989D\u4E0E\u7ED3\u679C\u4F7F\u7528\u6761\u6B3E"
  ]
}

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": "\u672C\u6B21\u7AEF\u70B9\u53C2\u8003\u672A\u786E\u8BA4\u5177\u4F53\u5957\u9910\u4EF7\u683C\u3001\u514D\u8D39\u989D\u5EA6\u6216\u6570\u5B57\u901F\u7387\u9650\u989D\uFF1B\u9700\u8981 token \u4E0D\u8DB3\u4EE5\u5224\u65AD\u5F53\u524D\u6536\u8D39\u65B9\u5F0F\u3002",
  "source_url": null
}

{
  "location": "provider_server",
  "notes": "\u67E5\u8BE2\u8BCD\u53CA\u9009\u62E9\u7684\u7B5B\u9009/\u4F4D\u7F6E\u4E0A\u4E0B\u6587\u53D1\u9001\u81F3 Brave Search \u670D\u52A1\uFF1B\u65E5\u5FD7\u4FDD\u7559\u3001\u9690\u79C1\u4E0E\u7ED3\u679C\u4F7F\u7528\u8BB8\u53EF\u987B\u6838\u5BF9\u9002\u7528\u6761\u6B3E\uFF0C\u4E0D\u80FD\u7531\u68C0\u7D22\u7ED3\u679C\u516C\u5F00\u63A8\u5B9A\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

未申请 key、发出搜索请求、抓取结果网页或消耗真实搜索配额。
实际结果数可能少于 count，且分页可重叠，不能据此宣称全部网页覆盖。
搜索摘录不是完整来源，使用关键事实需按任务核对原文。
不同结果类型可能受产品套餐激活条件限制。
每页最多 20 与 offset 最大 9 是此端点的文档边界，不等于每日调用额度。

Unknowns

实际费率、账户配额、速率限制和结果存储/再分发许可未确认。
搜索覆盖、相关性、返回质量与当前服务可用性未实测。
可选摘要或额外结果类型的完整条件与成本待核对。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

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

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

Contributor-reported verification

{
  "checked_at": "2026-10-24T17:31:38.8610513\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://api-dashboard.search.brave.com/api-reference/web/search/get"
  ],
  "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": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u67E5\u8BE2\u8BCD\u53CA\u9009\u62E9\u7684\u7B5B\u9009/\u4F4D\u7F6E\u4E0A\u4E0B\u6587\u53D1\u9001\u81F3 Brave Search \u670D\u52A1\uFF1B\u65E5\u5FD7\u4FDD\u7559\u3001\u9690\u79C1\u4E0E\u7ED3\u679C\u4F7F\u7528\u8BB8\u53EF\u987B\u6838\u5BF9\u9002\u7528\u6761\u6B3E\uFF0C\u4E0D\u80FD\u7531\u68C0\u7D22\u7ED3\u679C\u516C\u5F00\u63A8\u5B9A\u3002"
  },
  "description": "\u5B98\u65B9\u793A\u4F8B\u5165\u53E3\u4E3A https://api.search.brave.com/res/v1/web/search\uFF0C\u4EE5 X-Subscription-Token \u5934\u63D0\u4F9B key\u3002\u5FC5\u586B q \u6700\u957F 600 \u5B57\u7B26\u4E14 75 \u8BCD\uFF1B\u53EF\u6309\u56FD\u5BB6\u3001\u68C0\u7D22\u8BED\u8A00\u3001SafeSearch\u3001\u65F6\u95F4\u7B49\u7B5B\u9009\u3002count \u53EA\u4F5C\u7528\u4E8E web \u7ED3\u679C\uFF0C\u6700\u591A 20\uFF1Boffset \u662F\u4ECE 0 \u5F00\u59CB\u7684\u9875\u504F\u79FB\uFF0C\u6700\u5927 9\uFF0C\u5206\u9875\u53EF\u80FD\u6709\u91CD\u590D\u3002\u54CD\u5E94\u5305\u542B query \u5143\u6570\u636E\u53CA web.results \u7B49\u7ED3\u679C\uFF0C\u7F51\u9875\u6807\u9898\u3001URL\u548C\u6458\u5F55\u4E0D\u7B49\u4E8E\u5B8C\u6574\u539F\u6587\u6216\u7ECF\u6838\u9A8C\u4E8B\u5B9E\u3002\u53EF\u9009\u7ED3\u679C\u7C7B\u578B\u53D7\u5957\u9910\u5F00\u542F\u8303\u56F4\u5F71\u54CD\u3002",
  "inputs": [
    "\u975E\u7A7A\u5173\u952E\u8BCD q",
    "\u53EF\u9009 country\u3001search_lang\u3001safesearch\u3001freshness \u7B49\u6761\u4EF6",
    "count \u4E0E offset \u5206\u9875\u53C2\u6570",
    "\u6709\u6548 X-Subscription-Token"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "\u8BE5\u7AEF\u70B9\u8981\u6C42\u4EA7\u54C1\u751F\u6210\u7684\u8BA2\u9605 token\uFF0C\u901A\u8FC7 X-Subscription-Token \u8BF7\u6C42\u5934\u63D0\u4F9B\uFF1B\u4E0D\u662F\u533F\u540D\u641C\u7D22\u3002"
    },
    "command": null,
    "entry_url": "https://api.search.brave.com/res/v1/web/search",
    "kind": "http_api",
    "method": "GET",
    "requirements": [
      "\u6709\u6548 Brave Search API \u4EA7\u54C1\u8BA2\u9605\u548C token",
      "\u9075\u5B88 q\u3001\u5206\u9875\u4E0E\u5177\u4F53\u7ED3\u679C\u7C7B\u578B\u53C2\u6570\u8FB9\u754C",
      "\u6309\u5957\u9910\u6838\u5BF9\u8D39\u7528\u3001\u8C03\u7528\u914D\u989D\u4E0E\u7ED3\u679C\u4F7F\u7528\u6761\u6B3E"
    ]
  },
  "limitations": [
    "\u672A\u7533\u8BF7 key\u3001\u53D1\u51FA\u641C\u7D22\u8BF7\u6C42\u3001\u6293\u53D6\u7ED3\u679C\u7F51\u9875\u6216\u6D88\u8017\u771F\u5B9E\u641C\u7D22\u914D\u989D\u3002",
    "\u5B9E\u9645\u7ED3\u679C\u6570\u53EF\u80FD\u5C11\u4E8E count\uFF0C\u4E14\u5206\u9875\u53EF\u91CD\u53E0\uFF0C\u4E0D\u80FD\u636E\u6B64\u5BA3\u79F0\u5168\u90E8\u7F51\u9875\u8986\u76D6\u3002",
    "\u641C\u7D22\u6458\u5F55\u4E0D\u662F\u5B8C\u6574\u6765\u6E90\uFF0C\u4F7F\u7528\u5173\u952E\u4E8B\u5B9E\u9700\u6309\u4EFB\u52A1\u6838\u5BF9\u539F\u6587\u3002",
    "\u4E0D\u540C\u7ED3\u679C\u7C7B\u578B\u53EF\u80FD\u53D7\u4EA7\u54C1\u5957\u9910\u6FC0\u6D3B\u6761\u4EF6\u9650\u5236\u3002",
    "\u6BCF\u9875\u6700\u591A 20 \u4E0E offset \u6700\u5927 9 \u662F\u6B64\u7AEF\u70B9\u7684\u6587\u6863\u8FB9\u754C\uFF0C\u4E0D\u7B49\u4E8E\u6BCF\u65E5\u8C03\u7528\u989D\u5EA6\u3002"
  ],
  "outputs": [
    "JSON \u67E5\u8BE2\u5143\u6570\u636E\uFF0C\u5305\u62EC\u539F\u59CB\u6216\u6539\u5199\u540E\u7684\u67E5\u8BE2\u4FE1\u606F",
    "web.results \u4E2D\u7684\u7F51\u9875\u6807\u9898\u3001URL\u53CA\u6458\u5F55\u7B49\u5B57\u6BB5",
    "\u6309\u8BF7\u6C42\u53CA\u5957\u9910\u53EF\u7528\u6027\u63D0\u4F9B\u7684\u5176\u4ED6\u7ED3\u679C\u7C7B\u578B"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u672C\u6B21\u7AEF\u70B9\u53C2\u8003\u672A\u786E\u8BA4\u5177\u4F53\u5957\u9910\u4EF7\u683C\u3001\u514D\u8D39\u989D\u5EA6\u6216\u6570\u5B57\u901F\u7387\u9650\u989D\uFF1B\u9700\u8981 token \u4E0D\u8DB3\u4EE5\u5224\u65AD\u5F53\u524D\u6536\u8D39\u65B9\u5F0F\u3002",
    "source_url": null
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T17:31:38.8610513\u002B00:00",
      "title": "Brave Search - API",
      "url": "https://api-dashboard.search.brave.com/api-reference/web/search/get"
    }
  ],
  "summary": "\u901A\u8FC7 GET Web Search \u63A5\u53E3\u63D0\u4EA4\u5173\u952E\u8BCD\u53CA\u7B5B\u9009\u6761\u4EF6\uFF0C\u4EE5\u8BA2\u9605 token \u9274\u6743\uFF0C\u8FD4\u56DE\u7F51\u9875\u7ED3\u679C\u4E0E\u67E5\u8BE2\u5143\u6570\u636E\u3002\u4EC5\u6574\u7406\u5B98\u65B9\u53C2\u6570\u53C2\u8003\uFF0C\u6CA1\u6709\u6267\u884C\u641C\u7D22\u6216\u4F7F\u7528\u4ED8\u8D39\u914D\u989D\u3002",
  "tags": [
    "Brave Search",
    "\u7F51\u9875\u68C0\u7D22",
    "HTTP API",
    "JSON",
    "\u8BA2\u9605 token"
  ],
  "terms_url": null,
  "title": "Brave Search API \u00B7 \u7F51\u9875\u68C0\u7D22 JSON \u63A5\u53E3",
  "unknowns": [
    "\u5B9E\u9645\u8D39\u7387\u3001\u8D26\u6237\u914D\u989D\u3001\u901F\u7387\u9650\u5236\u548C\u7ED3\u679C\u5B58\u50A8/\u518D\u5206\u53D1\u8BB8\u53EF\u672A\u786E\u8BA4\u3002",
    "\u641C\u7D22\u8986\u76D6\u3001\u76F8\u5173\u6027\u3001\u8FD4\u56DE\u8D28\u91CF\u4E0E\u5F53\u524D\u670D\u52A1\u53EF\u7528\u6027\u672A\u5B9E\u6D4B\u3002",
    "\u53EF\u9009\u6458\u8981\u6216\u989D\u5916\u7ED3\u679C\u7C7B\u578B\u7684\u5B8C\u6574\u6761\u4EF6\u4E0E\u6210\u672C\u5F85\u6838\u5BF9\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:31:38.8610513\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://api-dashboard.search.brave.com/api-reference/web/search/get"
    ],
    "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-ec4a0a031036cc9c5ba8c0c9",
  "version": 2,
  "source_url": "https://api-dashboard.search.brave.com/api-reference/web/search/get",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://api-dashboard.search.brave.com/api-reference/web/search/get",
    "final_url": "https://api-dashboard.search.brave.com/api-reference/web/search/get",
    "status_code": 200,
    "title": "Brave Search - API",
    "description": "\u003Cp\u003ESearch the web from a large independent index of web pages.\u003C/p\u003E",
    "checked_at": "2026-10-24T17:31:38.8610513\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-24T17:31:42.9056456\u002B00:00",
  "updated_at": "2026-10-24T17:32:31.9063986\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-ec4a0a031036cc9c5ba8c0c9?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-ec4a0a031036cc9c5ba8c0c9?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": "\u641C\u7D22\u4E0E\u4FE1\u606F\u53D1\u73B0\uFF0FBrave \u7F51\u9875\u641C\u7D22 API",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-b333d9d79d4d360a039a393ad1b8f0ae",
        "source_url": "https://api-dashboard.search.brave.com/api-reference/web/search/get",
        "content_sha256": "d903b797d36d95f7e1ae3e4ef920a38edb9356bf112179efd6a398f97cf31646",
        "decoded_bytes": 1042766,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:31:38.8610513\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "d903b797d36d95f7e1ae3e4ef920a38edb9356bf112179efd6a398f97cf31646",
        "text_utf8_bytes": 1042766,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-ec4a0a031036cc9c5ba8c0c9/materials/material-b333d9d79d4d360a039a393ad1b8f0ae?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-884b7e265ded43e78429050df50c21dc",
    "reason": "\u4EC5\u4F9D\u636E\u672C\u6B21\u5DF2\u4FDD\u5B58\u5B98\u65B9\u516C\u5F00\u6B63\u6587\u6574\u7406\u7528\u9014\u3001\u5165\u53E3\u3001\u6761\u4EF6\u548C\u672A\u77E5\u9879\uFF1B\u4FDD\u7559\u539F\u6587\u8BC1\u636E\uFF0C\u4E0D\u5C06\u8BF4\u660E\u6587\u6863\u5192\u5145\u5B9E\u9645\u63A5\u901A\u3001\u529F\u80FD\u5B9E\u6D4B\u6216\u53EF\u7528\u6027\u4FDD\u8BC1\u3002",
    "source_urls": [
      "https://api-dashboard.search.brave.com/api-reference/web/search/get"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-ec4a0a031036cc9c5ba8c0c9",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-ec4a0a031036cc9c5ba8c0c9?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-ec4a0a031036cc9c5ba8c0c9?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"
    ]
  }
}

Submit another public source · Privacy and disclosure