Raspe resultados de busca 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 é projetado para recuperar páginas de resultados de busca da Amazon. Para ver o exemplo de resposta com os dados recuperados, baixe istoexemplo de saída arquivo em formato HTML ou verifique a saída de dados estruturados aqui.
Explorar saída dicionário de dados para cada recurso de Busca da Amazon, 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.
Amostras de requisiçã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 pela página #2 , para o termo de busca nirvana tshirt. Além disso, a busca será limitada ao ID de 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:
moeda
Define a moeda. Verifique os valores disponíveis aqui.
-
- parâmetro obrigatório
Localização
Adapte resultados para localizações geográficas específicas, domínios, idiomas.
Parâmetro
Descrição
Valor Padrão
geo_location
O Entregar para localização. Veja nosso guia para usar este parâmetro aqui.
-
domínio
Localização de domínio para Bestbuy. A lista completa de domínios disponíveis pode ser encontrada aqui.
com
locale
Accept-Language valor do cabeçalho, que define o idioma da interface da página da Amazon. Mais info.
-
IMPORTANTE: Na maioria dos tipos de página, a Amazon ajusta os resultados retornados com base no local de entrega dos seus clientes. Portanto, recomendamos usar o geo_location parâmetro para definir sua localização de entrega preferida. Você pode ler mais sobre o uso de geo_location com a Amazon aqui.
Paginação
Controles para gerenciar a paginação e recuperação dos resultados de pesquisa.
Parâmetro
Descrição
Valor Padrão
start_page
Número da página inicial.
1
pages
Número de páginas a recuperar.
1
Ordenação e filtragem
Controles para ordenação e filtragem das 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 segundo um dos possíveis valores 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 de busca. Esses parâmetros correspondem às opções de filtragem dinâmicas da Amazon (por exemplo, marca, faixa de preço, características) e seguem o formato de parâmetros 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 via o refinements campo para aplicar filtros específicos
-
context:
category_id
Pesquisar itens em um nó específico da Amazon (categoria de produto).
-
context:
merchant_id
Pesquisar itens vendidos por um vendedor específico.
-
Dados estruturados
amazon_search saída estruturada
A amostra de saída está encurtada.
Dicionário de dados de saída
A API retorna um objeto HTML ou JSON que contém os resultados de busca obtidos da Amazon.
Exemplo em HTML
Estrutura JSON
Todos os resultados de busca estão contidos dentro do results array JSON. Cada resultado de busca inclui uma combinação de pago, organic, sugeridos, amazons_choices,instant_recommendations listagens. Adicionalmente, variações podem estar presentes, e elas são capturadas dentro da variations chave, 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
results
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 parsing. 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 quando o trabalho de scraping foi criado.
string
updated_at
O timestamp quando o trabalho de scraping foi finalizado.
string
job_id
O ID do job 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 parser usado para analisar os dados.
string
Nas seções seguintes, os trechos de código JSON parseado são encurtados quando há mais de um item disponível para o tipo de resultado.
Pago
O pago a seção dos resultados de busca refere-se a 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 de busca.
(ou pos ou rel_pos está presente)
integer
pos
Um indicador único denotando a posição na listagem. (ou pos ou rel_pos está presente)
integer
moeda
A moeda na qual o preço está denominado.
string
url_image
A URL da imagem do produto.
string
best_seller
Indica se o produto é um best seller.
boolean
price_upper
O limite superior do preço, se aplicável.
float
is_sponsored
Indica se o produto é patrocinado.
boolean
manufacturer
O nome do fabricante do produto.
string
pricing_count
A contagem de ofertas para o produto.
integer
reviews_count
A contagem de avaliações para o produto.
integer
coupon_discount
O valor descontado.
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".
boolean
no_price_reason
Indicador do porquê 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 determinado produto.
string (opcional)
is_prime
Indica se o produto é elegível para o Amazon Prime.
boolean
shipping_information
Informações sobre os detalhes de envio do produto
string
Orgânico
O organic a seção dos resultados de 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 único denotando 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
moeda
A moeda na qual o preço está denominado.
string
is_prime
Indica se o produto é elegível para o Amazon Prime.
boolean
url_image
A URL da imagem do produto.
string
best_seller
Indica se o produto é um best seller.
boolean
price_upper
O limite superior do preço, se aplicável.
float
is_sponsored
Indica se o produto é patrocinado.
boolean
manufacturer
O nome do fabricante do produto.
string
sales_volume
O volume de vendas ou número de unidades vendidas de um determinado produto.
string (opcional)
pricing_count
A contagem de preços para o produto.
integer
reviews_count
A contagem de avaliações para o produto.
integer
coupon_discount
O valor descontado.
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.
boolean
price_strikethrough
Preço original antes de quaisquer descontos.
float
shipping_information
Datas de entrega e detalhes de custo de envio.
string
no_price_reason
Indicador do porquê 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
Sugerido
O sugeridos a seção sugerida nos resultados de 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
moeda
A moeda na qual o preço está denominado.
string
url_image
A URL da imagem do produto.
string
best_seller
Indica se o produto é um best seller.
boolean
price_upper
O limite superior do preço, se aplicável.
float
is_sponsored
Indica se o produto é patrocinado.
boolean
manufacturer
O nome do fabricante do produto.
string
pricing_count
A contagem de preços para o produto.
integer
reviews_count
A contagem de avaliações para o produto.
integer
coupon_discount
O valor descontado.
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.
boolean
pos
Um indicador único denotando a posição na listagem.
integer
is_prime
Indica se o produto é elegível para o Amazon Prime.
boolean
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 determinado produto.
string (opcional)
no_price_reason
Indicador do porquê 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 de busca.
string
Escolhas da Amazon
O amazons_choices a seção apresenta produtos com o selo 'Amazon's Choice' e são recomendados pela plataforma por sua percepção de qualidade e valor.
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
moeda
A moeda na qual o preço está denominado.
string
url_image
A URL da imagem do produto.
string
best_seller
Indica se o produto é um best seller.
boolean
price_upper
O limite superior do preço, se aplicável.
float
is_sponsored
Indica se o produto é patrocinado.
boolean
manufacturer
O nome do fabricante do produto.
string
pricing_count
A contagem de preços para o produto.
integer
reviews_count
A contagem de avaliações para o produto.
integer
coupon_discount
O valor descontado.
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.
boolean
pos
Um indicador único denotando a posição na listagem.
integer
is_prime
Indica se o produto é elegível para o Amazon Prime.
boolean
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 determinado produto.
string (opcional)
no_price_reason
Indicador do porquê 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
Amazon Standard Identification Number
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 Keyboard/Mouse Adapter Plus Controller Crossover, PS4, PS5, Xbox Series X/S, Xbox One, Nintendo Switch, GE1337P2, FPS, mouse control",
"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 Sala Grande até 2200sq.ft, MOOKA Purificador de ar para Casa com filtro lavável, Sensor de Qualidade do Ar PM 2.5 Display Purificador de Ar para Quarto, Quarto de estudante, Animais de estimação, 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": "10K+ 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 julOu 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"
},
...
]