Início rápido do Amazon Scraper

Solicite um produto da Amazon com cURL e leia seu resultado estruturado. Este passo a passo usa o exemplo de requisição da referência da Product API.

Antes de começar

Você precisa de uma conta Scrapeless, uma chave de API válida e cURL. Obtenha sua chave no painel do Scrapeless.

O exemplo usa uma URL de produto da referência da API. Você pode substituí-la pela URL do produto da Amazon que deseja recuperar. A disponibilidade da listagem e os valores retornados podem mudar.

1. Enviar a requisição

Substitua YOUR_API_KEY pela sua chave:

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.amazon",
  "input": {
    "type": "product",
    "url": "https://www.amazon.com/dp/B0BQXHK363",
    "zip_code": ""
  }
}'

O corpo seleciona o actor da Amazon, define type como product e fornece a url do produto. O zip_code vazio corresponde ao exemplo oficial; forneça um código postal quando precisar de informações de entrega para aquela localização.

2. Ler um resultado concluído

O HTTP 200 indica conclusão. O seguinte é um subconjunto de campos do exemplo de resposta publicado da Product, não uma captura nova:

{
  "asin": "B0BQXHK363",
  "availability": "In Stock",
  "final_price": "$44.99",
  "rating": "4.0",
  "reviews_count": "115"
}

Preços, avaliações e contagens de reviews neste exemplo são strings. Preserve os tipos retornados ao ler o payload e converta-os explicitamente se sua aplicação precisar de valores numéricos. Outros campos no exemplo completo incluem title, images e variations.

3. Recuperar uma tarefa que ainda está em processamento

Uma resposta HTTP 201 retorna um ID de tarefa. A referência da API mostra:

{
  "message": "task in progress",
  "taskId": "a8af123c-0f81-477d-a2e7-c57ad18fe54a"
}

Use o ID da sua própria resposta, e não o ID do exemplo, nesta requisição:

curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
  --header 'x-api-token: YOUR_API_KEY'

Se a tarefa ainda estiver em processamento, continue de acordo com Resultados e Polling. Use uma política de novas tentativas com limite em vez de reenviar repetidamente a mesma requisição de produto.

Se a requisição falhar

Inspecione tanto o status HTTP quanto o corpo da resposta. A referência da Product inclui um exemplo 400 com code: 20500 e message: "scraping failed". Verifique a chave, a URL do produto e a entrada JSON. Siga o guia compartilhado de polling para limites de taxa e erros de servidor.

Próximos passos

Continue para Endpoints para requisições de Seller, busca por Keyword e Rufus. Consulte a referência da Product API para o exemplo completo publicado.

Introdução Endpoints