Búsqueda
Haz scraping de resultados de búsqueda de Amazon con Web Scraper API. Recupera títulos de productos, precios, valoraciones y más con renderizado JS, geolocalización y ejemplos.
El amazon_search source está diseñado para recuperar páginas de resultados de búsqueda de Amazon. Para ver el ejemplo de respuesta con los datos recuperados, descarga este resultado de ejemplo archivo en formato HTML o revisa la salida de datos estructurados aquí.
Explorar salida diccionario de datos para cada función de Amazon Search, ofreciendo una breve descripción, captura de pantalla, fragmento de código JSON analizado y una tabla que define cada campo analizado. Navega por los detalles usando la navegación del lado derecho o desplazándote hacia abajo en la página.
Ejemplos de solicitud
En los ejemplos de código a continuación, hacemos una solicitud para recuperar un resultado de amazon.comque incluye 2 páginas de resultados de búsqueda, empezando desde la página #2 para el término de búsqueda nirvana tshirt. Además, la búsqueda se limitará al ID de categoría: 16391693031 y los precios se muestran en USD moneda.
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
# Estructura la carga útil.
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"}
],
}
# Obtén la respuesta.
response = requests.request(
'POST',
'https://realtime.oxylabs.io/v1/queries',
auth=('USERNAME', 'PASSWORD'),
json=payload,
)
# Imprime la respuesta con formato en stdout.
pprint(response.json())Usamos el método de integración síncrona Realtime en nuestros ejemplos. Si deseas usar Proxy Endpoint o la integración asíncrona Push-Pull consulta la sección de métodos de integración .
Valores de los parámetros de solicitud
Genérico
Opciones básicas de configuración y personalización para extraer resultados de búsqueda de Amazon.
source
Establece el scraper.
amazon_search
query
La palabra clave o frase a buscar.
-
- parámetro obligatorio
Localización
Adapta los resultados a ubicaciones geográficas, dominios e idiomas específicos.
dominio
Localización del dominio para Amazon. La lista completa de dominios disponibles se puede encontrar aquí.
com
locale
Accept-Language valor de header, que establece el idioma de la interfaz de la página de Amazon. Más información.
-
IMPORTANTE: En la mayoría de los tipos de página, Amazon adapta los resultados devueltos según la ubicación de entrega de sus clientes. Por lo tanto, aconsejamos usar el geo_location parámetro para establecer tu ubicación de entrega preferida. Puedes leer más sobre el uso de geo_location con Amazon aquí.
Paginación
Controles para gestionar la paginación y la recuperación de resultados de búsqueda.
start_page
Número de página inicial.
1
pages
Número de páginas a recuperar.
1
Ordenación y filtrado
Controles para la ordenación y el filtrado de las páginas de resultados de búsqueda.
sort_by
Establece el tipo de ordenación de la página de resultados de búsqueda según uno de los valores posibles en Amazon:
"most_recent", "price_low_to_high", "price_high_to_low", "featured", "average_review", "bestsellers".
-
refinements
Una lista de parámetros de refinamiento de búsqueda de Amazon usados para aplicar filtros específicos a los resultados de búsqueda. Estos parámetros corresponden a las opciones de filtrado dinámico de Amazon (por ejemplo, marca, rango de precios, características) y siguen el formato interno de parámetros de Amazon, como p_123:256097 o p_n_feature_twenty-eight_browse-bin:98209020031.
Dado que las opciones de filtrado varían según la categoría y Amazon las genera dinámicamente, el flujo de trabajo recomendado es:
Primero, extrae la página de búsqueda de Amazon objetivo con
parse: truepara descubrir las opciones de refinamiento disponiblesExtrae los parámetros de filtro deseados de la respuesta analizada
Usa esos parámetros en solicitudes posteriores a través del campo
refinementspara aplicar filtros específicos
-
context:
category_id
Busca artículos en un nodo específico de Amazon (categoría de producto).
-
context:
merchant_id
Busca artículos vendidos por un vendedor específico.
-
Datos estructurados
Diccionario de datos de salida
La API devuelve un objeto HTML o JSON que contiene los resultados de búsqueda recuperados de Amazon.
Ejemplo HTML

