API
API 执行的搜索与网站完全相同，并以数据形式返回结果：默认为 JSON，也支持 XML、CSV、TSV、NDJSON 和纯文本。所有操作都是只读的，不会创建或修改任何内容。
基础 URL
https://api.publicwww.com
一条命令即可上手
curl -H "Authorization: Bearer $KEY" \
"https://api.publicwww.com/v1/search?query=%22angular.min.js%22&per_page=3"
{
"query": "\"angular.min.js\"",
"page": 1,
"per_page": 3,
"total": 278,
"total_pages": 93,
"returned": 3,
"truncated": false,
"took_ms": 2,
"results": [
{ "domain": "imgbox.com", "url": "https://imgbox.com/", "rank": 4187, "ranked": true }
]
}
接口
| 接口 | 方法 | 功能 |
|---|---|---|
/v1/search |
GET, POST | 执行搜索。参见参数、格式。 |
/v1/account |
GET | 套餐、配额与限额。不消耗任何配额。 |
/mcp |
POST | 面向 AI 助手和智能体的 MCP 服务器：以工具形式提供同样的搜索，使用同一个令牌。 |
/ |
GET | API 的自描述信息，包括错误码。无需令牌。 |
/openapi.json |
GET | 以 OpenAPI 3.1 描述形式提供的同样内容，可导入 Postman、n8n、Make、Power Automate 等工具。无需令牌。 |
没有单独的导出接口。批量获取就是使用较大 per_page 的 /v1/search，付费套餐最多可达一百万行；响应会边生成边以流式返回。
我们的承诺
-
绝不悄悄削减结果。在浏览器中，每日配额用完后，网站会默默退回免费版的限制，显示更少的结果。脚本察觉不到这种变化，因此在 API 中这会直接返回错误
429 quota_exceeded，而不是返回一个看似完整、实则不全的结果。 -
不完整的结果会明确标出：在所有格式中，响应体里都有
truncated，响应头里都有X-Truncated。 -
无排名的网站会如实说明：返回
rank: null和ranked: false，绝不使用可能被客户端误认为真实（且非常大）排名的内部占位值。 -
告诉您等待，好过让您干等。请求过快时，会立即返回带有
Retry-After的响应，而不是一直占用连接。
获取令牌
在您的个人中心生成令牌，或让应用通过 OAuth 2.1 为您获取。使用 API 需要付费套餐，详见价格。调用旧版 ?export= URL 的现有脚本无需修改即可继续使用，详见旧版导出 URL。