Produto
Extraia dados de produtos da Amazon sem esforço com a Web Scraper API. Acesse títulos, preços, reviews e detalhes usando parâmetros personalizados e exemplos.
O amazon_product a fonte de dados foi projetada para recuperar páginas de produto da Amazon.
Exemplos de solicitação
Nos exemplos abaixo, fazemos uma solicitação para recuperar a página do produto para o ASIN B08Y72CH1F em amazon.nl do marketplace. Caso o ASIN fornecido seja um ASIN pai, pedimos à Amazon que retorne uma página de produto de uma variação selecionada automaticamente. A API retornará resultados analisados.
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
# Estruture o payload.
payload = {
'source': 'amazon_product',
'domain': 'nl',
'query': 'B08Y72CH1F',
'parse': True,
'context': [
{'key': 'autoselect_variant', 'value': True}
],
}
# Obtenha a resposta.
response = requests.request(
'POST',
'https://realtime.oxylabs.io/v1/queries',
auth=('USERNAME', 'PASSWORD'),
json=payload,
)
# Imprima a resposta formatada em stdout.
pprint(response.json())Usamos o método de integração Realtime síncrona em nossos exemplos. Se você quiser usar Proxy Endpoint ou a integração assíncrona Push-Pull , consulte a seção métodos de integração .
Valores dos parâmetros da solicitação
Genérico
Opções básicas de configuração e personalização para raspar páginas de produto da Amazon.
source
Define o scraper.
amazon_product
query
Código ASIN de 10 caracteres.
-
- parâmetro obrigatório
Localização
Ajusta os resultados para locais geográficos, domínios e idiomas específicos.
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.
Outros
Configurações e controles avançados adicionais para requisitos especializados.
context:
autoselect_variant
Para obter dados precisos de preço/buybox, defina este parâmetro como true (o que nos diz para 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 de produto do ASIN pai, omita este parâmetro ou defina-o como false.
false
Exemplo de código
Dados estruturados
O Web Scraper API é capaz de extrair um objeto HTML ou JSON que contém resultados de produtos da Amazon, oferecendo dados estruturados em vários elementos da página de resultados.
Dicionário de dados de saída
Navegue pelos detalhes usando a navegação à direita ou rolando para baixo na página.
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.
Exemplo de HTML
Estrutura JSON
A tabela abaixo apresenta uma lista detalhada de cada elemento da página de produto da Amazon que analisamos, 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 Número de Identificação Padrão da Amazon 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, analisada da seção 'Descrição do produto'.
string
bullet_points
Os itens em lista analisados da seção 'Sobre este produto'.
string
opcional
category
Uma lista contendo mais detalhes sobre a categoria do produto da Amazon.
array
opcional
variação
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 exibido na buybox.
float
deal_type
Identifica a categoria da oferta promocional.
string
opcional
cupom
Indica quaisquer descontos digitais disponíveis.
string
opcional
is_prime_eligible
Indica se o produto é elegível para o Amazon Prime.
booleano
is_addon_item
Indica se um produto está disponível para compra apenas quando incluído em pedidos que atingem um valor mínimo.
booleano
opcional
currency
A moeda na qual o preço é denominado.
string
discount_end
Indica a data final até a qual um desconto promocional para um produto da Amazon é válido.
string
opcional
estoque
Indica o nível de estoque do produto.
string
reviews_count
A contagem de avaliações do produto.
integer
reviews
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 do produto.
integer
opcional
pricing_url
A URL para recuperar as listagens de ofertas de produtos da Amazon.
string
opcional
pricing_str
Uma representação em string dos detalhes de preç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 destacado para um produto da Amazon.
object
opcional
sales_rank
Uma lista de informações sobre a posição de ranking de um produto da Amazon em sua respectiva categoria 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 que indicam as imagens do produto.
array
product_overview
Uma lista de atributos principais e suas descrições do 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 tem vídeos.
booleano
entrega
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 o tipo do produto, detalhando como ele é embalado ou entregue para uso.
string
opcional
sales_volume
A quantidade de unidades vendidas em um período específico.
string
opcional
other_sellers
Detalhes de outros vendedores que anunciam o produto, incluindo a quantidade de vendedores, o preço inicial entre eles e informações básicas de frete.
string
opcional
rating_stars_distribution
Uma lista de detalhes sobre as avaliações do produto.
array
opcional
buybox
Uma lista de detalhes sobre o preço 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 tem o selo Amazon's Choice.
booleano
opcional
coupon_discount_percentage
Indica o percentual de redução aplicável com um cupom.
integer
opcional
parent_asin
O identificador principal da família de produtos da Amazon à qual um produto está atribuído.
string
opcional
created_at
O timestamp em que o trabalho de scraping foi criado.
timestamp
updated_at
O timestamp em que o trabalho de scraping foi concluído.
timestamp
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
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
Categoria
Este campo mostra a estrutura hierárquica das categorias de produto de um produto da Amazon. Cada categoria na hierarquia é um objeto com um nome e uma URL, representando o caminho da categoria mais ampla até a subcategoria mais específica.
hierarquia
Uma lista contendo breadcrumbs do produto da Amazon.
array
hierarchy.name
O nome do breadcrumb/categoria do produto da Amazon.
string
hierarchy.url
A URL do breadcrumb/categoria.
string
Anúncios
Este campo contém informações sobre anúncios exibidos em uma 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
location
O nome da posição do anúncio da 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 exclusivo que denota 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 do produto.
integer
is_prime_eligible
Indica se o produto é elegível para o Amazon Prime.
booleano
preço
O preço do produto.
float
price_upper
O limite superior do preço, se aplicável.
float
Distribuição de estrelas da avaliação
Este campo contém a distribuição das avaliações por estrelas de um produto. Cada objeto representa uma classificação por estrelas e a porcentagem do total de avaliações que atribuíram essa nota.
rating
Indica o número da avaliação (escala de 5 a 1).
integer
percentage
Indica a porcentagem específica para essa avaliação.
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 alfanumérica da avaliação da Amazon.
string
title
A classificação e o título da avaliação.
string
author
O usuário que enviou a avaliação.
string
rating
A classificação por estrelas atribuída ao enviar a avaliação, normalmente entre 1 e 5.
integer
content
O texto completo do conteúdo da avaliação.
string
timestamp
A data e a localização da avaliação, formatadas conforme fornecidas pela Amazon.
string
profile_id
Identificador único do perfil do autor da avaliação, usado para vincular ao perfil dele na Amazon.
string
is_verified
Indica se a avaliação é de uma compra verificada.
booleano
review_from
Fornece contexto adicional sobre a origem da avaliação (por exemplo, avaliações específicas por local ou principais avaliações).
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 dica.
asin
O Número de Identificação Padrão da Amazon da variante do produto.
array
selecionado
Identifica a variante do produto selecionada.
booleano
dimensões
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
Garantia e Suporte
Este campo contém informações sobre as opções de garantia e suporte do produto. Inclui uma descrição da garantia do produto e links para obter informações sobre a 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
Vendedor em destaque
Este campo fornece informações sobre o vendedor em destaque que vende o produto. Inclui detalhes como o nome do vendedor, ID do vendedor, link para a página do vendedor, se o produto é atendido 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 da Amazon.
string
is_amazon_fulfilled
Indica se um produto é atendido pela própria rede logística da Amazon
booleano
shipped_from (opcional)
Indica a localização de envio.
string
Classificação de vendas
Este campo fornece informações sobre a classificação de vendas do produto em categorias específicas na Amazon. Cada objeto representa uma entrada de classificação de vendas, incluindo a própria classificação e a hierarquia de categorias, mostrando a estrutura de categorias que leva à categoria classificada.
rank
Indica a posição no ranking.
integer
hierarquia
Uma lista de informações mais detalhadas sobre a categoria em que o produto foi classificado.
array
hierarchy.url
A URL da página relevante da categoria de mais vendidos.
string
hierarchy.name
Indica a categoria em que o produto foi classificado.
string
Entrega
Este campo fornece informações sobre as opções de entrega do produto, como o método de entrega mais rápido e as datas estimadas de chegada.
type
Indica o tipo de entrega.
string
date
Uma lista de informações sobre a data de entrega.
object
date.from
A localização de envio.
string
date.by
A data estimada de entrega.
string
Buy Box
A seção "buy box" em uma 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 preço.
string
opcional
estoque
O nível de estoque do produto.
string
opcional
delivery_type
Indica o tipo de entrega.
string
opcional
delivery_details
Uma lista de detalhes sobre a entrega do produto.
array
opcional
date
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 de 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 uma lightning deal na Amazon, oferecendo um preço com desconto por tempo limitado. Lightning deals são promoções por tempo limitado com descontos significativos em produtos específicos, disponíveis por algumas horas em quantidades limitadas. Os clientes precisam agir rápido, pois as ofertas expiram quando o tempo alocado ou o estoque se esgota. Os detalhes incluem a porcentagem reivindicada, o preço com desconto e o tempo restante até a oferta expirar.
percent_claimed
O valor descontado em comparação com o preço padrão.
string
price_text
O preço do produto com desconto.
string
expires
Indica a data de término da oferta lightning deal.
string
Visão geral do produto
Esta seção fornece um resumo estruturado de vários atributos principais relacionados a um produto.

product_overview
Uma lista de atributos principais e suas descrições do 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?

