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

Producto

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.

Ejemplos de solicitudes

En los ejemplos siguientes, hacemos una solicitud para recuperar la página de producto para ASIN B08Y72CH1F en amazon.nl mercado. En caso de que el ASIN proporcionado sea un ASIN padre, pedimos a Amazon que devuelva la página de un 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",
        "context": [
        "key": "currency",
            {
                "key": "autoselect_variant",
                "value": true
            }
        ]
    }'

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

Valores de parámetros de 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.

-

render

Habilita la renderización de JavaScript cuando se establece en html. Más información.

-

parse

Devuelve datos analizados cuando se establece en true. Explorar 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 específicas, dominios, idiomas.

Parámetro
Descripción
Valor Predeterminado

geo_location

El Entregar a ubicación. Consulta nuestra guía sobre el uso de este parámetro aquí.

-

domain

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

com

locale

Valor del encabezado Accept-Language, que establece el idioma de la interfaz de la página de Amazon. IMPORTANTE: Más información.

-

circle-exclamation

Configuraciones avanzadas adicionales y controles para requisitos especializados.

context

Parámetro
Descripción
Valor Predeterminado

currency: autoselect_variant

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

false

currency: currency

Depende del marketplace. Consulta los valores predeterminados aquíarrow-up-right.

Ejemplo de código aquíarrow-up-right.

"parse": true,

Datos estructurados

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

chevron-rightamazon_product "results": [hashtag

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.

circle-info

En las secciones siguientes, los fragmentos de código JSON analizados 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 dato y si el elemento está siempre presente en el diseño u opcional según el producto que elija extraer. La tabla también incluye algunos metadatos.

Clave
Descripción
Tipo
Diseño

url

La URL del producto de Amazon.

string

page

integer

integer

page_type

Identifica el tipo de página de Amazon.

string

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

page

string

Número estándar de identificación de Amazon extraído de la URL.

Extrae el Número de Identificación Estándar de Amazon (ASIN) de la URL.

string

title

pricing

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

category

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

price

float

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

El precio del envío.

El precio del envío.

float

opcional

price_buybox

El precio del producto tal como aparece 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.

boolean

is_addon_item

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

boolean

opcional

currency

delivery

string

discount_end

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

string

opcional

stock

Indica el nivel de inventario del producto.

string

reviews_count

El recuento de reseñas del producto.

integer

reviews

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

string

opcional

pricing_str

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

string

opcional

featured_merchant

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

object

opcional

sales_rank

Una lista de información sobre la posición de clasificación de ventas de un producto de Amazon dentro de su categoría respectiva basada en 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 URL que indican las imágenes del producto.

array

product_overview

Una lista de atributos clave y sus descripciones para el producto, que proporciona detalles esenciales sobre las características del producto.

array

opcional

store_url

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

string

opcional

has_videos

Indica si el producto tiene videos.

boolean

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 física o el tipo 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 la cantidad 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 los precios 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 único 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 Amazon's Choice.

boolean

opcional

coupon_discount_percentage

Indica el porcentaje de reducción 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 se terminó el trabajo de scraping.

timestamp

job_id

El ID del trabajo asociado con el trabajo 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 análisis. 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 ladder es un objeto con un nombre y URL, que representa la ruta desde la categoría más amplia hasta la subcategoría más específica.

Clave (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

Ads

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, número de reseñas, elegibilidad Prime y precio.

Clave (ads)
Descripción
Tipo

type

El tipo del anuncio de Amazon.

string

location

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

string

title

pricing

string

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

page

string

images

La URL de la(s) imagen(es) 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 del producto.

integer

is_prime_eligible

Indica si el producto es elegible para Amazon Prime.

boolean

price

float

float

price_upper

El límite superior del precio si aplica.

float

Distribución de Estrellas de Calificación

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

Clave (rating_stars_distribution)
Descripción
Tipo

rating

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

integer

percentage

Indica el porcentaje correspondiente a 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.

Clave (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 que ha enviado la reseña.

string

rating

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

integer

content

El texto completo del contenido de la reseña.

string

timestamp

La fecha y ubicación de la reseña, formateadas como las proporciona Amazon.

string

profile_id

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

string

is_verified

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

boolean

review_from

Proporciona contexto adicional sobre el origen de la reseña (p. ej., reseñas destacadas o por ubicación).

string

helpful_count (opcional)

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

integer

product_attributes (opcional)

Identifica las características del producto.

string

Variations

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

Clave (variations)
Descripción
Tipo
Diseño

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

El Número de Identificación Estándar de Amazon de la variante del producto.

array

selected

Identifica la variante de producto seleccionada.

boolean

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 recuento de unidades estándar del producto variante.

string

opcional

tooltip_image

La URL de la imagen de la variante.

string

opcional

Warranty and Support

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.

Clave (warranty_and_support)
Descripción
Tipo

description

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

string

links

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

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

Clave(featured_merchant)
Descripción
Tipo

name

El nombre del vendedor principal.

string

La identificación del vendedor en Amazon.

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 gestionado por la propia red logística de Amazon

boolean

shipped_from (opcional)

Indica el lugar de envío.

string

Sales Rank

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

Clave(sales_rank)
Descripción
Tipo

rango

Indica la posición en el 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 la categoría 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 de llegada estimadas.

Clave (delivery)
Descripción
Tipo

type

Indica el tipo de entrega.

string

fecha

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

object

date.from

El lugar de envío.

string

date.by

La fecha de entrega estimada.

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, incluido el precio del producto, la disponibilidad de stock, las opciones de entrega y las fechas de llegada estimadas.

Clave (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 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 de entrega estimada.

string

opcional

delivery_details.from

condition

string

opcional

delivery_details.type

El tipo de entrega

string

opcional

La condición del producto.

seller_id

string

opcional

price

float

float

Oferta relámpago

Este campo proporciona detalles sobre una oferta relámpago en Amazon, que ofrece 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 pocas horas y en cantidades limitadas. Los clientes deben actuar rápidamente ya que las ofertas expiran cuando se agota el tiempo asignado o el inventario. Los detalles incluyen el porcentaje reclamado, el precio con descuento y el tiempo restante antes de que la oferta expire.

Clave (lightning_deal)
Descripción
Tipo

percent_claimed

La cantidad descontada en comparación con el precio por defecto.

string

price_text

El precio del producto con descuento.

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.

Clave (product_overview)
Descripción
Tipo

product_overview

Una lista de atributos clave y sus descripciones para el producto.

Array

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?