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입니다.