For the complete documentation index, see llms.txt. This page is also available as Markdown.

Busca

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

A amazon_search fonte foi projetada para recuperar páginas de resultados de pesquisa da Amazon. Para ver o exemplo de resposta com os dados recuperados, baixe este arquivo de saída de exemplo em formato HTML ou confira a saída de dados estruturados aqui.

Explorar a saída dicionário de dados para cada funcionalidade do Amazon Search, oferecendo uma breve descrição, captura de tela, trecho de código JSON analisado e uma tabela que define cada campo analisado. Navegue pelos detalhes usando a navegação do lado direito ou rolando a página para baixo.

Exemplos de requisição

Nos exemplos de código abaixo, fazemos uma solicitação para recuperar um resultado de amazon.com, que inclui 2 páginas de resultados de pesquisa, começando na página #2 , para o termo de pesquisa nirvana tshirt. Além disso, a pesquisa 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"}
        ]
    }'
import requests
from pprint import pprint


# Structure payload.
payload = {
    '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"}
    ],
}


# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

Usamos o método de integração síncrona Realtime em nossos exemplos. Se você quiser usar Proxy Endpoint ou assíncrona Push-Pull integração, consulte a seção sobre métodos de integração .

Valores dos parâmetros da solicitação

Geral

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

Parâmetro
Descrição
Valor padrão

source

Define o scraper.

amazon_search

query

A palavra-chave ou frase a pesquisar.

-

render

Ativa 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 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. Confira os valores disponíveis aqui.

-

- parâmetro obrigatório

Localização

Adapte os resultados a locais geográficos, domínios e idiomas específicos.

Parâmetro
Descrição
Valor padrão

geo_location

A Entregar para localização. Veja nosso guia para usar este parâmetro aqui.

-

domain

Localização de domínio da 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.

-

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

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

context: sort_by

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

-

context: refinements

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

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

  1. Primeiro, faça scraping da 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 processada

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

-

context: min_price / max_price

Filtra resultados por faixa de preço. Ambos os valores são expressos em centavos, não na unidade principal da moeda: min_price: 5000 com max_price: 10000 retorna produtos entre $50.00 e $100.00. Deve ser inteiros positivos. Qualquer um pode ser usado sozinho.

context: category_id

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

-

context: merchant_id

Busca itens vendidos por um vendedor específico.

-

Dados estruturados

amazon_search saída estruturada

O exemplo de saída está abreviado.

Dicionário de dados de saída

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

Exemplo de HTML

Estrutura JSON

Todos os resultados da pesquisa estão contidos no results array JSON. Cada resultado da pesquisa inclui uma combinação de paid, organic, suggested, amazons_choices,instant_recommendations listagens. 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.

inteiro

pages

O número total de páginas.

inteiro

query

A consulta de pesquisa usada.

string

results

Um dicionário contendo os resultados da pesquisa.

objeto

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

inteiro

total_results_count

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

inteiro

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.

inteiro

parser_type

O tipo de parser usado para processar os dados.

string

Nas seções a seguir, os trechos de código JSON processado são abreviados quando há mais de um item disponível para o tipo de resultado.

Patrocinados

A paid seção dos resultados da pesquisa se refere 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

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

string

preço

O preço do produto.

decimal

título

O título do produto.

string

avaliação

A avaliação do produto.

decimal

rel_pos

A posição relativa do produto nos resultados da pesquisa.

(seja pos ou rel_pos está presente)

inteiro

pos

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

inteiro

currency

A moeda em que o preço está denominado.

string

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um mais vendido.

booleano

price_upper

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

decimal

is_sponsored

Indica se o produto é patrocinado.

booleano

fabricante

O nome do fabricante do produto.

string

pricing_count

A contagem de ofertas do produto.

inteiro

reviews_count

A contagem de avaliações do produto.

inteiro

coupon_discount

O valor do desconto.

inteiro (opcional)

coupon_discount_type

O tipo de desconto: nominal ou porcentagem.

string (opcional)

is_amazons_choice

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

booleano

no_price_reason

Indicador do motivo pelo qual 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 produto

string

Orgânicos

A organic seção dos resultados da pesquisa se refere 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 listagem.

inteiro

url

A URL do produto.

string

asin

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

string

preço

O preço do produto.

decimal

título

O título do produto.

string

avaliação

A avaliação do produto.

decimal

currency

A moeda em que o preço está 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 mais vendido.

booleano

price_upper

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

decimal

is_sponsored

Indica se o produto é patrocinado.

booleano

fabricante

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.

inteiro

reviews_count

A contagem de avaliações do produto.

inteiro

coupon_discount

O valor do desconto.

inteiro (opcional)

coupon_discount_type

O tipo de desconto: nominal ou porcentagem.

string (opcional)

is_amazons_choice

Indica se o produto é a escolha da Amazon.

booleano

price_strikethrough

Preço original antes de quaisquer descontos.

decimal

shipping_information

Datas de entrega e detalhes do custo de envio.

string

no_price_reason

Indicador do motivo pelo qual 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

A suggested seção nos resultados da pesquisa normalmente contém listagens de produtos recomendadas pela plataforma com base na consulta de pesquisa 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.

decimal

título

O título do produto.

string

avaliação

A avaliação do produto.

decimal

currency

A moeda em que o preço está denominado.

string

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um mais vendido.

booleano

price_upper

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

decimal

is_sponsored

Indica se o produto é patrocinado.

booleano

fabricante

O nome do fabricante do produto.

string

pricing_count

A contagem de preços do produto.

inteiro

reviews_count

A contagem de avaliações do produto.

inteiro

coupon_discount

O valor do desconto.

inteiro (opcional)

coupon_discount_type

O tipo de desconto: nominal ou porcentagem.

string (opcional)

is_amazons_choice

Indica se o produto é a escolha da Amazon.

booleano

pos

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

inteiro

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 do motivo pelo qual 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 pesquisa.

string

Escolhas da Amazon

A amazons_choices a 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

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

string

preço

O preço do produto.

decimal

título

O título do produto.

string

avaliação

A avaliação do produto.

decimal

currency

A moeda em que o preço está denominado.

string

url_image

A URL da imagem do produto.

string

best_seller

Indica se o produto é um mais vendido.

booleano

price_upper

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

decimal

is_sponsored

Indica se o produto é patrocinado.

booleano

fabricante

O nome do fabricante do produto.

string

pricing_count

A contagem de preços do produto.

inteiro

reviews_count

A contagem de avaliações do produto.

inteiro

coupon_discount

O valor do desconto.

inteiro (opcional)

coupon_discount_type

O tipo de desconto: nominal ou porcentagem.

string (opcional)

is_amazons_choice

Indica se o produto é a escolha da Amazon.

booleano

pos

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

inteiro

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 do motivo pelo qual 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

A 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

título

Título da variação

string

preço

Preço da variação

decimal

price_strikethrough

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

decimal

not_available

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

booleano

Atualizado

Isto foi útil?