Estructura JSON
Todos los resultados de búsqueda están contenidos dentro del resultados arreglo JSON. Cada resultado de búsqueda incluye una combinación de paid, organic, sugeridos, amazons_choices,instant_recommendations listings. Además, puede haber variaciones, y se capturan dentro de la clave variations que proporciona detalles sobre diferentes tipos o categorías de productos, como varios modelos, ediciones o versiones.
url
La URL de la página de búsqueda de Amazon.
string
page
El número de página actual.
integer
pages
El número total de páginas.
integer
query
La consulta de búsqueda utilizada.
string
resultados
Un diccionario que contiene los resultados de la búsqueda.
object
results.paid
Una lista de productos patrocinados con sus respectivos detalles.
array
results.organic
Una lista de productos orgánicos con sus respectivos detalles.
array
results.suggested
Una lista de productos sugeridos con sus respectivos detalles.
array
results.amazons_choices
Una lista de elecciones de Amazon con sus respectivos detalles.
array
refinements
Una lista de refinamientos disponibles en esta página de búsqueda.
array
parse_status_code
El código de estado del trabajo de análisis. Puedes ver los códigos de estado del analizador descritos aquí.
integer
total_results_count
El número total de resultados encontrados para la consulta de búsqueda.
integer
created_at
La marca de tiempo cuando se creó el trabajo de scraping.
string
updated_at
La marca de tiempo cuando terminó el trabajo de scraping.
string
job_id
El ID del trabajo asociado con el trabajo de scraping.
string
status_code
El código de estado del trabajo de scraping. Puedes ver los códigos de estado del scraper descritos aquí.
integer
parser_type
El tipo de analizador usado para analizar los datos.
string
En las siguientes secciones, los fragmentos de código JSON analizados están abreviados cuando hay más de un elemento disponible para el tipo de resultado.
Patrocinado
El paid la sección de los resultados de búsqueda se refiere al contenido publicitario en línea que se muestra dentro de los resultados de búsqueda de Amazon.

url
La URL del producto.
string
asin
Número de identificación estándar de Amazon.
string
price
El precio del producto.
float
title
El título del producto.
string
rating
La calificación del producto.
float
rel_pos
La posición relativa del producto en los resultados de búsqueda.
(ya sea pos o rel_pos está presente)
integer
pos
Un indicador único que denota la posición en el listado. (ya sea pos o rel_pos está presente)
integer
moneda
La moneda en la que se expresa el precio.
string
url_image
La URL de la imagen del producto.
string
best_seller
Indica si el producto es un más vendido.
booleano
price_upper
El límite superior del precio, si aplica.
float
is_sponsored
Indica si el producto está patrocinado.
booleano
fabricante
El nombre del fabricante del producto.
string
pricing_count
El número de ofertas del producto.
integer
reviews_count
El número de reseñas del producto.
integer
coupon_discount
La cantidad descontada.
integer (opcional)
coupon_discount_type
El tipo de descuento: nominal o porcentaje.
string (opcional)
is_amazons_choice
Indica si el producto está marcado como "Amazon's choice".
booleano
no_price_reason
Indicador de por qué el precio no está presente, si es igual a 0.0
string (opcional)
sales_volume
El volumen de ventas o número de unidades vendidas de un producto en particular.
string (opcional)
is_prime
Indica si el producto es elegible para Amazon Prime.
booleano
shipping_information
Información sobre los detalles de envío del producto
string
Orgánico
El organic la sección de los resultados de búsqueda se refiere al contenido no patrocinado que aparece de forma natural según el algoritmo de búsqueda de Amazon.

