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

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

Explorar la 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. Navegue por los detalles usando la navegación del lado derecho o desplazándose hacia abajo en la página.

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.

Parámetro
Descripción
Valor predeterminado

source

Establece el scraper.

amazon_search

query

La palabra clave o frase que se va a buscar.

-

render

Habilita el renderizado de JavaScript cuando se establece en html. Más información.

-

parse

Devuelve datos analizados cuando se establece en true. Explore la salida diccionario de datos.

false

callback_url

URL de su endpoint de callback. Más información.

-

user_agent_type

Tipo de dispositivo y navegador. La lista completa se puede encontrar aquí.

desktop

context: currency

Establece la moneda. Consulte los valores disponibles aquí.

-

- parámetro obligatorio

Localización

Adapte los resultados a ubicaciones geográficas, dominios e idiomas específicos.

Parámetro
Descripción
Valor predeterminado

geo_location

El Entregar a ubicación. Consulte nuestra guía para usar este parámetro aquí.

-

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.

-

Paginación

Controles para gestionar la paginación y la recuperación de resultados de búsqueda.

Parámetro
Descripción
Valor predeterminado

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.

Parámetro
Descripción
Valor predeterminado

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:

  1. Primero, extrae la página de búsqueda objetivo de Amazon con parse: true para descubrir las opciones de refinamiento disponibles

  2. Extrae los parámetros de filtro deseados de la respuesta analizada

  3. Usa esos parámetros en solicitudes posteriores a través del refinements campo 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

amazon_search salida estructurada

La muestra de salida está abreviada.

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.

Clave
Descripción
Tipo

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

En las siguientes secciones, los fragmentos de código JSON analizados se acortan cuando hay más de un elemento disponible para el tipo de resultado.

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.

Clave
Descripción
Tipo

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.

Nombre
Descripción
Tipo

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.

Clave
Descripción
Tipo

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.

Clave
Descripción
Tipo

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.

Clave
Descripción
Tipo

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?