Produto
Extraia dados de produtos da Amazon sem esforço com a Web Scraper API. Acesse títulos, preços, avaliações e detalhes usando parâmetros personalizados e exemplos.
O amazon_product a fonte de dados é projetada para recuperar páginas de produtos da Amazon.
Amostras de requisição
Nos exemplos abaixo, fazemos uma solicitação para recuperar a página do produto para ASIN B08Y72CH1F em amazon.nl marketplace. Caso o ASIN fornecido seja um ASIN pai, pedimos à Amazon para retornar a página do produto de uma variação selecionada automaticamente. A API retornará resultados parseados.
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
"source": "amazon_product",
"domain": "nl",
"query": "B08Y72CH1F",
"parse": true,
"context": [
{
"key": "autoselect_variant",
"value": true
}
]
}'import requests
from pprint import pprint
# Estruturar payload.
payload = {
'source': 'amazon_product',
'domain': 'nl',
'query': 'B08Y72CH1F',
'parse': True,
'context': [
{'key': 'autoselect_variant', 'value': True}
],
}
# Obter resposta.
response = requests.request(
'POST',
'https://realtime.oxylabs.io/v1/queries',
auth=('USERNAME', 'PASSWORD'),
json=payload,
)
# Imprimir a resposta formatada no stdout.
pprint(response.json())Usamos o método de integração síncrono Realtime em nossos exemplos. Se você quiser usar Proxy Endpoint ou integração assíncrona Push-Pull consulte os métodos de integração da seção.
Valores dos parâmetros da requisição
Genérico
Configuração básica e opções de personalização para scraping de páginas de produtos da Amazon.
source
Define o scraper.
amazon_product
query
Código ASIN de 10 caracteres.
-
- parâmetro obrigatório
Localização
Adapte resultados para localizações geográficas específicas, domínios, idiomas.
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.
Outros
Configurações avançadas adicionais e controles para requisitos especializados.
context:
autoselect_variant
Para obter dados precisos de preço/buybox, defina este parâmetro como true (o que nos instrui a anexar os th=1&psc=1 parâmetros de URL ao final da URL do produto). Para obter uma representação precisa da página do ASIN pai, omita este parâmetro ou defina-o como false.
false
Exemplo de código
Dados estruturados
A Web Scraper API é capaz de extrair um objeto HTML ou JSON que contém resultados de produtos da Amazon, oferecendo dados estruturados sobre vários elementos da página de resultados.
Dicionário de dados de saída
Navegue pelos detalhes usando a navegação do lado direito ou rolando a página para baixo.
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.
Exemplo em HTML
Estrutura JSON
A tabela abaixo apresenta uma lista detalhada de cada elemento da página de produto da Amazon que parseamos, incluindo sua descrição, tipo de dado e se o elemento está sempre presente no layout ou é opcional dependendo do produto que você escolher raspar. A tabela também inclui alguns metadados.
url
A URL do produto da Amazon.
string
page
O número da página atual.
integer
page_type
Identifica o tipo da página da Amazon.
string
asin
Número de Identificação Padrão da Amazon.
string
asin_in_url
Extrai o Amazon Standard Identification Number da URL.
string
title
O título do produto.
string
manufacturer
O nome do fabricante do produto.
string
product_name
O nome do produto.
string
description
A descrição do produto, parseada da seção 'Product description'.
string
bullet_points
Os itens em bullet points parseados da seção 'About this product'.
string
opcional
categoria
Uma lista contendo mais detalhes sobre a categoria do produto da Amazon.
array
opcional
variation
Uma lista contendo mais detalhes sobre as variações do produto da Amazon.
array
opcional
rating
A avaliação do produto.
integer
preço
O preço do produto.
float
price_upper
O limite superior do preço.
float
opcional
price_sns
Identifica se o produto faz parte do programa 'Subscribe & Save'.
float
price_initial
O preço original, sem desconto, de um produto.
float
price_shipping
O preço do frete.
float
opcional
price_buybox
O preço do produto conforme visível na buybox.
float
deal_type
Identifica a categoria da oferta promocional.
string
opcional
coupon
Indica quaisquer descontos digitais disponíveis.
string
opcional
is_prime_eligible
Indica se o produto é elegível para o Amazon Prime.
boolean
is_addon_item
Indica se um produto está disponível para compra apenas quando incluído em pedidos que atingem um valor mínimo.
boolean
opcional
moeda
A moeda na qual o preço está denominado.
string
discount_end
Indica a data final até a qual um desconto promocional para um produto da Amazon é válido.
string
opcional
stock
Indica o nível de estoque do produto.
string
reviews_count
A contagem de avaliações para o produto.
integer
avaliações
Uma lista de avaliações com seus respectivos detalhes.
array
answered_questions_count
O número total de perguntas de clientes sobre um produto da Amazon que foram respondidas.
integer
opcional
pricing_count
A contagem de ofertas para o produto.
integer
opcional
pricing_url
A URL para recuperar as listagens de ofertas do produto na Amazon.
string
opcional
pricing_str
Uma representação em string dos detalhes de precificação de um produto da Amazon. Este atributo inclui informações sobre o preço atual, quaisquer descontos, promoções e ofertas especiais
string
opcional
featured_merchant
Uma lista de detalhes sobre o vendedor principal ou fornecedor destacado para um produto da Amazon.
object
opcional
sales_rank
Uma lista de informações sobre a posição de ranking de vendas de um produto da Amazon dentro de sua categoria respectiva com base em seu desempenho de vendas.
array
opcional
sns_discounts
Indica quaisquer descontos disponíveis como parte do programa 'Subscribe & Save'.
array
developer_info
Informações relacionadas ao desenvolvedor ou fabricante de um produto da Amazon.
object
opcional
images
Uma lista de URLs indicando as imagens do produto.
array
product_overview
Uma lista de atributos-chave e suas descrições para o produto, fornecendo detalhes essenciais sobre as características do produto.
array
opcional
store_url
A URL da página da loja do vendedor.
string
opcional
has_videos
Indica se o produto possui vídeos.
boolean
delivery
Uma lista de informações sobre as opções de entrega.
object
opcional
brand
A marca do produto.
string
opcional
item_form
Especifica a forma física ou tipo do produto, detalhando como ele é embalado ou entregue para uso.
string
opcional
sales_volume
A quantidade de unidades vendidas dentro de um período de tempo específico.
string
opcional
other_sellers
Detalhes de outros vendedores que listam o produto, incluindo a contagem de vendedores, preço inicial entre eles e informações básicas de envio.
string
opcional
rating_stars_distribution
Uma lista de detalhes sobre as avaliações do produto.
array
opcional
buybox
Uma lista de detalhes sobre os preços do produto.
array
opcional
lightning_deal
Indica se há uma oferta promocional por tempo limitado disponível para o produto.
object
opcional
product_details
Uma lista de informações sobre os detalhes do produto.
object
opcional
product_dimensions
As dimensões do produto.
string
opcional
max_quantity
O número máximo de unidades de um produto da Amazon que um cliente está autorizado a comprar em um único pedido.
integer
opcional
warranty_and_support
Uma lista de detalhes sobre a garantia do produto.
object
opcional
discount.percentage
A porcentagem de redução aplicada ao preço original de um produto da Amazon.
integer
opcional
amazon_choice
Indica se o produto possui o selo Amazon's Choice.
boolean
opcional
coupon_discount_percentage
Indica a porcentagem de redução aplicável com um cupom.
integer
opcional
parent_asin
O identificador primário da família de produtos da Amazon ao qual um produto é atribuído.
string
opcional
created_at
O timestamp quando o trabalho de scraping foi criado.
timestamp
updated_at
O timestamp quando o trabalho de scraping foi finalizado.
timestamp
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
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
Category
Este campo mostra a estrutura hierárquica das categorias de produto para um produto da Amazon. Cada categoria na hierarquia é um objeto com um nome e URL, representando o caminho da categoria mais ampla até a subcategoria mais específica.
ladder
Uma lista contendo breadcrumbs do produto da Amazon.
array
ladder.name
O nome do breadcrumb/categoria do produto da Amazon.
string
ladder.url
A URL do breadcrumb/categoria.
string
Anúncios
Este campo contém informações sobre anúncios exibidos na página de produto da Amazon. Cada anúncio é representado como um objeto com detalhes como tipo, localização, título, ASIN, imagens, posição, avaliação, contagem de avaliações, elegibilidade ao Prime e preço.
type
O tipo do anúncio da Amazon.
string
localização
O nome da posição do anúncio na Amazon.
string
title
O título do produto.
string
asin
Número de Identificação Padrão da Amazon.
string
images
A URL da(s) imagem(ns) do produto.
string
pos
Um indicador único denotando a posição de um anúncio em relação a todos os resultados de anúncios disponíveis.
integer
rating
A avaliação do produto.
integer
reviews_count
A contagem de avaliações para o produto.
integer
is_prime_eligible
Indica se o produto é elegível para o Amazon Prime.
boolean
preço
O preço do produto.
float
price_upper
O limite superior do preço, se aplicável.
float
Distribuição de Estrelas de Avaliação
Este campo contém a distribuição das avaliações por estrelas para um produto. Cada objeto representa uma avaliação por estrelas e a porcentagem do total de avaliações que deu essa nota.
rating
Indica o número da avaliação (escala de 5 a 1).
integer
percentage
Indica a taxa percentual para a avaliação específica.
string
Avaliações
Contém avaliações de clientes para o produto, com cada avaliação representada como um objeto contendo detalhes relevantes.

