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

Product

Extrae datos de productos de Amazon sin esfuerzo con Web Scraper API. Accede a títulos, precios, reseñas y detalles usando parámetros personalizados y ejemplos.

El amazon_product la fuente de datos está diseñada para recuperar páginas de productos de Amazon.

Solicitar ejemplos

En las muestras a continuación, hacemos una solicitud para recuperar la página de producto para el ASIN B08Y72CH1F en amazon.nl marketplace. En caso de que el ASIN proporcionado sea un ASIN padre, pedimos a Amazon que devuelva una página de producto de una variación seleccionada automáticamente. La API devolverá resultados parseados.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "amazon_product",
        "domain": "nl",
        "query": "B08Y72CH1F",
        "parse": true,
        "context": [
            {
                "key": "autoselect_variant",
                "value": true
            }
        ]
    }'

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 páginas de productos de Amazon.

Parámetro
Descripción
Valor predeterminado

source

Establece el scraper.

amazon_product

query

Código ASIN de 10 símbolos.

-

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

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

-

Otros

Configuraciones avanzadas adicionales y controles para requisitos especializados.

Parámetro
Descripción
Valor predeterminado

context: autoselect_variant

Para obtener datos precisos de precios/buybox, establece este parámetro en true (lo que nos indica agregar los parámetros de URL th=1&psc=1 al final de la URL del producto). Para obtener una representación precisa de la página del ASIN padre, omite este parámetro o establécelo en false.

false

context: moneda

Establece la moneda. Consulta los valores disponibles aquí.

Depende del marketplace. Consulta los valores predeterminados aquí.

Ejemplo de código

Datos estructurados

Web Scraper API es capaz de extraer un objeto HTML o JSON que contiene resultados de productos de Amazon, ofreciendo datos estructurados sobre varios elementos de la página de resultados.

amazon_product salida estructurada

Diccionario de datos de salida

Navegue por los detalles usando la navegación del lado derecho o desplazándose hacia abajo en la página.

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.

Ejemplo HTML

Estructura JSON

La tabla a continuación presenta una lista detallada de cada elemento de la página de producto de Amazon que parseamos, incluyendo su descripción, tipo de datos y si el elemento siempre está presente en el diseño u opcional según el producto que elijas extraer. La tabla también incluye algunos metadatos.

Clave
Descripción
Tipo
Diseño

url

La URL del producto de Amazon.

string

page

El número de página actual.

integer

page_type

Identifica el tipo de la página de Amazon.

string

asin

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

string

asin_in_url

Extrae el Amazon Standard Identification Number de la URL.

string

title

El título del producto.

string

manufacturer

El nombre del fabricante del producto.

string

product_name

El nombre del producto.

string

description

La descripción del producto, parseada de la sección 'Product description'.

string

bullet_points

Los elementos de viñeta parseados de la sección 'About this product'.

string

opcional

categoría

Una lista que contiene más detalles sobre la categoría del producto de Amazon.

array

opcional

variation

Una lista que contiene más detalles sobre las variaciones del producto de Amazon.

array

opcional

rating

La calificación del producto.

integer

precio

El precio del producto.

float

price_upper

El límite superior del precio.

float

opcional

price_sns

Identifica si el producto forma parte del programa 'Subscribe & Save'.

float

price_initial

El precio original, sin descuento, de un producto.

float

price_shipping

El precio del envío.

float

opcional

price_buybox

El precio del producto visible en la buybox.

float

deal_type

Identifica la categoría de la oferta promocional.

string

opcional

coupon

Indica cualquier descuento digital disponible.

string

opcional

is_prime_eligible

Indica si el producto es elegible para Amazon Prime.

booleano

is_addon_item

Indica si un producto está disponible para compra solo cuando se incluye en pedidos que alcanzan un umbral de valor mínimo.

booleano

opcional

moneda

La moneda en la que se denomina el precio.

string

discount_end

Indica la fecha final en la que un descuento promocional para un producto de Amazon es válido.

string

opcional

stock

Indica el nivel de inventario del producto.

string

reviews_count

El recuento de reseñas para el producto.

integer

reseñas

Una lista de reseñas con sus respectivos detalles.

array

answered_questions_count

El número total de preguntas de clientes sobre un producto de Amazon que han sido respondidas.

integer

opcional

pricing_count

El recuento de ofertas para el producto.

integer

opcional

pricing_url

La URL para recuperar listados de ofertas del producto de Amazon.

string

opcional

pricing_str

Una representación en string de los detalles de precios de un producto de Amazon. Este atributo incluye información sobre el precio actual, descuentos, promociones y ofertas especiales

string

opcional

featured_merchant

Una lista de detalles sobre el vendedor o proveedor principal destacado para un producto de Amazon.

object

opcional

sales_rank

Una lista de información sobre la posición de ranking de un producto de Amazon dentro de su categoría respectiva según su rendimiento de ventas.

array

opcional

sns_discounts

Indica cualquier descuento disponible como parte del programa 'Subscribe & Save'.

array

developer_info

