Erros e limites
Créditos
Seção intitulada “Créditos”| Evento | Cobrado? |
|---|---|
| Requisição bem-sucedida (HTTP 200) | 1 crédito |
Sucesso com renderização habilitada (render_js=1) | 1 crédito |
| Requisição com falha (timeouts, erros de conexão) | 0 créditos |
| HTTP 4xx ou 5xx do destino | 0 créditos |
| Novas tentativas dentro de uma chamada | Contadas como a chamada principal única |
Você é cobrado apenas por respostas que chegam até você com status 2xx e corpo não vazio.
Concorrência
Seção intitulada “Concorrência”| Plano | Máximo de requisições simultâneas |
|---|---|
| Starter | 20 |
| Growth | 50 |
| Business | 100 |
| Enterprise | 500 |
Requisições acima do limite retornam 429 Too Many Requests. Aguarde com atraso exponencial e tente novamente.
Códigos de erro
Seção intitulada “Códigos de erro”| Status | Significado | O que fazer |
|---|---|---|
200 | Sucesso, corpo da resposta anexado | Processar normalmente |
400 | Requisição inválida (parâmetros malformados) | Corrija o parâmetro extract_rules ou url |
401 | api_key inválida ou ausente | Verifique a chave no painel |
403 | O plano não permite esse recurso | Faça upgrade ou remova a flag (ex.: premium_proxy no Starter) |
408 | O site de destino atingiu o tempo limite | Tente novamente com um timeout= maior, ou opções mais simples |
422 | Falha na renderização (falha de JS, erro de navegação) | Tente novamente; verifique se o site funciona em um navegador real |
429 | Limite de concorrência excedido | Aguarde e tente novamente |
500 | Erro interno do Shifter | Tente novamente após um curto período, ou entre em contato com o suporte se persistir |
509 | Créditos do plano esgotados | Faça upgrade ou aguarde o próximo ciclo de faturamento |
Novas tentativas automáticas
Seção intitulada “Novas tentativas automáticas”Buscas com falha, CAPTCHAs e erros 5xx transitórios do destino são reenviados automaticamente (até 3 vezes) com proxies diferentes antes que o endpoint retorne um erro. Você não é cobrado por novas tentativas.
Entrega via webhook
Seção intitulada “Entrega via webhook”Para scrapes de longa duração, passe webhook=<URL> para que a resposta seja enviada via POST ao seu endpoint quando estiver pronta:
curl "https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=https://example.com&webhook=https%3A%2F%2Fyour.app%2Fcallback"Você ainda paga 1 crédito por entrega bem-sucedida.
Monitoramento
Seção intitulada “Monitoramento”O uso de créditos em tempo real e a taxa de erros ficam visíveis no painel em Web Scraping API → Usage.