開発者向け
公開API ツールの掲載情報をプログラムから管理できます。書き込み系エンドポイントは1 IPあたり60リクエスト/分に制限されています。
AIエージェント向け読み取りAPI 公開・匿名・読み取り専用のAPIです。サイトに掲載中の公開ツールを安定したJSONで取得でき、IPごとに60秒あたり120リクエストまで利用できます。
APIキーやBearerトークンは不要です。公開キーはここに送らないでください。
GET https://www.getsitools.com/api/public/tools公開ツールの一覧・検索。ページ送り、並べ替え、カテゴリ・タグ絞り込みに対応しています。 GET https://www.getsitools.com/api/public/tools/{slug}slugで1件のツールを取得。スクリーンショット、対応言語、ロケール対応状況を含みます。 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エージェント向けのサイト概要llms-full.txt — llms-full.txt - 公開ツールを1行概要付きですべて収録認証 すべてのリクエストで、Bearerトークンとして公開キーを送信してください。キーはサーバー側で保管し、クライアント側のコードに含めないでください。
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
URLを送信 URLだけで申請できます。収集システムがサイト情報を取得し、翻訳して公開します。無料審査で、手動対応は不要です。
HTTP/HTTPSのURLのみ対応しています。キュー登録の応答は、収集キューに受け付けられたことを意味します。
リクエスト コピー 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トークンがない、または正しくありません。 404 NOT_FOUND 指定されたツールは存在しません。 422 LOCALES_INCOMPLETE 必須ロケールの項目が不足しているため、ツールを公開できません。 429 RATE_LIMITED レート制限を超えました。Retry-Afterの時間(約60秒)後に再試行してください。 503 API_KEY_NOT_CONFIGURED サーバーにPUBLISH_API_KEYが設定されておらず、書き込みは無効です。