本文へスキップ

開発者向け

公開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で返されます。

ステータスコード意味
400VALIDATION_ERRORリクエストボディまたはクエリパラメータが不正です。
401UNAUTHORIZEDBearerトークンがない、または正しくありません。
404NOT_FOUND指定されたツールは存在しません。
422LOCALES_INCOMPLETE必須ロケールの項目が不足しているため、ツールを公開できません。
429RATE_LIMITEDレート制限を超えました。Retry-Afterの時間(約60秒)後に再試行してください。
503API_KEY_NOT_CONFIGUREDサーバーにPUBLISH_API_KEYが設定されておらず、書き込みは無効です。