Scraping APIIntrodução rápidaComeçando

Começar

Fluxo de Requisição

  1. Enviar uma Tarefa Enviar uma requisição POST para /api/v1/scraper/request.
  2. Tratar a Resposta
    1. HTTP 200 (Sucesso): Os dados são retornados diretamente no corpo da resposta.
    2. HTTP 201 (Processando): Use o taskId fornecido para verificar os resultados.
  3. Verificar os Resultados Para tarefas assíncronas, chame repetidamente /api/v1/scraper/result/{taskId} até que os dados estejam prontos (HTTP 200).

Códigos de Status HTTP

CódigoSignificadoAção
200SucessoUse os dados do corpo da resposta diretamente.
201Tarefa em andamentoVerifique /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 solicitaçõ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.

Exemplos de Código

Fluxo Completo

import { Scrapeless, log } from '@scrapeless-ai/sdk';
const client = new Scrapeless({
  apiKey: 'YOUR_API_KEY',
});
 
async function runTask() {
  const result = await client.scraping.scrape({
    {
      actor: 'scraper.shopee',
      input: {
        url: 'https://shopee.tw/a-i.10228173.24803858474'
      }
    },
  });
 
  return result;
}
 
runTask()
  .then(data => {
    console.log('Data:', data);
  })
  .catch(error => {
    console.error('Error:', error);
  });

cURL (Exemplo de Verificação)

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'
 

Parâmetros

ParâmetroTipoDescrição
actorstringServiço de scraping (por exemplo, scraper.shopee).
inputobjectParâmetros específicos da tarefa (por exemplo, action, url).
proxyobjectConfiguração de proxy opcional com campo country.

Notas

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