pos
Un indicador único que denota la posición en el listado.
integer
url
La URL del producto.
string
asin
Número de identificación estándar de Amazon.
string
price
El precio del producto.
float
title
El título del producto.
string
rating
La calificación del producto.
float
moneda
La moneda en la que se expresa el precio.
string
is_prime
Indica si el producto es elegible para Amazon Prime.
booleano
url_image
La URL de la imagen del producto.
string
best_seller
Indica si el producto es un más vendido.
booleano
price_upper
El límite superior del precio, si aplica.
float
is_sponsored
Indica si el producto está patrocinado.
booleano
fabricante
El nombre del fabricante del producto.
string
sales_volume
El volumen de ventas o número de unidades vendidas de un producto en particular.
string (opcional)
pricing_count
El número de precios del producto.
integer
reviews_count
El número de reseñas del producto.
integer
coupon_discount
La cantidad descontada.
integer (opcional)
coupon_discount_type
El tipo de descuento: nominal o porcentaje.
string (opcional)
is_amazons_choice
Indica si el producto es la elección de Amazon.
booleano
price_strikethrough
Precio original antes de cualquier descuento.
float
shipping_information
Fechas de entrega y detalles del costo de envío.
string
no_price_reason
Indicador de por qué el precio no está presente, si es igual a 0.0
string (opcional)
variations
Lista de diferentes versiones o modelos de un producto
Arreglo
Sugeridos
El sugeridos la sección de los resultados de búsqueda normalmente contiene listados de productos recomendados por la plataforma según la consulta de búsqueda, el historial de navegación o el comportamiento de compra del usuario.

url
La URL del producto.
string
asin
Número de identificación estándar de Amazon.
string
price
El precio del producto.
float
title
El título del producto.
string
rating
La calificación del producto.
float
moneda
La moneda en la que se expresa el precio.
string
url_image
La URL de la imagen del producto.
string
best_seller
Indica si el producto es un más vendido.
booleano
price_upper
El límite superior del precio, si aplica.
float
is_sponsored
Indica si el producto está patrocinado.
booleano
fabricante
El nombre del fabricante del producto.
string
pricing_count
El número de precios del producto.
integer
reviews_count
El número de reseñas del producto.
integer
coupon_discount
La cantidad descontada.
integer (opcional)
coupon_discount_type
El tipo de descuento: nominal o porcentaje.
string (opcional)
is_amazons_choice
Indica si el producto es la elección de Amazon.
booleano
pos
Un indicador único que denota la posición en el listado.
integer
is_prime
Indica si el producto es elegible para Amazon Prime.
booleano
shipping_information
Información sobre los detalles de envío del producto.
string
sales_volume
El volumen de ventas o número de unidades vendidas de un producto en particular.
string (opcional)
no_price_reason
Indicador de por qué el precio no está presente, si es igual a 0.0
string (opcional)
suggested_query
La consulta sugerida proporcionada por Amazon como parte de los resultados de búsqueda.
string
Elecciones de Amazon
El amazons_choices la sección presenta productos con la insignia 'Amazon's Choice' y son recomendados por la plataforma por su calidad y valor percibidos.

url
La URL del producto.
string
asin
Número de identificación estándar de Amazon.
string
price
El precio del producto.
float
title
El título del producto.
string
rating
La calificación del producto.
float
moneda
La moneda en la que se expresa el precio.
string
url_image
La URL de la imagen del producto.
string
best_seller
Indica si el producto es un más vendido.
booleano
price_upper
El límite superior del precio, si aplica.
float
is_sponsored
Indica si el producto está patrocinado.
booleano
fabricante
El nombre del fabricante del producto.
string
pricing_count
El número de precios del producto.
integer
reviews_count
El número de reseñas del producto.
integer
coupon_discount
La cantidad descontada.
integer (opcional)
coupon_discount_type
El tipo de descuento: nominal o porcentaje.
string (opcional)
is_amazons_choice
Indica si el producto es la elección de Amazon.
booleano
pos
Un indicador único que denota la posición en el listado.
integer
is_prime
Indica si el producto es elegible para Amazon Prime.
booleano
shipping_information
Información sobre los detalles de envío del producto.
string
sales_volume
El volumen de ventas o número de unidades vendidas de un producto en particular.
string (opcional)
no_price_reason
Indicador de por qué el precio no está presente, si es igual a 0.0
string (opcional)
variations
Lista de diferentes versiones o modelos de un producto
Arreglo
Variaciones
El variations la sección enumera diferentes versiones o modelos de un producto, proporcionando una visión detallada de las opciones disponibles en la categoría especificada.

asin
Número de identificación estándar de Amazon
string
title
Título de la variación
string
price
Precio de la variación
float
price_strikethrough
El precio original antes de cualquier descuento o promoción
float
not_available
Indica si la variación no está disponible actualmente
booleano
Última actualización
¿Te fue útil?

