Busca

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

O amazon_search a fonte foi projetada para recuperar páginas de resultados de busca da Amazon. Para ver o exemplo de resposta com os dados recuperados, baixe este arquivo de saída de amostraarrow-up-right 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 Pesquisa da Amazon, oferecendo uma breve descrição, captura de tela, trecho de código JSON analisado e uma tabela definindo cada campo analisado. Navegue pelos detalhes usando a navegação lateral 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 é 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 assíncrono Push-Pull como integração, consulte os métodos de integração da seção.

Valores dos parâmetros de requisição

Genérico

Configuração básica e opções de personalização para extrair resultados de pesquisa 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 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 o 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. Verifique os valores disponíveis aquiarrow-up-right.

-

- parâmetro obrigatório

Localização

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

-

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

Paginação

Controles para gerenciar a paginação e a 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 serem recuperadas.

1

Ordenação e filtragem

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

Parâmetro
Descrição
Valor Padrão

sort_by

Define o tipo de ordenação da página de resultados de acordo com 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 pesquisa da Amazon usados para aplicar filtros específicos aos resultados de pesquisa. 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 de parâmetro 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, extraia a página de pesquisa 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 analisada

  3. Use esses parâmetros em solicitações subsequentes através do refinements campo para aplicar filtros específicos

-

context: category_id

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

-

context: merchant_id

Pesquise 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 da pesquisa obtidos da Amazon.

Exemplo de HTML

Estrutura JSON

Todos os resultados de pesquisa estão contidos dentro do results array JSON. Cada resultado de pesquisa inclui uma combinação de paid, organic, suggested, amazons_choices,instant_recommendations listings. Além disso, variações podem estar presentes, e elas são capturadas dentro do 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 pesquisa utilizada.

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

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 carimbo de data/hora quando o trabalho de scraping foi criado.

string

updated_at

O carimbo de data/hora 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 a seguir, trechos de código JSON analisados são encurtados quando há mais de um item disponível para o tipo de resultado.

Pago

O paid a seção dos resultados de pesquisa refere-se a conteúdo de anúncio inline que é exibido dentro dos resultados de pesquisa da Amazon.

Chave
Descrição
Tipo

url

A URL do produto.

string

asin

Amazon Standard Identification Number.

string

price

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

(ou pos ou rel_pos está presente)

integer

pos

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

integer

currency

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

boolean

price_upper

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

float

is_sponsored

Indica se o produto é patrocinado.

boolean

fabricante

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

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 seção dos resultados de busca refere-se a conteúdo não patrocinado que aparece naturalmente com base no algoritmo de busca da Amazon.

Nome
Descrição
Tipo

pos

Um indicador único que denota a posição na lista.

integer

url

A URL do produto.

string

asin

Amazon Standard Identification Number.

string

price

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

boolean

price_upper

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

float

is_sponsored

Indica se o produto é patrocinado.

boolean

fabricante

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

boolean

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 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 suggested seção 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

Amazon Standard Identification Number.

string

price

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 está denominado.

string

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um mais vendido.

boolean

price_upper

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

float

is_sponsored

Indica se o produto é patrocinado.

boolean

fabricante

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

boolean

pos

Um indicador único que denota a posição na lista.

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 seção apresenta produtos com o selo 'Amazon's Choice' e são recomendados pela plataforma por sua qualidade e valor percebidos.

Chave
Descrição
Tipo

url

A URL do produto.

string

asin

Amazon Standard Identification Number.

string

price

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 está denominado.

string

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um mais vendido.

boolean

price_upper

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

float

is_sponsored

Indica se o produto é patrocinado.

boolean

fabricante

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

boolean

pos

Um indicador único que denota a posição na lista.

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

price

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?