Endpoints do Amazon Scraper

Use o actor scraper.amazon para todas as operações desta página. Selecione a operação com input.type e forneça os inputs correspondentes.

Requisição e autenticação

POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/json

Substitua YOUR_API_KEY pela sua chave de API da Scrapeless. Envie um único objeto JSON contendo actor e input.

Escolha uma operação

Operação	`input.type`	Inputs usados abaixo
Produto	`product`	`url`, `zip_code`
Vendedor	`seller`	`url`, `zip_code`
Busca por palavra-chave	`keywords`	`keywords`, `page`, `domain`, `zip_code`
Rufus	`rufus`	`keywords`, `domain`

Produto

Forneça uma URL de produto da Amazon. O esquema de Produto requer url; zip_code fornece informações de localização de entrega.

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": ""
  }
}'

A resposta publicada inclui asin, title, availability, final_price, rating, reviews_count, images e variations. Consulte o Quickstart para um exemplo de resposta resumida.

Referência da API de Produto

Vendedor

Forneça a URL de uma página de vendedor. Inclua zip_code: o esquema de Vendedor o marca como obrigatório, e seu exemplo de requisição usa uma string vazia.

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": "seller",
    "url": "https://www.amazon.com/sp?seller=A2XZ7JICGUQ1CX",
    "zip_code": ""
  }
}'

A referência de Vendedor define a resposta bem-sucedida como um objeto JSON sem esquema em nível de campo ou exemplo. Inspecione o payload retornado antes de mapear os campos de vendedor na sua aplicação.

Referência da API de Vendedor

Busca por palavra-chave

Forneça o texto de busca em keywords. Use page para selecionar uma página de resultados de busca. O exemplo abaixo segue o valor numérico de página documentado e usa domain: "com" para a Amazon.com; ele omite o filtro opcional de departamento.

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": "keywords",
    "keywords": "Iphone+14+Pro+512GB",
    "page": 1,
    "domain": "com",
    "zip_code": ""
  }
}'

Input	Uso
`keywords`	Palavras-chave de busca; obrigatório pelo esquema da operação.
`page`	Número da página de resultados de busca.
`domain`	Configuração de domínio da Amazon; o exemplo oficial usa `com`.
`department`	Alias opcional de departamento, correspondente ao parâmetro de consulta `i` da Amazon.
`zip_code`	Código postal para informações de entrega.

A resposta publicada possui keyword, page, result, total_results_count e url. As entradas de produtos aparecem em result.organic. O exemplo de resposta é para uma consulta e página diferentes do exemplo de requisição, portanto deve ser usado para entender os campos em vez de prever resultados exatos.

O guia de parâmetros da Amazon especifica valores inteiros para page, e o exemplo de requisição usa 1; o esquema de operação gerado atualmente rotula page como uma string. Este guia segue o guia de parâmetros e o exemplo de requisição.

Referência da API de busca por palavra-chave

Rufus

Defina type como rufus. Tanto keywords quanto domain são obrigatórios pelo esquema da operação. Use um domínio completo da Amazon, como www.amazon.es, em vez do formato com usado no exemplo de Busca por palavra-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": "rufus",
    "keywords": "macbook",
    "domain": "www.amazon.es"
  }
}'

A resposta publicada contém:

Campo	Conteúdo mostrado no exemplo da API
`html`	Conteúdo bruto contendo registros de eventos e fragmentos HTML.
`metadata`	Inclui `type` e `rawUrl`.
`result.user_query`	Texto da consulta.
`result.products`	Entradas de produtos retornadas para a consulta.
`result.related_questions`	Perguntas relacionadas.

O esquema da operação também lista is_sse_data, is_get_question e asin, mas não explica seu comportamento. Comece com a requisição documentada acima.

Referência da API do Rufus

Lidar com resultados de tarefas

Uma resposta HTTP 200 contém o resultado concluído. Uma resposta HTTP 201 significa que o processamento ainda está em andamento; salve seu taskId e recupere essa tarefa com:

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

Substitua YOUR_TASK_ID pelo ID retornado pela sua requisição. Siga Resultados e Polling para intervalos de polling e limites de tentativas.

Inspecione os corpos de erro, bem como os códigos de status HTTP. Uma resposta 400 pode incluir code: 20500 e message: "scraping failed"; ela não é uma resposta de dados bem-sucedida. Verifique o alvo e os inputs da requisição antes de tentar novamente.

Referência de parâmetros

Use Parâmetros da API da Amazon para os aliases de departamento e outros inputs documentados. Analise os resultados de acordo com o type selecionado; Produto, Busca por palavra-chave, Vendedor e Rufus não compartilham um único layout de campos.

Início rápido Introdução