Endpoints do Amazon Scraper

Use o ator scraper.amazon para todas as operações nesta página. Selecione a operação com input.type e forneça suas entradas correspondentes.

Solicitaçã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çãoinput.typeEntradas usadas abaixo
Produtoproducturl, zip_code
Vendedorsellerurl, zip_code
Pesquisa por palavras-chavekeywordskeywords, page, domain, zip_code
Rufusrufuskeywords, domain

Produto

Forneça um URL de produto da Amazon. O schema de Produto exige url; zip_code fornece informações sobre o local 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 Quickstart para um exemplo de resposta resumido.

Referência da API de Produto

Vendedor

Forneça um URL da página do vendedor. Inclua zip_code: o schema de Vendedor o marca como obrigatório e seu exemplo de solicitaçã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 do Vendedor define a resposta bem-sucedida como um objeto JSON sem um schema ou exemplo em nível de campo. Inspecione o payload retornado antes de mapear os campos do vendedor em seu aplicativo.

Referência da API de Vendedor

Pesquisa por palavras-chave

Forneça o texto de pesquisa em keywords. Use page para selecionar uma página de resultados de pesquisa. 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": ""
  }
}'
EntradaUso
keywordsPalavras-chave de pesquisa; obrigatório pelo schema da operação.
pageNúmero da página de resultados da pesquisa.
domainConfiguração de domínio da Amazon; o exemplo oficial usa com.
departmentAlias opcional de departamento, correspondente ao parâmetro de consulta i da Amazon.
zip_codeCódigo postal para informações de entrega.

A resposta publicada contém keyword, page, result, total_results_count e url. As entradas de produto aparecem em result.organic. O exemplo de resposta refere-se a uma consulta e página diferentes do exemplo de solicitação, portanto, deve ser usado para compreender os campos em vez de prever resultados exatos.

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

Referência da API de pesquisa por palavras-chave

Rufus

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

CampoConteúdo mostrado no exemplo da API
htmlConteúdo bruto contendo registros de eventos e fragmentos HTML.
metadataInclui type e rawUrl.
result.user_queryTexto da consulta.
result.productsEntradas de produto retornadas para a consulta.
result.related_questionsPerguntas relacionadas.
result.sourcesFonte de dados; o campo pode não ser retornado em todas as respostas. Sua disponibilidade depende do produto e do prompt.

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

Referência da API Rufus

Gerenciar 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 o 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 solicitação. Consulte Resultados e Polling para intervalos de polling e limites de nova tentativa.

Inspecione os corpos de erro, bem como os códigos de status HTTP. Uma resposta 400 pode incluir code: 20500 e message: "scraping failed"; não se trata de uma resposta de dados bem-sucedida. Verifique o destino e as entradas da solicitação antes de tentar novamente.

Referência de parâmetros

Use Parâmetros da API Amazon para os aliases de departamento e outras entradas documentadas. Analise os resultados para o type selecionado; Produto, Pesquisa por palavras-chave, Vendedor e Rufus não compartilham um único layout de campos.