Search

Raspe resultados de busca da Amazon com a Web Scraper API. Recupere títulos de produtos, preços, avaliações e mais com renderização JS, geolocalização e exemplos.

O amazon_search source é projetado para recuperar páginas de resultados de busca da Amazon. Para ver o exemplo de resposta com os dados recuperados, baixe isto exemplo de saídaarrow-up-right arquivo em formato HTML ou verifique a saída de dados estruturados aqui.

circle-info

Explorar saída dicionário de dados para cada recurso de Busca da Amazon, oferecendo uma breve descrição, captura de tela, trecho de código JSON parseado e uma tabela definindo cada campo parseado. Navegue pelos detalhes usando a navegação à direita ou rolando a página para baixo.

Amostras de requisição

Nos exemplos de código abaixo, fazemos uma requisição para recuperar um resultado de amazon.com, que inclui 2 páginas de resultados de busca, começando pela página #2 , para o termo de busca nirvana tshirt. Além disso, a busca será limitada ao ID de categoria: 16391693031 e os preços são exibidos em USD moeda.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "amazon_search",
        "domain": "com",
        "query": "nirvana tshirt",
        "start_page": 2,
        "pages": 2,
        "parse": true,
        "context": [
                {"key": "category_id", "value": "16391693031"},
                {"key": "currency", "value": "USD"},
                {"key": "refinements", "value": ["p_123:256097"]},
                {"key": "sort_by", "value": "featured"}
        ]
    }'

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 extrair resultados de busca da Amazon.

Parâmetro
Descrição
Valor Padrão

source

Define o scraper.

amazon_search

query

A palavra-chave ou frase a ser pesquisada.

-

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

context: moeda

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

-

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

Paginação

Controles para gerenciar a paginação e recuperação dos resultados de pesquisa.

Parâmetro
Descrição
Valor Padrão

start_page

Número da página inicial.

1

pages

Número de páginas a recuperar.

1

Ordenação e filtragem

Controles para ordenação e filtragem das páginas de resultados de busca.

Parâmetro
Descrição
Valor Padrão

sort_by

Define o tipo de ordenação da página de resultados de busca segundo um dos possíveis valores na Amazon: "most_recent", "price_low_to_high", "price_high_to_low", "featured", "average_review", "bestsellers".

-

refinements

Uma lista de parâmetros de refinamento de busca da Amazon usados para aplicar filtros específicos aos resultados de busca. Esses parâmetros correspondem às opções de filtragem dinâmicas da Amazon (por exemplo, marca, faixa de preço, características) e seguem o formato de parâmetros interno da Amazon como p_123:256097 ou p_n_feature_twenty-eight_browse-bin:98209020031.

Como as opções de filtragem variam por categoria e são geradas dinamicamente pela Amazon, o fluxo de trabalho recomendado é:

  1. Primeiro, raspe a página de busca alvo da Amazon com parse: true para descobrir as opções de refinamento disponíveis

  2. Extraia os parâmetros de filtro desejados da resposta parseada

  3. Use esses parâmetros em requisições subsequentes via o refinements campo para aplicar filtros específicos

-

context: category_id

Pesquisar itens em um nó específico da Amazon (categoria de produto).

-

context: merchant_id

Pesquisar itens vendidos por um vendedor específico.

-

Dados estruturados

chevron-rightamazon_search saída estruturadahashtag
circle-info

A amostra de saída está encurtada.

Dicionário de dados de saída

A API retorna um objeto HTML ou JSON que contém os resultados de busca obtidos da Amazon.

Exemplo em HTML

Estrutura JSON

Todos os resultados de busca estão contidos dentro do results array JSON. Cada resultado de busca inclui uma combinação de pago, organic, sugeridos, amazons_choices,instant_recommendations listagens. Adicionalmente, variações podem estar presentes, e elas são capturadas dentro da variations chave, fornecendo detalhes sobre diferentes tipos ou categorias de produtos, como vários modelos, edições ou versões.

Chave
Descrição
Tipo

url

A URL da página de busca da Amazon.

string

page

O número da página atual.

integer

pages

O número total de páginas.

integer

query

A consulta de busca usada.

string

results

Um dicionário contendo os resultados da pesquisa.

object

results.paid

Uma lista de produtos patrocinados com seus respectivos detalhes.

array

results.organic

Uma lista de produtos orgânicos com seus respectivos detalhes.

array

results.suggested

Uma lista de produtos sugeridos com seus respectivos detalhes.

array

results.amazons_choices

Uma lista das escolhas da Amazon com seus respectivos detalhes.

array

refinements

Uma lista de refinamentos disponíveis nesta página de busca.

array

parse_status_code

O código de status do trabalho de parsing. Você pode ver os códigos de status do parser descritos aquiarrow-up-right.

integer

total_results_count

O número total de resultados encontrados para a consulta de pesquisa.

integer

created_at

O timestamp quando o trabalho de scraping foi criado.

string

updated_at

O timestamp quando o trabalho de scraping foi finalizado.

string

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

parser_type

O tipo de parser usado para analisar os dados.

string

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.

Pago

O pago a seção dos resultados de busca refere-se a conteúdo de anúncio inline exibido dentro dos resultados de busca da Amazon.

Chave
Descrição
Tipo

url

A URL do produto.

string

asin

Número de Identificação Padrão da Amazon.

string

preço

O preço do produto.

float

title

O título do produto.

string

rating

A avaliação do produto.

float

rel_pos

A posição relativa do produto nos resultados de busca.

(ou pos ou rel_pos está presente)

integer

pos

Um indicador único denotando a posição na listagem. (ou pos ou rel_pos está presente)

integer

moeda

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

string

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um best seller.

boolean

price_upper