Información relacionada con el desarrollador o fabricante de un producto de Amazon.

object

opcional

images

Una lista de URLs que indican las imágenes del producto.

array

product_overview

Una lista de atributos clave y sus descripciones del producto, proporcionando detalles esenciales sobre las características del producto.

array

opcional

store_url

La URL de la página web de la tienda del vendedor.

string

opcional

has_videos

Indica si el producto tiene videos.

booleano

delivery

Una lista de información sobre las opciones de entrega.

object

opcional

brand

La marca del producto.

string

opcional

item_form

Especifica la forma o tipo físico del producto, detallando cómo se empaqueta o entrega para su uso.

string

opcional

sales_volume

La cantidad de unidades vendidas dentro de un período de tiempo específico.

string

opcional

other_sellers

Detalles de otros vendedores que listan el producto, incluyendo el número de vendedores, el precio inicial entre ellos e información básica de envío.

string

opcional

rating_stars_distribution

Una lista de detalles sobre las calificaciones del producto.

array

opcional

buybox

Una lista de detalles sobre el precio del producto.

array

opcional

lightning_deal

Indica si hay una oferta promocional por tiempo limitado disponible para el producto.

object

opcional

product_details

Una lista de información sobre los detalles del producto.

object

opcional

product_dimensions

Las dimensiones del producto.

string

opcional

max_quantity

El número máximo de unidades de un producto de Amazon que un cliente puede comprar en un solo pedido.

integer

opcional

warranty_and_support

Una lista de detalles sobre la garantía del producto.

object

opcional

discount.percentage

El porcentaje de reducción aplicado al precio original de un producto de Amazon.

integer

opcional

amazon_choice

Indica si el producto tiene la insignia de Amazon's Choice.

booleano

opcional

coupon_discount_percentage

Indica el porcentaje de descuento aplicable con un cupón.

integer

opcional

parent_asin

El identificador principal para la familia de productos de Amazon a la que se atribuye un producto.

string

opcional

created_at

La marca de tiempo cuando se creó el trabajo de scraping.

timestamp

updated_at

La marca de tiempo cuando el trabajo de scraping fue finalizado.

timestamp

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

parse_status_code

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

integer

Category

Este campo muestra la estructura jerárquica de categorías de producto para un producto de Amazon. Cada categoría en la escalera es un objeto con un nombre y una URL, que representa la ruta desde la categoría más amplia hasta la subcategoría más específica.

Key (category)
Descripción
Tipo

ladder

Una lista que contiene las migas de pan del producto de Amazon.

array

ladder.name

El nombre de la miga de pan/categoría del producto de Amazon.

string

ladder.url

La URL de la miga de pan/categoría.

string

Anuncios

Este campo contiene información sobre los anuncios mostrados en una página de producto de Amazon. Cada anuncio se representa como un objeto con detalles como tipo, ubicación, título, ASIN, imágenes, posición, calificación, conteo de reseñas, elegibilidad Prime y precio.

Key (ads)
Descripción
Tipo

type

El tipo del anuncio de Amazon.

string

ubicación

El nombre de la ubicación del anuncio de Amazon.

string

title

El título del producto.

string

asin

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

string

images

La URL de la imagen/imágenes del producto.

string

pos

Un indicador único que denota la posición de un anuncio con respecto a todos los resultados de anuncios disponibles.

integer

rating

La calificación del producto.

integer

reviews_count

El recuento de reseñas para el producto.

integer

is_prime_eligible

Indica si el producto es elegible para Amazon Prime.

booleano

precio

El precio del producto.

float

price_upper

El límite superior del precio si corresponde.

float

Distribución de estrellas de calificación

Este campo contiene la distribución de calificaciones por estrellas de un producto. Cada objeto representa una calificación por estrellas y el porcentaje del total de reseñas que dieron esa calificación.

Key (rating_stars_distribution)
Descripción
Tipo

rating

Indica el número de calificación (escala de 5 a 1).

integer

percentage

Indica el porcentaje para la calificación específica.

string

Reseñas

Contiene reseñas de clientes para el producto, con cada reseña representada como un objeto que contiene detalles relevantes.

Key (reviews)
Descripción
Tipo

id

Una identificación alfanumérica para la Reseña de Amazon.

string

title

La calificación y el título de la reseña.

string

author

El usuario por quien se envió la reseña.

string

rating

La calificación por estrellas asignada al enviar la reseña, típicamente entre 1 y 5.

integer

contenido

El texto completo del contenido de la reseña.

string

timestamp

La fecha y ubicación de la reseña, con el formato provisto por Amazon.

string

profile_id

Identificador único para el perfil del autor de la reseña, usado para enlazar a su perfil de Amazon.

string

is_verified

Indica si la reseña es de una compra verificada.

booleano

review_from

Proporciona contexto adicional sobre el origen de la reseña (por ejemplo, reseñas específicas por ubicación o principales reseñas).

string

helpful_count (opcional)

Número de votos de utilidad recibidos para la reseña.

integer

product_attributes (opcional)

Identifica las características del producto.

