相場検索 API

エンドポイント

https://asia-northeast1-sokumise-souba.cloudfunctions.net/soubaSearchApi

GET — クエリパラメータ q（必須）、limit（任意・1〜20、既定 10）

例: https://asia-northeast1-sokumise-souba.cloudfunctions.net/soubaSearchApi?q=%E3%83%9D%E3%82%B1%E3%83%A2%E3%83%B3%E3%82%AB%E3%83%BC%E3%83%89&limit=5

レスポンス（概要）

{
  "items": [
    {
      "id": "pokemon-charizard-ex",
      "name": "…",
      "categoryLabel": "ポケモンカード",
      "avgYen": 12000,
      "highYen": 15000,
      "lowYen": 9000,
      "url": "https://…/souba/pokemon-charizard-ex"
    }
  ]
}

レート制限（IP 単位・JST）

• 公開利用: 60 リクエスト/時、500 リクエスト/日
• 応答ヘッダー: X-RateLimit-Remaining-Hour、X-RateLimit-Remaining-Day、X-RateLimit-Reset
• 超過時: HTTP 429 + Retry-After

API キー（任意・緩和枠）

ヘッダー X-Souba-Api-Key または X-Api-Key に運営者発行のキーを付与すると、600 リクエスト/時・10000 リクエスト/日の緩和枠が適用されます。

キーの発行・有料プランについては サイト運営者へのお問い合わせにて承ります（ベータ枠）。

🪙 AI エージェント・暗号資産マイクロペイメント (x402 / HTTP 402)

自律型 AI エージェント（Autonomous Trading Bots / RAG クローラー）による大量・商用データ取得には、HTTP 402 Payment Required 規格および暗号資産（USDC on Base / Solana / EVM）による従量課金プロトコルをサポートしています。

利用上の注意

• 相場は参考情報です。再配布・大量スクレイピングは禁止です（利用規約参照）。
• 引用時は各アイテム URL へのリンクを推奨します。
• 引用時は機械可読な全文は llms.txt も参照してください。