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"}
        ]
    }'

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.

Parámetro
Descripción
Valor predeterminado

source

Establece el scraper.

amazon_search

query

La palabra clave o frase 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. Explora el diccionario de datos.

false

callback_url

URL de tu 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 e idiomas específicos.

Parámetro
Descripción
Valor predeterminado

geo_location

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

-

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.

-

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 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 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:

  1. Primero, extrae la página de búsqueda de Amazon objetivo 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 campo refinements para 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

amazon_search salida estructurada

La muestra de salida está recortada.

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.

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

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.

Clave
Descripción
Tipo

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.

Nombre
Descripción
Tipo

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.

Clave
Descripción
Tipo

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.

Clave
Descripción
Tipo

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.

Clave
Descripción
Tipo

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?