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.
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.
source
Define o scraper.
amazon_search
query
A palavra-chave ou frase a pesquisar.
-
- parâmetro obrigatório
Localização
Adapte os resultados a locais geográficos, domínios e idiomas específicos.
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.
-
IMPORTANTE: Na maioria dos tipos de página, a Amazon adapta os resultados retornados com base no local de entrega dos clientes. Portanto, recomendamos usar o geo_location parâmetro para definir seu local de entrega preferido. Você pode ler mais sobre o uso de geo_location com a Amazon aqui.
Paginação
Controles para gerenciar a paginação e a recuperação dos resultados de pesquisa.
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.
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 é:
Primeiro, faça scraping da página de busca alvo da Amazon com
parse: truepara descobrir as opções de refinamento disponíveisExtraia os parâmetros de filtro desejados da resposta processada
Use esses parâmetros em requisições subsequentes via o
refinementscampo 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
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.
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
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.

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.

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.

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.

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.

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?

