Búsqueda
Extrae 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 fuente está diseñada para recuperar páginas de resultados de búsqueda de Amazon. Para ver el ejemplo de respuesta con los datos recuperados, descargue este salida de ejemplo archivo en formato HTML o consulte la salida de datos estructurados aquí.
Ejemplos de solicitud
En los ejemplos de código siguientes, hacemos una solicitud para obtener un resultado de amazon.com, que 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
# Estructurar 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"}
],
}
# Obtener respuesta.
response = requests.request(
'POST',
'https://realtime.oxylabs.io/v1/queries',
auth=('USERNAME', 'PASSWORD'),
json=payload,
)
# Imprimir la respuesta formateada en stdout.
pprint(response.json())Usamos el método de integración síncrona Realtime método de integración en nuestros ejemplos. Si desea usar Proxy Endpoint o asincrónica Push-Pull integración, consulte la métodos de integración sección.
Valores de parámetros de solicitud
General
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 que se va a buscar.
-
parse
Devuelve datos analizados cuando se establece en true. Explore la salida diccionario de datos.
false
- parámetro obligatorio
Localización
Adapte los resultados a ubicaciones geográficas, dominios e idiomas específicos.
domain
Localización de dominio para Amazon. La lista completa de dominios disponibles se puede encontrar aquí.
com
locale
Accept-Language valor del encabezado, 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 ello, recomendamos usar el geo_location parámetro para establecer su ubicación de entrega preferida. Puede leer más sobre el uso de este geo_location parámetro 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 páginas de resultados de búsqueda.
context:
sort_by
Define 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".
-
context:
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 (p. ej., 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 objetivo de Amazon 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
refinementscampo para aplicar filtros específicos
-
context:
min_price / max_price
Filtra los resultados por rango de precios. Ambos valores se expresan en centavos, no en la unidad principal de la moneda: min_price: 5000 con max_price: 10000 devuelve productos entre $50.00 y $100.00. Deben ser enteros positivos. Se puede usar cualquiera de los dos por separado.
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 en el results arreglo JSON. Cada resultado de búsqueda incluye una combinación de paid, organic, suggested, amazons_choices,instant_recommendations listados. Además, puede haber variaciones, y se capturan dentro de la variations clave, proporcionando detalles sobre diferentes tipos o categorías de productos, como distintos modelos, ediciones o versiones.
url
La URL de la página de búsqueda de Amazon.
cadena
page
El número de página actual.
entero
pages
El número total de páginas.
entero
query
La consulta de búsqueda utilizada.
cadena
results
Un diccionario que contiene los resultados de la búsqueda.
objeto
results.paid
Una lista de productos patrocinados con sus detalles respectivos.
arreglo
results.organic
Una lista de productos orgánicos con sus detalles respectivos.
arreglo
results.suggested
Una lista de productos sugeridos con sus detalles respectivos.
arreglo
results.amazons_choices
Una lista de las selecciones de Amazon con sus detalles respectivos.
arreglo
refinements
Una lista de refinamientos disponibles en esta página de búsqueda.
arreglo
parse_status_code
El código de estado del trabajo de análisis. Puedes ver los códigos de estado del analizador descritos aquí.
entero
total_results_count
El número total de resultados encontrados para la consulta de búsqueda.
entero
created_at
La marca de tiempo en que se creó el trabajo de scraping.
cadena
updated_at
La marca de tiempo en que finalizó el trabajo de scraping.
cadena
job_id
El ID del trabajo asociado con el trabajo de scraping.
cadena
status_code
El código de estado del trabajo de scraping. Puedes ver los códigos de estado del scraper descritos aquí.
entero
parser_type
El tipo de analizador usado para analizar los datos.
cadena
Patrocinado
El paid sección de los resultados de búsqueda se refiere al contenido de anuncios insertados que se muestra dentro de los resultados de búsqueda de Amazon.

url
La URL del producto.
cadena
asin
Número de identificación estándar de Amazon.
cadena
price
El precio del producto.
flotante
title
El título del producto.
cadena
rating
La calificación del producto.
flotante
rel_pos
La posición relativa del producto en los resultados de búsqueda.
(cualquiera de los dos pos o rel_pos está presente)
entero
pos
Un identificador único que indica la posición en el listado. (cualquiera de los dos pos o rel_pos está presente)
entero
currency
La moneda en la que está expresado el precio.
cadena
url_image
La URL de la imagen del producto.
cadena
best_seller
Indica si el producto es un más vendido.
booleano
price_upper
El límite superior del precio, si aplica.
flotante
is_sponsored
Indica si el producto es patrocinado.
booleano
manufacturer
El nombre del fabricante del producto.
cadena
pricing_count
La cantidad de ofertas del producto.
entero
reviews_count
La cantidad de reseñas del producto.
entero
coupon_discount
El importe con descuento.
entero (opcional)
coupon_discount_type
El tipo de descuento: nominal o percentage.
cadena (opcional)
is_amazons_choice
Indica si el producto está marcado como "elección de Amazon".
booleano
no_price_reason
Indicador de por qué el precio no está presente, si es igual a 0.0
cadena (opcional)
sales_volume
El volumen de ventas o el número de unidades vendidas de un producto específico.
cadena (opcional)
is_prime
Indica si el producto es apto para Amazon Prime.
booleano
shipping_information
Información sobre los detalles de envío del producto
cadena
Orgánico
El organic 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.
entero
url
La URL del producto.
cadena
asin
Número de identificación estándar de Amazon.
cadena
price
El precio del producto.
flotante
title
El título del producto.
cadena
rating
La calificación del producto.
flotante
currency
La moneda en la que está expresado el precio.
cadena
is_prime
Indica si el producto es apto para Amazon Prime.
booleano
url_image
La URL de la imagen del producto.
cadena
best_seller
Indica si el producto es un más vendido.
booleano
price_upper
El límite superior del precio, si aplica.
flotante
is_sponsored
Indica si el producto es patrocinado.
booleano
manufacturer
El nombre del fabricante del producto.
cadena
sales_volume
El volumen de ventas o el número de unidades vendidas de un producto específico.
cadena (opcional)
pricing_count
La cantidad de precios del producto.
entero
reviews_count
La cantidad de reseñas del producto.
entero
coupon_discount
El importe con descuento.
entero (opcional)
coupon_discount_type
El tipo de descuento: nominal o percentage.
cadena (opcional)
is_amazons_choice
Indica si el producto es la elección de Amazon.
booleano
price_strikethrough
Precio original antes de cualquier descuento.
flotante
shipping_information
Fechas de entrega y detalles del costo de envío.
cadena
no_price_reason
Indicador de por qué el precio no está presente, si es igual a 0.0
cadena (opcional)
variations
Lista de diferentes versiones o modelos de un producto
Arreglo
Sugeridos
El suggested sección de los resultados de búsqueda suele contener listados de productos recomendados por la plataforma según la consulta de búsqueda del usuario, el historial de navegación o el comportamiento de compra.

url
La URL del producto.
cadena
asin
Número de identificación estándar de Amazon.
cadena
price
El precio del producto.
flotante
title
El título del producto.
cadena
rating
La calificación del producto.
flotante
currency
La moneda en la que está expresado el precio.
cadena
url_image
La URL de la imagen del producto.
cadena
best_seller
Indica si el producto es un más vendido.
booleano
price_upper
El límite superior del precio, si aplica.
flotante
is_sponsored
Indica si el producto es patrocinado.
booleano
manufacturer
El nombre del fabricante del producto.
cadena
pricing_count
La cantidad de precios del producto.
entero
reviews_count
La cantidad de reseñas del producto.
entero
coupon_discount
El importe con descuento.
entero (opcional)
coupon_discount_type
El tipo de descuento: nominal o percentage.
cadena (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.
entero
is_prime
Indica si el producto es apto para Amazon Prime.
booleano
shipping_information
Información sobre los detalles de envío del producto.
cadena
sales_volume
El volumen de ventas o el número de unidades vendidas de un producto específico.
cadena (opcional)
no_price_reason
Indicador de por qué el precio no está presente, si es igual a 0.0
cadena (opcional)
suggested_query
La consulta sugerida proporcionada por Amazon como parte de los resultados de búsqueda.
cadena
Las selecciones de Amazon
El amazons_choices La sección muestra productos con la insignia 'Amazon's Choice' y son recomendados por la plataforma por su calidad y valor percibidos.

url
La URL del producto.
cadena
asin
Número de identificación estándar de Amazon.
cadena
price
El precio del producto.
flotante
title
El título del producto.
cadena
rating
La calificación del producto.
flotante
currency
La moneda en la que está expresado el precio.
cadena
url_image
La URL de la imagen del producto.
cadena
best_seller
Indica si el producto es un más vendido.
booleano
price_upper
El límite superior del precio, si aplica.
flotante
is_sponsored
Indica si el producto es patrocinado.
booleano
manufacturer
El nombre del fabricante del producto.
cadena
pricing_count
La cantidad de precios del producto.
entero
reviews_count
La cantidad de reseñas del producto.
entero
coupon_discount
El importe con descuento.
entero (opcional)
coupon_discount_type
El tipo de descuento: nominal o percentage.
cadena (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.
entero
is_prime
Indica si el producto es apto para Amazon Prime.
booleano
shipping_information
Información sobre los detalles de envío del producto.
cadena
sales_volume
El volumen de ventas o el número de unidades vendidas de un producto específico.
cadena (opcional)
no_price_reason
Indicador de por qué el precio no está presente, si es igual a 0.0
cadena (opcional)
variations
Lista de diferentes versiones o modelos de un producto
Arreglo
Variantes
El variations La sección enumera diferentes versiones o modelos de un producto, ofreciendo una vista detallada de las opciones disponibles en la categoría especificada.

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

