Pesquisa

Raspe resultados de pesquisa 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 foi projetado para recuperar páginas de resultados de busca da Amazon. Para ver o exemplo de resposta com os dados recuperados, baixe este exemplo de saída arquivo em formato HTML ou confira a saída de dados estruturados aqui.

Explorar saída dicionário de dados para cada recurso de Amazon Search, 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.

Exemplos de solicitaçã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 da página #2 , para o termo de busca nirvana tshirt. Além disso, a busca será limitada ao ID da 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 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

Configuração básica e opções de personalização para raspar resultados de busca da Amazon.

Parâmetro
Descrição
Valor padrão

source

Define o scraper.

amazon_search

query

A palavra-chave ou frase para pesquisar.

-

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

context: currency

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

-

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

-

Paginação

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

Parâmetro
Descrição
Valor padrão

start_page

Número da página inicial.

1

pages

Número de páginas para recuperar.

1

Ordenação e filtragem

Controles para ordenação e filtragem de 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 de acordo com um dos valores possíveis 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. Esses parâmetros correspondem às opções de filtragem dinâmicas da Amazon (por exemplo, marca, faixa de preço, recursos) e seguem o formato 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 por meio do campo refinements para aplicar filtros específicos

-

context: category_id

Busque itens em um node específico da Amazon (categoria de produto).

-

context: merchant_id

Busque itens vendidos por um vendedor específico.

-

Dados estruturados

amazon_search saída estruturada

A amostra de saída está abreviada.

Dicionário de dados de saída

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

Exemplo de HTML

Estrutura JSON

Todos os resultados da busca estão contidos no resultados array JSON. Cada resultado da busca inclui uma combinação de paid, organic, sugeridos, amazons_choices,instant_recommendations listings. Além disso, variações podem estar presentes, e elas são capturadas na chave variations 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

resultados

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 análise. Você pode ver os códigos de status do parser descritos aqui.

integer

total_results_count

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

integer

created_at

O timestamp em que o trabalho de scraping foi criado.

string

updated_at

O timestamp em que o trabalho de scraping foi concluído.

string

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

parser_type

O tipo de analisador usado para processar os dados.

string

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.

Pago

O paid seção dos resultados da busca refere-se ao 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 da busca.

(seja pos ou rel_pos está presente)

integer

pos

Um indicador exclusivo que denota a posição na listagem. (seja pos ou rel_pos está presente)

integer

currency

A moeda na qual o preço é denominado.

string

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um best seller.

booleano

price_upper

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

float

is_sponsored

Indica se o produto é patrocinado.

booleano

manufacturer

O nome do fabricante do produto.

string

pricing_count

A contagem de ofertas do produto.

integer

reviews_count

A contagem de avaliações do produto.

integer

coupon_discount

O valor do desconto.

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

booleano

no_price_reason

Indicador de por que 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 produto específico.

string (opcional)

is_prime

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

booleano

shipping_information

Informações sobre os detalhes de envio do produt

string

Orgânico

O organic seção dos resultados da 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 exclusivo que denota 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

currency

A moeda na qual o preço é denominado.

string

is_prime

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

booleano

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um best seller.

booleano

price_upper

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

float

is_sponsored

Indica se o produto é patrocinado.

booleano

manufacturer

O nome do fabricante do produto.

string

sales_volume

O volume de vendas ou número de unidades vendidas de um produto específico.

string (opcional)

pricing_count

A contagem de preços do produto.

integer

reviews_count

A contagem de avaliações do produto.

integer

coupon_discount

O valor do desconto.

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.

booleano

price_strikethrough

Preço original antes de quaisquer descontos.

float

shipping_information

Datas de entrega e detalhes do custo de envio.

string

no_price_reason

Indicador de por que 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

Sugeridos

O sugeridos seção nos resultados da 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

currency

A moeda na qual o preço é denominado.

string

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um best seller.

booleano

price_upper

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

float

is_sponsored

Indica se o produto é patrocinado.

booleano

manufacturer

O nome do fabricante do produto.

string

pricing_count

A contagem de preços do produto.

integer

reviews_count

A contagem de avaliações do produto.

integer

coupon_discount

O valor do desconto.

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.

booleano

pos

Um indicador exclusivo que denota a posição na listagem.

integer

is_prime

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

booleano

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 produto específico.

string (opcional)

no_price_reason

Indicador de por que 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 da busca.

string

Escolhas da Amazon

O amazons_choices seção apresenta produtos com o selo 'Amazon's Choice' e são recomendados pela plataforma pela qualidade e valor percebidos.

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

currency

A moeda na qual o preço é denominado.

string

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um best seller.

booleano

price_upper

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

float

is_sponsored

Indica se o produto é patrocinado.

booleano

manufacturer

O nome do fabricante do produto.

string

pricing_count

A contagem de preços do produto.

integer

reviews_count

A contagem de avaliações do produto.

integer

coupon_discount

O valor do desconto.

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.

booleano

pos

Um indicador exclusivo que denota a posição na listagem.

integer

is_prime

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

booleano

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 produto específico.

string (opcional)

no_price_reason

Indicador de por que 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

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

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

booleano

Atualizado

Isto foi útil?