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

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.

Parâmetro
Descrição
Valor Padrão

source

Define o scraper.

amazon_product

query

Código ASIN de 10 caracteres.

-

render

Ativa a renderização JavaScript quando definido como html. Mais info.

-

parse

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

false

callback_url

URL para o seu endpoint de callback. Mais info.

-

user_agent_type

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

desktop

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

-

circle-exclamation

Outros

Configurações avançadas adicionais e controles 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 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

context: moeda

Define a moeda. Verifique os valores disponíveis aquiarrow-up-right.

Depende do marketplace. Verifique os valores padrão aquiarrow-up-right.

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.

chevron-rightamazon_product saída estruturadahashtag

Dicionário de dados de saída

Navegue pelos detalhes usando a navegação do lado direito ou rolando a página para baixo.

circle-info

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.

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

Key (category)
Descrição
Tipo

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.

Key (ads)
Descrição
Tipo

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.

Key (rating_stars_distribution)
Descrição
Tipo

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.

Key (reviews)
Descrição
Tipo

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.

Key (variations)
Descrição
Tipo
Layout

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.

Key (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

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.

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

Key(sales_rank)
Descrição
Tipo

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.

Key (delivery)
Descrição
Tipo

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.

Key (buybox)
Descrição
Tipo
Layout

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.

Key(lightning_deal)
Descrição
Tipo

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.

Key(product_overview)
Descrição
Tipo

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?