DocumentaçãoScraping APIResultados e consultas periódicas

Resultados e Polling

Quando uma tarefa não pode ser concluída instantaneamente, a API retorna um taskId (HTTP 201). Faça polling no endpoint de resultado com esse taskId até que os dados estejam prontos (HTTP 200).

Códigos de Status HTTP

CódigoSignificadoAção
200SucessoUse diretamente os dados do corpo da resposta.
201Tarefa em andamentoFaça polling em /result/{taskId} (intervalo recomendado: 1-5 segundos).
400Parâmetros inválidosVerifique se os parâmetros da tarefa são válidos.
429Limite de taxa excedidoReduza a frequência de requisições ou entre em contato com o suporte para ajuste de cota.
500Erro interno do servidorTente novamente após 1 minuto; entre em contato com o suporte se persistir.

Polling de Resultados

Chame o endpoint de resultado com o seu taskId até que ele retorne HTTP 200.

curl --location --request GET 'https://api.scrapeless.com/api/v1/scraper/result/30681c8b-bfd3-48eb-a7c9-006e40b00591' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json'
 

Notas

  1. Recomendações de Polling
    1. Intervalo: 1-5 segundos.
    2. Timeout: Defina um limite máximo de tentativas (por exemplo, 10 tentativas).
  2. Dicas de Depuração
    1. Teste primeiro com URLs simples.