SerpBase

API キーとレート制限

すべてのリクエストは API キーで認証され、アカウントの毎秒リクエスト数に数えられます。

キーの送り方

すべてのリクエストの X-API-Key ヘッダーにキーを入れます。URL 内のキーはプロキシやブラウザのログに残らないよう拒否されます。キーの作成・名前変更・失効はダッシュボードの API キーで行います。

BASH
curl https://api.serpbase.dev/account/credits \
  -H "X-API-Key: YOUR_API_KEY"

レート制限

上限を超えたリクエストは status 1029 と Retry-After ヘッダーで即座に拒否され、課金されません。各応答の X-RateLimit-Limit と X-RateLimit-Remaining で送信ペースを調整できます。

アカウント QPS の自動引き上げ

対象チャージの入金確認後、累計 USD に応じて QPS を最低 $3 → 2、$50 → 5、$100 → 10、$200 → 15、$1,000 → 50、$10,000 → 500 に引き上げます。$3 未満は変更なし。既存の高い上限は下げません。無制限ではありません。

対象となる累計チャージ額(USD)引き上げ後の最低 QPS
≥ $32 QPS
≥ $505 QPS
≥ $10010 QPS
≥ $20015 QPS
≥ $1,00050 QPS
≥ $10,000500 QPS

入金確認済みの USD credit_pack と auto_topup のみ対象です。サブスクリプション(Starter Boost 含む)、贈与、ギフトコードは対象外です。残高は累計 USD 支払額ではありません。USD 以外を換算せず USD として数えません。

同じアカウントの全キー、製品、ゲートウェイは一つの QPS 上限を共有します。キーを増やしても上限は増えません。

QPS 引き上げは入金確認後であり、決済画面から戻っただけでは反映されません。現在の上限はアカウントに表示されるサーバー報告値です。キーへの同期が遅れる場合があります。

アカウント残高

有効な API key が属するアカウントの現在のクレジット残高を取得します。このリクエストは検索クレジットを消費しません。

GET
0 credits
/account/credits

X-API-Key ヘッダーでキーを渡してください。URL クエリパラメータの API key は受け付けません。

BASH
curl https://api.serpbase.dev/account/credits \
  -H "X-API-Key: your_api_key"
JSON
{
  "status": 0,
  "credits": 12345,
  "permanent_credits": 10000,
  "expiring_credits": 2345,
  "expiring_expires_at": 1798761600
}

このエンドポイントはアカウントごとに毎分 60 回までです。expiring_expires_at は Unix 秒で、期限付きクレジットがない場合は 0 です。