Raspe resultados de pesquisa da Amazon com a Web Scraper API. Recupere títulos de produtos, preços, avaliações e mais com renderização JS, geolocalização e exemplos.
O amazon_search source foi projetado para recuperar páginas de resultados de busca da Amazon. Para ver o exemplo de resposta com os dados recuperados, baixe esteexemplo de saída arquivo em formato HTML ou confira a saída de dados estruturados aqui.
Explorar saída dicionário de dados para cada recurso de Amazon Search, oferecendo uma breve descrição, captura de tela, trecho de código JSON parseado e uma tabela definindo cada campo parseado. Navegue pelos detalhes usando a navegação à direita ou rolando a página para baixo.
Exemplos de solicitação
Nos exemplos de código abaixo, fazemos uma requisição para recuperar um resultado de amazon.com, que inclui 2 páginas de resultados de busca, começando da página #2 , para o termo de busca nirvana tshirt. Além disso, a busca será limitada ao ID da categoria: 16391693031 e os preços são exibidos em USD moeda.
Tipo de dispositivo e navegador. A lista completa pode ser encontrada aqui.
desktop
context:
currency
Define a moeda. Confira os valores disponíveis aqui.
-
- parâmetro obrigatório
Localização
Ajusta os resultados para locais geográficos, domínios e idiomas específicos.
Parâmetro
Descrição
Valor padrão
geo_location
O Entregar para localização. Veja nosso guia de uso deste parâmetro aqui.
-
domain
Localização do domínio para a Amazon. A lista completa de domínios disponíveis pode ser encontrada aqui.
com
locale
valor do cabeçalho valor do cabeçalho, que define o idioma da interface da página da Amazon. Mais informações.
-
IMPORTANTE: Na maioria dos tipos de página, a Amazon adapta os resultados retornados com base no local de entrega dos clientes. Portanto, recomendamos usar o geo_location parâmetro para definir seu local de entrega preferido. Você pode ler mais sobre o uso de geo_location com a Amazon aqui.
Paginação
Controles para gerenciar a paginação e a recuperação dos resultados da pesquisa.
Parâmetro
Descrição
Valor padrão
start_page
Número da página inicial.
1
pages
Número de páginas para recuperar.
1
Ordenação e filtragem
Controles para ordenação e filtragem de páginas de resultados de busca.
Parâmetro
Descrição
Valor padrão
sort_by
Define o tipo de ordenação da página de resultados de busca de acordo com um dos valores possíveis na Amazon:
"most_recent", "price_low_to_high", "price_high_to_low", "featured", "average_review", "bestsellers".
-
refinements
Uma lista de parâmetros de refinamento de busca da Amazon usados para aplicar filtros específicos aos resultados. Esses parâmetros correspondem às opções de filtragem dinâmicas da Amazon (por exemplo, marca, faixa de preço, recursos) e seguem o formato interno da Amazon, como p_123:256097 ou p_n_feature_twenty-eight_browse-bin:98209020031.
Como as opções de filtragem variam por categoria e são geradas dinamicamente pela Amazon, o fluxo de trabalho recomendado é:
Primeiro, raspe a página de busca alvo da Amazon com parse: true para descobrir as opções de refinamento disponíveis
Extraia os parâmetros de filtro desejados da resposta parseada
Use esses parâmetros em requisições subsequentes por meio do campo refinements para aplicar filtros específicos
-
context:
category_id
Busque itens em um node específico da Amazon (categoria de produto).
-
context:
merchant_id
Busque itens vendidos por um vendedor específico.
-
Dados estruturados
amazon_search saída estruturada
A amostra de saída está abreviada.
Dicionário de dados de saída
A API retorna um objeto HTML ou JSON que contém os resultados da busca recuperados da Amazon.
Exemplo de HTML
Estrutura JSON
Todos os resultados da busca estão contidos no resultados array JSON. Cada resultado da busca inclui uma combinação de paid, organic, sugeridos, amazons_choices,instant_recommendations listings. Além disso, variações podem estar presentes, e elas são capturadas na chave variations fornecendo detalhes sobre diferentes tipos ou categorias de produtos, como vários modelos, edições ou versões.
Chave
Descrição
Tipo
url
A URL da página de busca da Amazon.
string
page
O número da página atual.
integer
pages
O número total de páginas.
integer
query
A consulta de busca usada.
string
resultados
Um dicionário contendo os resultados da pesquisa.
object
results.paid
Uma lista de produtos patrocinados com seus respectivos detalhes.
array
results.organic
Uma lista de produtos orgânicos com seus respectivos detalhes.
array
results.suggested
Uma lista de produtos sugeridos com seus respectivos detalhes.
array
results.amazons_choices
Uma lista das escolhas da Amazon com seus respectivos detalhes.
array
refinements
Uma lista de refinamentos disponíveis nesta página de busca.
array
parse_status_code
O código de status do trabalho de análise. Você pode ver os códigos de status do parser descritos aqui.
integer
total_results_count
O número total de resultados encontrados para a consulta de pesquisa.
integer
created_at
O timestamp em que o trabalho de scraping foi criado.
string
updated_at
O timestamp em que o trabalho de scraping foi concluído.
string
job_id
O ID do trabalho associado ao trabalho de scraping.
string
status_code
O código de status do trabalho de scraping. Você pode ver os códigos de status do scraper descritos aqui.
integer
parser_type
O tipo de analisador usado para processar os dados.
string
Nas seções a seguir, os trechos de código JSON analisados são abreviados quando há mais de um item disponível para o tipo de resultado.
Pago
O paid seção dos resultados da busca refere-se ao conteúdo de anúncio inline exibido dentro dos resultados de busca da Amazon.
Chave
Descrição
Tipo
url
A URL do produto.
string
asin
Número de Identificação Padrão da Amazon.
string
preço
O preço do produto.
float
title
O título do produto.
string
rating
A avaliação do produto.
float
rel_pos
A posição relativa do produto nos resultados da busca.
(seja pos ou rel_pos está presente)
integer
pos
Um indicador exclusivo que denota a posição na listagem. (seja pos ou rel_pos está presente)
integer
currency
A moeda na qual o preço é denominado.
string
url_image
A URL da imagem do produto.
string
best_seller
Indica se o produto é um best seller.
booleano
price_upper
O limite superior do preço, se aplicável.
float
is_sponsored
Indica se o produto é patrocinado.
booleano
manufacturer
O nome do fabricante do produto.
string
pricing_count
A contagem de ofertas do produto.
integer
reviews_count
A contagem de avaliações do produto.
integer
coupon_discount
O valor do desconto.
integer (opcional)
coupon_discount_type
O tipo de desconto: nominal ou percentage.
string (opcional)
is_amazons_choice
Indica se o produto está marcado como "Amazon's choice".
booleano
no_price_reason
Indicador de por que o preço não está presente, se for igual a 0.0
string (opcional)
sales_volume
O volume de vendas ou número de unidades vendidas de um produto específico.
string (opcional)
is_prime
Indica se o produto é elegível para o Amazon Prime.
booleano
shipping_information
Informações sobre os detalhes de envio do produt
string
Orgânico
O organic seção dos resultados da busca refere-se ao conteúdo não patrocinado que aparece naturalmente com base no algoritmo de busca da Amazon.
Nome
Descrição
Tipo
pos
Um indicador exclusivo que denota a posição na listagem.
integer
url
A URL do produto.
string
asin
Número de Identificação Padrão da Amazon.
string
preço
O preço do produto.
float
title
O título do produto.
string
rating
A avaliação do produto.
float
currency
A moeda na qual o preço é denominado.
string
is_prime
Indica se o produto é elegível para o Amazon Prime.
booleano
url_image
A URL da imagem do produto.
string
best_seller
Indica se o produto é um best seller.
booleano
price_upper
O limite superior do preço, se aplicável.
float
is_sponsored
Indica se o produto é patrocinado.
booleano
manufacturer
O nome do fabricante do produto.
string
sales_volume
O volume de vendas ou número de unidades vendidas de um produto específico.
string (opcional)
pricing_count
A contagem de preços do produto.
integer
reviews_count
A contagem de avaliações do produto.
integer
coupon_discount
O valor do desconto.
integer (opcional)
coupon_discount_type
O tipo de desconto: nominal ou percentage.
string (opcional)
is_amazons_choice
Indica se o produto é a escolha da Amazon.
booleano
price_strikethrough
Preço original antes de quaisquer descontos.
float
shipping_information
Datas de entrega e detalhes do custo de envio.
string
no_price_reason
Indicador de por que o preço não está presente, se for igual a 0.0
string (opcional)
variations
Lista de diferentes versões ou modelos de um produto
Array
Sugeridos
O sugeridos seção nos resultados da busca normalmente contém listagens de produtos recomendadas pela plataforma com base na consulta de busca do usuário, histórico de navegação ou comportamento de compra.
Chave
Descrição
Tipo
url
A URL do produto.
string
asin
Número de Identificação Padrão da Amazon.
string
preço
O preço do produto.
float
title
O título do produto.
string
rating
A avaliação do produto.
float
currency
A moeda na qual o preço é denominado.
string
url_image
A URL da imagem do produto.
string
best_seller
Indica se o produto é um best seller.
booleano
price_upper
O limite superior do preço, se aplicável.
float
is_sponsored
Indica se o produto é patrocinado.
booleano
manufacturer
O nome do fabricante do produto.
string
pricing_count
A contagem de preços do produto.
integer
reviews_count
A contagem de avaliações do produto.
integer
coupon_discount
O valor do desconto.
integer (opcional)
coupon_discount_type
O tipo de desconto: nominal ou percentage.
string (opcional)
is_amazons_choice
Indica se o produto é a escolha da Amazon.
booleano
pos
Um indicador exclusivo que denota a posição na listagem.
integer
is_prime
Indica se o produto é elegível para o Amazon Prime.
booleano
shipping_information
Informações sobre os detalhes de envio do produto.
string
sales_volume
O volume de vendas ou número de unidades vendidas de um produto específico.
string (opcional)
no_price_reason
Indicador de por que o preço não está presente, se for igual a 0.0
string (opcional)
suggested_query
A consulta sugerida fornecida pela Amazon como parte dos resultados da busca.
string
Escolhas da Amazon
O amazons_choices seção apresenta produtos com o selo 'Amazon's Choice' e são recomendados pela plataforma pela qualidade e valor percebidos.
Chave
Descrição
Tipo
url
A URL do produto.
string
asin
Número de Identificação Padrão da Amazon.
string
preço
O preço do produto.
float
title
O título do produto.
string
rating
A avaliação do produto.
float
currency
A moeda na qual o preço é denominado.
string
url_image
A URL da imagem do produto.
string
best_seller
Indica se o produto é um best seller.
booleano
price_upper
O limite superior do preço, se aplicável.
float
is_sponsored
Indica se o produto é patrocinado.
booleano
manufacturer
O nome do fabricante do produto.
string
pricing_count
A contagem de preços do produto.
integer
reviews_count
A contagem de avaliações do produto.
integer
coupon_discount
O valor do desconto.
integer (opcional)
coupon_discount_type
O tipo de desconto: nominal ou percentage.
string (opcional)
is_amazons_choice
Indica se o produto é a escolha da Amazon.
booleano
pos
Um indicador exclusivo que denota a posição na listagem.
integer
is_prime
Indica se o produto é elegível para o Amazon Prime.
booleano
shipping_information
Informações sobre os detalhes de envio do produto.
string
sales_volume
O volume de vendas ou número de unidades vendidas de um produto específico.
string (opcional)
no_price_reason
Indicador de por que o preço não está presente, se for igual a 0.0
string (opcional)
variations
Lista de diferentes versões ou modelos de um produto
Array
Variações
O variations a seção lista diferentes versões ou modelos de um produto, fornecendo uma visão detalhada das opções disponíveis na categoria especificada.
Chave
Descrição
Tipo
asin
Número de Identificação Padrão da Amazon
string
title
Título da variação
string
preço
Preço da variação
float
price_strikethrough
O preço original antes de quaisquer descontos ou promoções
...
"paid": [
{
"pos": 1,
"url": "/sspa/click?ie=UTF8&spc=MTo3ODk3NzcxNTI0MDAzNjk1OjE3MDEwODYyODI6c3BfYXRmOjMwMDA5Mjg4ODc1NTcwMjo6MDo6&url=/IOGEAR-KeyMander-Controller-Crossover-GE1337P2/dp/B08541QCKJ/ref=sr_1_1_sspa?keywords=nintendo&qid=1701086282&sr=8-1-spons&sp_csd=d2lkZ2V0TmFtZT1zcF9hdGY&psc=1",
"asin": "B08541QCKJ",
"price": 69.99,
"title": "IOGEAR KeyMander 2 Adapter de teclado/mouse Plus Controller Crossover, PS4, PS5, Xbox Series X/S, Xbox One, Nintendo Switch, GE1337P2, FPS, controle do mouse",
"rating": 3.7,
"currency": "USD",
"is_prime": true,
"url_image": "https://m.media-amazon.com/images/I/41-AZ8CCl1L._AC_UY218_.jpg",
"best_seller": false,
"price_upper": 69.99,
"is_sponsored": true,
"manufacturer": "",
"pricing_count": 1,
"reviews_count": 1229,
"is_amazons_choice": false,
"price_strikethrough": 99.95,
"shipping_information": "ENTREGA GRÁTIS dom, 3 de dez. Ou entrega mais rápida qui, 30 de nov."
},
...
]
...
"organic": [
...
{
"pos": 5,
"url": "/Purifiers-2200sq-ft-MOOKA-purifier-PR1/dp/B0DCBC8KKV/ref=sr_1_5?dib=eyJ2IjoiMSJ9.Qoe5cUAPMM1voliSq4zLfiJ0JVl_hsy805T9yDeoZdvRcrqICV-PjwCg0I67jvJVJ_PSunMweX8SvSH3-M-pI2-ugdCQ85ZkACZeyo0mFA_x-tDj-q1JTf8V3SdCA7KJlxMyHDeIT2N6NHGk7cyVsOpK-UlfWiNJ-dnu6KUIZcC82Zm0ugL-vdGTf8Qj-uDJJcWp35jlmA3m6N3XV3l8BuJVNVIXrsniboQa_FpLjLY.o9cWjzsvdrHpX_CV82v3VY104qfYcK7CkfXDFYuwlC8&dib_tag=se&keywords=air+purifier&qid=1753104496&sr=8-5",
"asin": "B0DCBC8KKV",
"price": 99.99,
"title": "Purificadores de ar para casa, quarto grande de até 2200 pés², purificador de ar MOOKA para casa e pets com filtro lavável, sensor de qualidade do ar com display PM 2.5, purificador de ar para quarto, dormitório, pets, escritório, PR1",
"rating": 4.6,
"currency": "USD",
"is_prime": false,
"url_image": "https://m.media-amazon.com/images/I/81spn7Ork+L._AC_UY218_.jpg",
"best_seller": false,
"price_upper": 99.99,
"is_sponsored": false,
"manufacturer": "",
"sales_volume": "10 mil+ comprados no último mês",
"pricing_count": 1,
"reviews_count": 1431,
"coupon_discount": 15,
"is_amazons_choice": false,
"price_strikethrough": 105.97,
"coupon_discount_type": "nominal",
"shipping_information": "ENTREGA GRÁTIS sáb, 26 de jul. Ou entrega mais rápida qua, 23 de jul."
},
...
]
...
"suggested": [
{
"pos": 3,
"asin": "B07L4ZRJ7P",
"best_seller": false,
"is_sponsored": false,
"is_amazons_choice": false,
"manufacturer": "",
"pricing_count": 1,
"rating": 4.0,
"reviews_count": 1,
"title": "The Supercar Story",
"url": "/Supercar-Story-Patrick-Mark/dp/B07L4ZRJ7P/ref=sr_1_fkmr0_1?keywords=details about mercedes benz head unit e-class w213 comand navi gps unit a21390050813&qid=1636460216&sr=8-1-fkmr0",
"url_image": "https://m.media-amazon.com/images/I/81uC-IclZqL._AC_UY218_.jpg",
"is_prime": false,
"price": 0.0,
"price_upper": 0.0,
"no_price_reason": "unknown",
"pos": 1,
"currency": "USD",
"suggested_query": "details benz head"
},
...
]