快速回答
如何用面向 AI agent 的 Web 搜索 API 运行我的第一次搜索?
将你的问题发送到 POST https://llmwebsearch.com/api/v1/search,并把 API 密钥作为 Bearer token。LLMWebSearch 会运行实时 Web 搜索并返回最多 20 条排序结果,其中前 3 个页面会被读取并以 Markdown 返回。一次调用消耗 1 积分,自 2026 年 10 月起 US$1.20/千次搜索 起。无需 KYC;用加密货币支付。
一张卡片了解 API
| Base URL | https://llmwebsearch.com/api/v1 |
|---|---|
| 搜索 | POST 或 GET https://llmwebsearch.com/api/v1/search |
| 读取你已有的 URL | POST https://llmwebsearch.com/api/v1/extract |
| 剩余积分 | GET https://llmwebsearch.com/api/v1/credits,免费 |
| 身份验证 | 将 API 密钥作为 Bearer token 放在 Authorization 请求头中传入,或作为 api_key 查询参数传入 |
| 计费 | 1 积分支付一次查询:最多 20 条排名结果,其中前 3 条的页面会被读取并以 Markdown 返回。读取 4 到 10 个页面为 2 积分。以错误结束的调用不收费 |
| 我们的网页读取器 | LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/),robots.txt token LLMWebSearch |
| 最小积分包 | 5,000 次搜索 兑换 US$9.25;积分永不过期 |
如何获取 API 密钥?
没有注册表单。等待区块链确认你的充值是最耗时的环节。
用加密货币充值余额
至少发送 US$25(BTC, USDT, USDC, ETH, SOL, LTC)。用账号编号登录;电子邮箱地址为选填。
购买搜索积分包
5,000 次搜索 兑换 US$9.25 足够你把搜索接入一个 agent 并试遍所有选项。
复制密钥
你的加密货币充值一经确认并购买了积分包,API 密钥就在控制面板中等着你。把它保存在名为
LLMWEBSEARCH_API_KEY的环境变量中。
第一次搜索是什么样的?
它就是一个 HTTPS POST,请求体是一小段 JSON。只有 q 是必填的:问题或关键词,按人们平常输入的方式写即可。默认值已经适合大多数 agent。你会得到 5 条排序结果,前 3 条结果对应的页面会被读取,并以 Markdown 形式返回,每页最多 6,000 个字符。
下面三段代码发送的是同一个搜索。挑一个与你的技术栈匹配的,在 shell 中设置 LLMWEBSEARCH_API_KEY,然后运行它。
curl -s "https://llmwebsearch.com/api/v1/search" \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "how to rotate api keys without downtime", "max_results": 5, "read": 3}'import os
import requests
resp = requests.post(
"https://llmwebsearch.com/api/v1/search",
headers={"Authorization": "Bearer " + os.environ["LLMWEBSEARCH_API_KEY"]},
json={"q": "how to rotate api keys without downtime", "max_results": 5, "read": 3},
timeout=60,
)
resp.raise_for_status()
data = resp.json()
print("credits used:", data["credits_used"])
for r in data["results"]:
size = r.get("word_count", 0)
print(r["position"], r["title"], r["url"], r["content_status"], size, "words")
const res = await fetch('https://llmwebsearch.com/api/v1/search', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.LLMWEBSEARCH_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ q: 'how to rotate api keys without downtime', max_results: 5, read: 3 }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
const first = data.results.find((r) => r.content_status === 'ok');
console.log(first ? `${first.title}\n${first.url}\n\n${first.content.slice(0, 600)}` : 'No page could be read.');
返回什么?
一个 JSON 对象,包含你的 query、调用时间(created_at)、价格(credits_used),以及按排序排列的 results 数组。每条结果都有其 position、title、url、host 和 snippet,日期已知时还会有 published_at。
需要关注的字段是 content_status。当它显示 ok 时,页面已被读取,正文位于 content,并带有 word_count。超出 read 的结果显示 not_requested。无法读取的页面会说明原因,例如 blocked_by_robots。响应格式页面解释了每个字段。
我最常改动哪些参数?
六个参数几乎覆盖所有 agent。它们全部是可选的。
| 参数 | 改变什么 |
|---|---|
max_results | 返回多少条排序结果,1 到 20 |
read | 读取前多少条结果,0 到 10 |
max_chars | 每个页面内容的长度上限,500 到 50,000 个字符 |
topic 和 time_range | 用新闻代替网页,以及时效窗口 |
include_domains | 只返回你列出的网站的结果 |
country 和 language | 搜索在何处、以何种语言运行 |
搜索参考为每个参数配有示例,还包括 format 和 exclude_domains。
一次调用消耗多少积分?
大多数调用消耗 1 个积分。完整规则如下:
- 搜索读取 0 到 3 个页面:1 积分。 包含最多 20 条排序结果。
- 搜索读取 4 到 10 个页面:2 积分。
- 网页转 Markdown: 读取你已持有 URL 的页面:每开始一组 3 个返回内容的页面计 1 积分,每次调用最多 20 个 URL;被拒绝或失败的 URL 不计入。
- 错误:0 积分。 参数错误、密钥错误、余额为空或搜索失败都不收费。
- 成功搜索中无法读取的页面不影响其价格。
- 用
GET https://llmwebsearch.com/api/v1/credits查看余额是免费的。
查询积分永不过期:这个月没用完的,明年还在。
网站不希望被读取时会发生什么?
结果仍会出现,带有标题、URL 和摘要,但不含页面内容。我们的读取器遵守 robots.txt:它会以 LLMWebSearch 表明身份,遵守网站为它或为所有机器人写下的规则,并排除任何它无权读取的页面内容。在 robots.txt 中设置 Content-Signal: ai-input=no 的网站,其页面内容不会出现在你的结果中。
当网站对我们的读取器给出拒绝响应时,结果会带有 content_status: "target_refused" 以及网站自身的 HTTP 状态码(target_status)。当网站拒绝我们的读取器时,结果会不带内容返回,并附上该网站的状态:我们绝不破解 CAPTCHA、不登录账户,也不绕过封锁或付费墙。错误页面列出了所有状态码以及哪些值得重试。
接下来去哪里?
- 搜索 endpoint /search 的每个参数,附示例
- 提取 endpoint 读取你已有的 1 到 20 个 URL
- 响应格式 每个字段及所有 content_status
- 错误 HTTP 错误、页面状态、重试规则
- Python requests、async httpx、带引用的回答
- Node.js fetch、一个小连接池、同样的引用循环
- curl 和 jq 终端食谱
- MCP server 适用于 Claude Code 和 Claude Desktop 的 search_web
- LangChain 和 LlamaIndex 工具与检索器
- OpenAI function calling 工具 schema、循环与 Agents SDK
- n8n 用于 AI Agent 的 HTTP Request 工具
- OpenClaw 通过 MCP 使用我们的搜索
快速开始:常见问题
我需要 SDK 吗?
不需要。LLMWebSearch 是一个普通的 HTTPS API,所以任何 HTTP 客户端都能用。这些文档提供了 Python、Node.js 和 curl 的可复制粘贴代码,以及 MCP、LangChain、LlamaIndex、OpenAI function calling、n8n 和 OpenClaw 的工具定义。我们不发布任何包。
API 会替我把答案写好吗?
不会。API 返回的是来源,而不是写好的答案:由你自己的模型读取页面、撰写回复并引用 URL。这样可以让你自由选择模型、提示词和引用格式。
我可以把密钥放在 URL 里吗?
可以,作为 GET /search 的 api_key 查询参数。Authorization 请求头是更安全的选择,因为 URL 会出现在日志和 shell 历史记录中。为每个 agent、应用或团队成员各建一个 API 密钥,并可在控制面板中吊销其中任意一个,而不影响其他密钥。
有免费额度可以试用吗?
没有。没有免费套餐:5,000 次查询积分包是试用方式,用最低充值金额即可购买;仅为达到该最低金额而多充的部分,可在 30 天内按要求以 USDT 或 USDC 退回,前提是尚未使用。