For the complete documentation index, see llms.txt. This page is also available as Markdown.

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
            }
        ]
    }'

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.

Parâmetro
Descrição
Valor padrão

source

Define o scraper.

amazon_product

query

Código ASIN de 10 caracteres.

-

render

Habilita a renderização de JavaScript quando definido como html. Mais informações.

-

parse

Retorna dados analisados quando definido como true. Explore a saída dicionário de dados.

false

callback_url

URL para seu endpoint de callback. Mais informações.

-

user_agent_type

Tipo de dispositivo e navegador. A lista completa pode ser encontrada aqui.

desktop

- 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.

-

Outros

Configurações e controles avançados adicionais para requisitos especializados.

Parâmetro
Descrição
Valor padrão

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

context: currency

Define a moeda. Confira os valores disponíveis aqui.

Depende do marketplace. Confira os valores padrão aqui.

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.

amazon_product saída estruturada

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.

Chave
Descrição
Tipo
Layout

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.

Chave (categoria)
Descrição
Tipo

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.

Chave (anúncios)
Descrição
Tipo

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.

Chave (rating_stars_distribution)
Descrição
Tipo

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.

Chave (reviews)
Descrição
Tipo

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.

Chave (variações)
Descrição
Tipo
Layout

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.

Chave (warranty_and_support)
Descrição
Tipo

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.

Chave(featured_merchant)
Descrição
Tipo

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.

Chave(sales_rank)
Descrição
Tipo

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.

Chave (delivery)
Descrição
Tipo

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.

Chave (buybox)
Descrição
Tipo
Layout

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.

Chave(lightning_deal)
Descrição
Tipo

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.

Chave(product_overview)
Descrição
Tipo

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?