string

Variaciones

Este campo contiene información sobre diferentes variaciones de un producto, como color, tamaño, estilo, etc. Cada variación se representa como un objeto con detalles que incluyen ASIN, estado de selección, dimensiones (atributos como color, tamaño, estilo) y una URL de imagen de tooltip.

Key (variations)
Descripción
Tipo
Diseño

asin

El Amazon Standard Identification Number de la variante del producto.

array

selected

Identifica la variante de producto seleccionada.

booleano

dimensions

Las dimensiones del producto variante.

object

opcional

dimensions.size

El tamaño del producto variante.

string

opcional

dimensions.color

El color del producto variante.

string

opcional

dimensions.style

El estilo del producto variante.

string

opcional

dimensions.unit count

El conteo estándar de unidades del producto variante.

string

opcional

tooltip_image

La URL de la imagen de la variante.

string

opcional

Garantía y soporte

Este campo contiene información sobre las opciones de garantía y soporte para el producto. Incluye una descripción de la garantía del producto y enlaces para obtener información de garantía.

Key (warranty_and_support)
Descripción
Tipo

description

La descripción de la garantía disponible para el producto.

string

enlaces

Una lista que contiene más información sobre la garantía del producto.

array

links.title

El título de la garantía.

string

links.url

Una URL que contiene más información sobre la garantía del producto.

string

Vendedor destacado

Este campo proporciona información sobre el vendedor destacado que vende el producto. Incluye detalles como el nombre del vendedor, el ID del vendedor, el enlace a la página del vendedor, si el producto es cumplido por Amazon y el origen del envío.

Key(featured_merchant)
Descripción
Tipo

name

El nombre del vendedor principal.

string

seller_id

El ID del vendedor.

string

link

La URL de la página del vendedor en Amazon.

string

is_amazon_fulfilled

Indica si un producto es cumplido por la red logística de Amazon

booleano

shipped_from (opcional)

Indica la ubicación de envío.

string

Rango de ventas

Este campo proporciona información sobre el rango de ventas del producto dentro de categorías específicas en Amazon. Cada objeto representa una entrada de rango de ventas, incluyendo el propio rango y la escalera de categorías, mostrando la jerarquía de categorías que conduce a la categoría clasificada.

Key(sales_rank)
Descripción
Tipo

rank

Indica la posición de ranking.

integer

ladder

Una lista de información más detallada sobre la categoría en la que se ha clasificado el producto.

array

ladder.url

La URL a la página relevante de Bestsellers.

string

ladder.name

Indica la categoría en la que se ha clasificado el producto.

string

Entrega

Este campo proporciona información sobre las opciones de entrega para el producto, como el método de entrega más rápido y las fechas estimadas de llegada.

Key (delivery)
Descripción
Tipo

type

Indica el tipo de la entrega.

string

fecha

Una lista de información sobre la fecha de entrega.

object

date.from

La ubicación de envío.

string

date.by

La fecha estimada de entrega.

string

Buy Box

La sección "buy box" en una página de producto de Amazon donde los clientes pueden comprar artículos directamente. Este campo proporciona información esencial para los compradores, incluyendo el precio del producto, disponibilidad de stock, opciones de entrega y fechas estimadas de llegada.

Key (buybox)
Descripción
Tipo
Diseño

name

El nombre de la opción de precio.

string

opcional

stock

El nivel de inventario del producto.

string

opcional

delivery_type

Indica el tipo de la entrega.

string

opcional

delivery_details

Una lista de detalles sobre la entrega del producto.

array

opcional

fecha

Una lista de detalles sobre la fecha de entrega.

object

opcional

delivery_details.by

La fecha estimada de entrega.

string

opcional

delivery_details.from

La ubicación de envío del producto.

string

opcional

delivery_details.type

El tipo de la entrega

string

opcional

condition

La condición del producto.

string

opcional

precio

El precio del producto.

float

Oferta relámpago

Este campo proporciona detalles sobre una oferta relámpago en Amazon, ofreciendo un precio con descuento por tiempo limitado. Las ofertas relámpago son promociones limitadas en el tiempo con descuentos significativos en productos específicos, disponibles por unas pocas horas en cantidades limitadas. Los clientes deben actuar rápidamente ya que las ofertas expiran una vez que se agota el tiempo o el inventario asignado. Los detalles incluyen el porcentaje reclamado, el precio con descuento y el tiempo restante antes de que la oferta expire.

Key(lightning_deal)
Descripción
Tipo

percent_claimed

El monto descontado en comparación con el precio predeterminado.

string

price_text

El precio con descuento del producto.

string

expires

Indica la fecha de finalización de la oferta relámpago.

string

Resumen del producto

Esta sección proporciona un resumen estructurado de varios atributos clave relacionados con un producto.

Key(product_overview)
Descripción
Tipo

product_overview

Una lista de atributos clave y sus descripciones del producto.

Arreglo

title

El título del atributo del producto.

string

description

La descripción detallada del atributo del producto.

string

Última actualización

¿Te fue útil?