O limite superior do preço, se aplicável.

float

is_sponsored

Indica se o produto é patrocinado.

boolean

manufacturer

O nome do fabricante do produto.

string

pricing_count

A contagem de ofertas para o produto.

integer

reviews_count

A contagem de avaliações para o produto.

integer

coupon_discount

O valor descontado.

integer (opcional)

coupon_discount_type

O tipo de desconto: nominal ou percentage.

string (opcional)

is_amazons_choice

Indica se o produto está marcado como "Amazon's choice".

boolean

no_price_reason

Indicador do porquê o preço não está presente, se for igual a 0.0

string (opcional)

sales_volume

O volume de vendas ou número de unidades vendidas de um determinado produto.

string (opcional)

is_prime

Indica se o produto é elegível para o Amazon Prime.

boolean

shipping_information

Informações sobre os detalhes de envio do produto

string

Orgânico

O organic a seção dos resultados de busca refere-se ao conteúdo não patrocinado que aparece naturalmente com base no algoritmo de busca da Amazon.

Nome
Descrição
Tipo

pos

Um indicador único denotando a posição na listagem.

integer

url

A URL do produto.

string

asin

Número de Identificação Padrão da Amazon.

string

preço

O preço do produto.

float

title

O título do produto.

string

rating

A avaliação do produto.

float

moeda

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

string

is_prime

Indica se o produto é elegível para o Amazon Prime.

boolean

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um best seller.

boolean

price_upper

O limite superior do preço, se aplicável.

float

is_sponsored

Indica se o produto é patrocinado.

boolean

manufacturer

O nome do fabricante do produto.

string

sales_volume

O volume de vendas ou número de unidades vendidas de um determinado produto.

string (opcional)

pricing_count

A contagem de preços para o produto.

integer

reviews_count

A contagem de avaliações para o produto.

integer

coupon_discount

O valor descontado.

integer (opcional)

coupon_discount_type

O tipo de desconto: nominal ou percentage.

string (opcional)

is_amazons_choice

Indica se o produto é a escolha da Amazon.

boolean

price_strikethrough

Preço original antes de quaisquer descontos.

float

shipping_information

Datas de entrega e detalhes de custo de envio.

string

no_price_reason

Indicador do porquê o preço não está presente, se for igual a 0.0

string (opcional)

variations

Lista de diferentes versões ou modelos de um produto

Array

Sugerido

O sugeridos a seção sugerida nos resultados de busca normalmente contém listagens de produtos recomendadas pela plataforma com base na consulta de busca do usuário, histórico de navegação ou comportamento de compra.

Chave
Descrição
Tipo

url

A URL do produto.

string

asin

Número de Identificação Padrão da Amazon.

string

preço

O preço do produto.

float

title

O título do produto.

string

rating

A avaliação do produto.

float

moeda

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

string

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um best seller.

boolean

price_upper

O limite superior do preço, se aplicável.

float

is_sponsored

Indica se o produto é patrocinado.

boolean

manufacturer

O nome do fabricante do produto.

string

pricing_count

A contagem de preços para o produto.

integer

reviews_count

A contagem de avaliações para o produto.

integer

coupon_discount

O valor descontado.

integer (opcional)

coupon_discount_type

O tipo de desconto: nominal ou percentage.

string (opcional)

is_amazons_choice

Indica se o produto é a escolha da Amazon.

boolean

pos

Um indicador único denotando a posição na listagem.

integer

is_prime

Indica se o produto é elegível para o Amazon Prime.

boolean

shipping_information

Informações sobre os detalhes de envio do produto.

string

sales_volume

O volume de vendas ou número de unidades vendidas de um determinado produto.

string (opcional)

no_price_reason

Indicador do porquê o preço não está presente, se for igual a 0.0

string (opcional)

suggested_query

A consulta sugerida fornecida pela Amazon como parte dos resultados de busca.

string

Escolhas da Amazon

O amazons_choices a seção apresenta produtos com o selo 'Amazon's Choice' e são recomendados pela plataforma por sua percepção de qualidade e valor.

Chave
Descrição
Tipo

url

A URL do produto.

string

asin

Número de Identificação Padrão da Amazon.

string

preço

O preço do produto.

float

title

O título do produto.

string

rating

A avaliação do produto.

float

moeda

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

string

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um best seller.

boolean

price_upper

O limite superior do preço, se aplicável.

float

is_sponsored

Indica se o produto é patrocinado.

boolean

manufacturer

O nome do fabricante do produto.

string

pricing_count

A contagem de preços para o produto.

integer

reviews_count

A contagem de avaliações para o produto.

integer

coupon_discount

O valor descontado.

integer (opcional)

coupon_discount_type

O tipo de desconto: nominal ou percentage.

string (opcional)

is_amazons_choice

Indica se o produto é a escolha da Amazon.

boolean

pos

Um indicador único denotando a posição na listagem.

integer

is_prime

Indica se o produto é elegível para o Amazon Prime.

boolean

shipping_information

Informações sobre os detalhes de envio do produto.

string

sales_volume

O volume de vendas ou número de unidades vendidas de um determinado produto.

string (opcional)

no_price_reason

Indicador do porquê o preço não está presente, se for igual a 0.0

string (opcional)

variations

Lista de diferentes versões ou modelos de um produto

Array

Variações

O variations a seção lista diferentes versões ou modelos de um produto, fornecendo uma visão detalhada das opções disponíveis na categoria especificada.

Chave
Descrição
Tipo

asin

Amazon Standard Identification Number

string

title

Título da variação

string

preço

Preço da variação

float

price_strikethrough

O preço original antes de quaisquer descontos ou promoções

float

not_available

Indica se a variação está atualmente indisponível

boolean

Atualizado

Isto foi útil?