Documentation has been updated: see help center and changelog in one place.

Search

Raspa 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, descargue este ejemplo de salida 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. Navegue por los detalles usando la navegación del lado derecho o desplazándose hacia abajo en la página.

Solicitar ejemplos

En los ejemplos de código a continuación, hacemos una solicitud para recuperar un resultado de amazon.com, que incluye 2 páginas de resultados de búsqueda, comenzando 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"}
        ]
    }'

Usamos el método de integración síncrono Realtime en nuestros ejemplos. Si desea usar Proxy Endpoint o asíncrono Push-Pull para la integración, consulte los métodos de integración sección.

Valores de parámetros de la solicitud

Genérico

Configuración básica y opciones de 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 a buscar.

-

user_agent_type

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

-

parse

Devuelve datos parseados 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: moneda

Establece la moneda. Consulta los valores disponibles aquí.

-

- parámetro obligatorio

Localización

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

Parámetro
Descripción
Valor predeterminado

geo_location

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

-

dominio

Localización de dominio para Bestbuy. La lista completa de dominios disponibles se puede encontrar aquí.

com

localidad

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 ordenar y filtrar las páginas de resultados de búsqueda.

Parámetro
Descripción
Valor predeterminado

sort_by

Establece el tipo de ordenación de la página de resultados de búsqueda según uno de los posibles valores 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 utilizados 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 de parámetro interno 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 se generan dinámicamente en Amazon, el flujo de trabajo recomendado es:

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

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

  3. Use esos parámetros en solicitudes posteriores a través del refinements campo para aplicar filtros específicos

-

context: category_id

Buscar artículos en un nodo particular de Amazon (categoría de producto).

-

context: merchant_id

Buscar artículos vendidos por un vendedor en particular.

-

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 dentro del results arreglo JSON. Cada resultado de búsqueda incluye una combinación de paid, organic, sugeridos, amazons_choices,instant_recommendations listados. Además, pueden estar presentes variaciones, y se capturan dentro de la variations clave, proporcionando detalles sobre diferentes tipos o categorías de productos, como varios modelos, ediciones o versiones.

Clave
Descripción
Tipo

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

results

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 "Amazon's choices" 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 parseo. Puede ver los códigos de estado del parser 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 el trabajo de scraping fue finalizado.

string

job_id

El ID del trabajo asociado con la tarea de scraping.

string

status_code

El código de estado del trabajo de scraping. Puede ver los códigos de estado del scraper descritos aquí.

integer

parser_type

El tipo de parser utilizado para analizar los datos.

string

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

El paid La sección de los resultados de búsqueda se refiere al contenido de anuncios en línea que se muestra dentro de los resultados de búsqueda de Amazon.

Clave
Descripción
Tipo

url

La URL del producto.

string

asin

Número de identificación estándar de Amazon.

string

precio

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 la lista. (ya sea pos o rel_pos está presente)

integer

moneda

La moneda en la que se denomina 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 corresponde.

float

is_sponsored

Indica si el producto está patrocinado.

booleano

manufacturer

El nombre del fabricante del producto.

string

pricing_count

El recuento de ofertas para el producto.

integer

reviews_count

El recuento de reseñas para el producto.

integer

coupon_discount

El monto descontado.

integer (opcional)

coupon_discount_type

El tipo de descuento: nominal o percentage.

string (opcional)

is_amazons_choice

Indica si el producto está marcado como "Amazon's choice".

booleano

no_price_reason

Indicador del porqué 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

Organic

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.

Nombre
Descripción
Tipo

pos

Un indicador único que denota la posición en la lista.

integer

url

La URL del producto.

string

asin

Número de identificación estándar de Amazon.

string

precio

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 denomina 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 corresponde.

float

is_sponsored

Indica si el producto está patrocinado.

booleano

manufacturer

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 recuento de precios para el producto.

integer

reviews_count

El recuento de reseñas para el producto.

integer

coupon_discount

El monto descontado.

integer (opcional)

coupon_discount_type

El tipo de descuento: nominal o percentage.

string (opcional)

is_amazons_choice

Indica si el producto es la opció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 del porqué el precio no está presente, si es igual a 0.0

string (opcional)

variations

Lista de diferentes versiones o modelos de un producto

Arreglo

Sugerido

El sugeridos La sección "sugeridos" en los resultados de búsqueda típicamente contiene listados de productos recomendados por la plataforma según la consulta de búsqueda del usuario, historial de navegación o comportamiento de compra.

Clave
Descripción
Tipo

url

La URL del producto.

string

asin

Número de identificación estándar de Amazon.

string

precio

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 denomina 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 corresponde.

float

is_sponsored

Indica si el producto está patrocinado.

booleano

manufacturer

El nombre del fabricante del producto.

string

pricing_count

El recuento de precios para el producto.

integer

reviews_count

El recuento de reseñas para el producto.

integer

coupon_discount

El monto descontado.

integer (opcional)

coupon_discount_type

El tipo de descuento: nominal o percentage.

string (opcional)

is_amazons_choice

Indica si el producto es la opción de Amazon.

booleano

pos

Un indicador único que denota la posición en la lista.

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 del porqué 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

Amazon's Choices

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.

Clave
Descripción
Tipo

url

La URL del producto.

string

asin

Número de identificación estándar de Amazon.

string

precio

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 denomina 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 corresponde.

float

is_sponsored

Indica si el producto está patrocinado.

booleano

manufacturer

El nombre del fabricante del producto.

string

pricing_count

El recuento de precios para el producto.

integer

reviews_count

El recuento de reseñas para el producto.

integer

coupon_discount

El monto descontado.

integer (opcional)

coupon_discount_type

El tipo de descuento: nominal o percentage.

string (opcional)

is_amazons_choice

Indica si el producto es la opción de Amazon.

booleano

pos

Un indicador único que denota la posición en la lista.

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 del porqué 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.

Clave
Descripción
Tipo

asin

Número de Identificación Estándar de Amazon

string

title

Título de la variación

string

precio

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 está actualmente no disponible

booleano

Última actualización

¿Te fue útil?