SerpBase

Chaves de API e limites

Cada solicitação é autenticada com uma chave de API e conta para as solicitações por segundo da sua conta.

Como enviar a chave

Coloque a chave no cabeçalho X-API-Key de cada solicitação. Chaves na URL são recusadas para não irem parar em logs de proxy ou navegador. Crie, renomeie e revogue chaves na página Chaves de API do painel.

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

Limites de solicitações

Uma solicitação acima do limite é recusada na hora com status 1029 e um cabeçalho Retry-After, sem cobrança. X-RateLimit-Limit e X-RateLimit-Remaining em cada resposta ajudam seu cliente a controlar o ritmo.

Aumentos automáticos de QPS

Após confirmar o crédito, o total elegível USD eleva QPS no mínimo a: $3 → 2, $50 → 5, $100 → 10, $200 → 15, $1,000 → 50, $10,000 → 500. Abaixo de $3 não altera o limite. Nunca reduz um limite superior; não é ilimitado.

Recargas elegíveis acumuladas (USD)QPS mínimo após o aumento
≥ $32 QPS
≥ $505 QPS
≥ $10010 QPS
≥ $20015 QPS
≥ $1,00050 QPS
≥ $10,000500 QPS

Só contam pagamentos USD credit_pack e auto_topup com crédito confirmado. Excluem-se assinaturas (incluindo Starter Boost), presentes e códigos. Saldo não equivale a pagamentos USD acumulados. Outras moedas não contam como USD sem conversão.

Todas as chaves, produtos e gateways da conta compartilham um limite QPS. Criar mais chaves não o aumenta.

O aumento ocorre após confirmar o crédito, não só ao voltar do pagamento. O limite atual é informado pelo servidor na conta; a sincronização das chaves pode demorar.

Saldo da conta

Consulta o saldo atual de créditos da conta associada a uma API key ativa. Esta solicitação não consome créditos de pesquisa.

GET
0 credits
/account/credits

Envie a chave no cabeçalho X-API-Key. API keys em parâmetros da URL não são aceitas.

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
}

O endpoint é limitado a 60 solicitações por minuto por conta. expiring_expires_at é um timestamp Unix em segundos e vale 0 quando não há créditos temporários ativos.