id
Uma identificação alfa-numérica para a Review da Amazon.
string
title
A avaliação e o título da review.
string
author
O usuário que submeteu a avaliação.
string
rating
A avaliação por estrelas atribuída ao submeter a review, tipicamente entre 1 e 5.
integer
conteúdo
O texto completo do conteúdo da review.
string
timestamp
A data e local da review, formatados conforme fornecido pela Amazon.
string
profile_id
Identificador único para o perfil do autor da avaliação, usado para vincular ao perfil Amazon dele.
string
is_verified
Indica se a avaliação é de uma compra verificada.
boolean
review_from
Fornece contexto adicional sobre a origem da avaliação (por exemplo, avaliações específicas por localização ou avaliações principais).
string
helpful_count (opcional)
Número de votos úteis recebidos pela avaliação.
integer
product_attributes (opcional)
Identifica as características do produto.
string
Variações
Este campo contém informações sobre diferentes variações de um produto, como cor, tamanho, estilo etc. Cada variação é representada como um objeto com detalhes incluindo ASIN, status de seleção, dimensões (atributos como cor, tamanho, estilo) e uma URL de imagem de tooltip.
asin
O Amazon Standard Identification Number da variante do produto.
array
selected
Identifica a variante de produto selecionada.
boolean
dimensions
As dimensões do produto variante.
object
opcional
dimensions.size
O tamanho do produto variante.
string
opcional
dimensions.color
A cor do produto variante.
string
opcional
dimensions.style
O estilo do produto variante.
string
opcional
dimensions.unit count
A contagem padrão de unidades do produto variante.
string
opcional
tooltip_image
A URL da imagem da variante.
string
opcional
Warranty and Support
Este campo contém informações sobre as opções de garantia e suporte para o produto. Inclui uma descrição da garantia do produto e links para obter informações sobre garantia.
description
A descrição da garantia disponível para o produto.
string
links
Uma lista contendo mais informações sobre a garantia do produto.
array
links.title
O título da garantia.
string
links.url
Uma URL contendo mais informações sobre a garantia do produto.
string
Featured Merchant
Este campo fornece informações sobre o comerciante em destaque que vende o produto. Inclui detalhes como o nome do comerciante, seller ID, link para a página do comerciante, se o produto é fulfilled pela Amazon e a origem do envio.
name
O nome do vendedor principal.
string
seller_id
O ID do vendedor.
string
link
A URL da página do vendedor na Amazon.
string
is_amazon_fulfilled
Indica se um produto é fulfilled pela própria rede logística da Amazon
boolean
shipped_from (opcional)
Indica o local de envio.
string
Sales Rank
Este campo fornece informações sobre a posição de vendas do produto dentro de categorias específicas na Amazon. Cada objeto representa uma entrada de ranking de vendas, incluindo o rank em si e a ladder de categorias, mostrando a hierarquia de categorias que leva à categoria ranqueada.
rank
Indica a posição de ranking.
integer
ladder
Uma lista de informações mais detalhadas sobre a categoria em que o produto foi ranqueado.
array
ladder.url
A URL para a página relevante da categoria Bestsellers.
string
ladder.name
Indica a categoria na qual o produto foi ranqueado.
string
Delivery
Este campo fornece informações sobre opções de entrega para o produto, como o método de entrega mais rápido e datas estimadas de chegada.
type
Indica o tipo da entrega.
string
data
Uma lista de informações sobre a data de entrega.
object
date.from
O local de envio.
string
date.by
A data estimada de entrega.
string
Buy Box
A seção "buy box" na página de produto da Amazon onde os clientes podem comprar itens diretamente. Este campo fornece informações essenciais para compradores, incluindo o preço do produto, disponibilidade em estoque, opções de entrega e datas estimadas de chegada.
name
O nome da opção de precificação.
string
opcional
stock
O nível de estoque do produto.
string
opcional
delivery_type
Indica o tipo da entrega.
string
opcional
delivery_details
Uma lista de detalhes sobre a entrega do produto.
array
opcional
data
Uma lista de detalhes sobre a data de entrega.
object
opcional
delivery_details.by
A data estimada de entrega.
string
opcional
delivery_details.from
O local de envio do produto.
string
opcional
delivery_details.type
O tipo da entrega
string
opcional
condition
A condição do produto.
string
opcional
preço
O preço do produto.
float
Lightning Deal
Este campo fornece detalhes sobre um lightning deal na Amazon, oferecendo um preço com desconto por tempo limitado. Lightning deals são promoções com desconto por tempo limitado em produtos específicos, disponíveis por algumas horas em quantidades limitadas. Os clientes devem agir rapidamente, pois as ofertas expiram quando o tempo alocado ou o estoque se esgota. Os detalhes incluem a porcentagem reivindicada, preço com desconto e tempo restante antes que a oferta expire.
percent_claimed
O valor descontado comparado ao preço padrão.
string
price_text
O preço com desconto do produto.
string
expires
Indica a data de término da oferta lightning deal.
string
Product Overview
Esta seção fornece um resumo estruturado de vários atributos-chave relacionados a um produto.

product_overview
Uma lista de atributos-chave e suas descrições para o produto.
Array
title
O título do atributo do produto.
string
description
A descrição detalhada do atributo do produto.
string
Atualizado
Isto foi útil?

