开发者
公开 API 以程序化方式管理工具收录。写接口按 IP 限制为每分钟 60 次。
面向 AI agent 的只读 API 公开、匿名、只读。这些接口以稳定的 JSON 返回站内已发布的工具,按 IP 限流 120 次 / 60 秒。
无需 API key 或 Bearer 令牌:请勿在此处传发布密钥。
GET https://www.getsitools.com/api/public/tools分页、排序,并可按分类或标签筛选已发布工具。 GET https://www.getsitools.com/api/public/tools/{slug}按 slug 获取单个工具,含截图、产品支持语言与语种覆盖情况。 GET https://www.getsitools.com/api/public/categories某个语种下的分类树,附已发布工具数。
示例 复制 curl 'https://www.getsitools.com/api/public/tools?q=image%20editing&pageSize=5&locale=en' \
-H 'Accept: application/json'openapi.json — OpenAPI 3.1 描述llms.txt — llms.txt —— 给 AI agent 的站点摘要llms-full.txt — llms-full.txt —— 全部已发布工具及一句话简介鉴权 仅写接口需要鉴权。只读 API 公开无需密钥。
Authorization: Bearer <PUBLISH_API_KEY>
在服务端配置 PUBLISH_API_KEY。未配置时,API 会返回 503,而不会接受未鉴权的写入。
限流规则 限流按 IP 和路由作用域独立计算。读接口与写接口使用不同的令牌桶,因此大量读取不会耗尽写入额度。
读接口: 120 / 60s
写接口: 60 / 60s
所有响应都会返回 RateLimit-Limit、RateLimit-Remaining 和 RateLimit-Reset。触发 429 时还会返回 Retry-After。
接口列表 以下示例使用 PUBLISH_API_KEY。请将工具 ID 占位符替换为提交接口返回的工具 ID。
POST /api/v1/tools/submit-url
提交网址 只需提交一个网址,采集端会自动抓取网站元数据、翻译并发布。整个过程免费审核,无需人工干预。
仅支持核心 AI 工具的 HTTP/HTTPS 网址,aiOnlyConfirmed 必须为 true。返回 queued 表示网址已成功进入采集队列。
请求 复制 curl -X POST 'https://www.getsitools.com/en/api/v1/tools/submit-url' \
-H 'Authorization: Bearer $PUBLISH_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"url": "https://example.com",
"aiOnlyConfirmed": true
}'
响应 复制 {
"id": "submission_abc123",
"submissionId": "submission_abc123",
"status": "queued",
"duplicate": false,
"message": "URL submitted successfully. The collector will scrape and process it automatically."
}错误响应 错误以 JSON 返回,包含稳定的错误码和可读的错误信息。
状态码 错误码 含义 400 VALIDATION_ERROR 请求体或查询参数不合法。 401 UNAUTHORIZED Bearer Token 缺失或不正确。 404 NOT_FOUND 请求的工具不存在。 422 LOCALES_INCOMPLETE 必填语言字段缺失,工具暂时无法发布。 429 RATE_LIMITED 请求超过限流阈值,请在 Retry-After 指定的时间(约 60 秒)后重试。 503 API_KEY_NOT_CONFIGURED 服务端未配置 PUBLISH_API_KEY,写入接口已禁用。