Produto

Extraia dados de produtos do Amazon sem esforço com a Web Scraper API. Acesse títulos, preços, avaliações e detalhes usando parâmetros e exemplos personalizados.

O amazon_product fonte de dados projetada para recuperar páginas de produto da Amazon.

Exemplos de requisição

Nos exemplos abaixo, fazemos uma solicitação para recuperar a página do produto para ASIN B08Y72CH1F em amazon.nl mercado. Caso o ASIN fornecido seja um ASIN pai, pedimos à Amazon para retornar a página de um 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íncrono em nossos exemplos. Se você quiser usar Proxy Endpoint ou integração assíncrona Push-Pull consulte os métodos de integração na seção.

Valores dos parâmetros da requisição

Genérico

Configuração básica e opções de personalização para extrair 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

Ativa a renderização 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 do 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

Adapte os resultados a localidades geográficas específicas, domínios, idiomas.

Parâmetro
Descrição
Valor padrão

geo_location

O Entregar para local. Veja nosso guia para usar este parâmetro aqui.

-

domain

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 informações.

-

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 de preço/buybox precisos, defina este parâmetro como true (o que nos informa para anexar o 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: currency

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

O 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 a seguir, trechos de código JSON analisados 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 nós extraímos, incluindo sua descrição, tipo de dado e se o elemento está sempre presente no layout ou é opcional, dependendo do produto que você decidir extrair. A tabela também inclui alguns metadados.

Chave
Descrição
Tipo
Layout

url

A URL do produto na Amazon.

string

page

O número da página atual.

integer

page_type

Identifica o tipo da página da Amazon.

string

asin

Amazon Standard Identification Number.

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, extraída da seção 'Product description'.

string

bullet_points

Os itens em bullet points extraídos da seção 'About this product'.

string

opcional

category

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

price

O preço do produto.

float

price_upper

O limite superior do preço.

float

opcional

price_sns

Indica 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 somente quando incluído em pedidos que alcançam um valor mínimo.

boolean

opcional

currency

A moeda na qual o preço está denominad0.

string

discount_end

Indica a data final em que um desconto promocional para um produto da Amazon é válido.

string

opcional

stock

Indica o nível de inventário 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 para o produto.

integer

opcional

pricing_url

A URL para recuperar a lista de ofertas do produto na 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 ou fornecedor em destaque para um produto da Amazon.

object

opcional

sales_rank

Uma lista de informações sobre a posição de classificação de um produto da Amazon dentro de sua respectiva categoria com base no 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 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 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 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 pode 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 para a família de produtos Amazon à 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

Categoria

Este campo mostra a estrutura hierárquica das categorias de produto para um produto da Amazon. Cada categoria na ladder é um objeto com um nome e URL, representando o caminho da categoria mais ampla até a subcategoria mais específica.

Chave (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 um 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 Prime e preço.

Chave (ads)
Descrição
Tipo

type

O tipo do anúncio da Amazon.

string

location

O nome do posicionamento do anúncio na Amazon.

string

title

O título do produto.

string

asin

Amazon Standard Identification Number.

string

images

A URL da(s) imagem(ns) do produto.

string

pos

Um indicador único 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.

boolean

price

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 em estrelas para um produto. Cada objeto representa uma avaliação em estrelas e a porcentagem do total de avaliações que deu 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 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.

Chave (reviews)
Descrição
Tipo

id

Uma identificação alfanumérica para a Avaliação da Amazon.

string

title

A avaliação por estrelas e o título da avaliação.

string

autor

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

conteúdo

O texto completo do conteúdo da avaliação.

string

timestamp

A data e o local da avaliação, formatados conforme fornecido pela Amazon.

string

profile_id

Identificador único do 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 local 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 dica (tooltip).

Chave (variations)
Descrição
Tipo
Layout

asin

O Amazon Standard Identification Number da variante do produto.

array

selecionado

Identifica a variante de produto selecionada.

boolean

dimensões

As dimensões da variante do produto.

object

opcional

dimensões.size

O tamanho da variante do produto.

string

opcional

dimensões.color

A cor da variante do produto.

string

opcional

dimensões.style

O estilo da variante do produto.

string

opcional

dimensões.unit count

A contagem padrão de unidades da variante do produto.

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 está vendendo o produto. Inclui detalhes como o nome do vendedor, ID do vendedor, link para a página do vendedor, se o produto é cumprido 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 na Amazon.

string

is_amazon_fulfilled

Indica se um produto é cumprido pela própria rede logística da Amazon

boolean

shipped_from (opcional)

Indica o local de envio.

string

Ranking de Vendas

Este campo fornece informações sobre o ranking de vendas do produto dentro de categorias específicas na Amazon. Cada objeto representa uma entrada de ranking de vendas, incluindo o próprio rank e a hierarquia de categorias, mostrando a estrutura de categorias que leva à categoria ranqueada.

Chave(sales_rank)
Descrição
Tipo

rank

Indica a posição no ranking.

integer

ladder

Uma lista com informações mais detalhadas sobre a categoria na qual 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

Entrega

Este campo fornece informações sobre as opções de entrega para o 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 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 do produto na Amazon onde os clientes podem comprar itens diretamente. Este campo fornece informações essenciais para os compradores, incluindo o preço do produto, disponibilidade de 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

stock

O nível de inventário 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 de entrega

string

opcional

condição

A condição do produto.

string

opcional

price

O preço do produto.

float

Oferta Relâmpago

Este campo fornece detalhes sobre uma oferta relâmpago na Amazon, oferecendo um preço com desconto por tempo limitado. Ofertas relâmpago são promoções limitadas no tempo com descontos significativos em produtos específicos, disponíveis por algumas horas em quantidades limitadas. Os clientes devem agir rapidamente, pois as ofertas expiram quando o tempo ou o estoque alocados acabam. Os detalhes incluem a porcentagem reclamada, o preço com desconto e o tempo restante antes da expiração da oferta.

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 relâmpago.

string

Visão Geral do Produto

Esta seção fornece um resumo estruturado de vários atributos-chave relacionados a um produto.

Chave(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?