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

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 y ejemplos personalizados.

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

Ejemplos de solicitud

En los ejemplos a continuación, hacemos una solicitud para recuperar la página del producto para 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 analizados.

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
            }
        ]
    }'
import requests
from pprint import pprint


# Estructura del payload.
payload = {
    'source': 'amazon_product',
    'domain': 'nl',
    'query': 'B08Y72CH1F',
    'parse': True,
    'context': [
        {'key': 'autoselect_variant', 'value': True}
    ],
}


# Obtener respuesta.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

Usamos integración síncrona Realtime método de integración en nuestros ejemplos. Si deseas usar Proxy Endpoint o una integración asíncrona Push-Pull integración, consulta la métodos de integración sección.

Valores de los parámetros de solicitud

Genérico

Opciones básicas de configuración y personalización para extraer páginas de productos de Amazon.

Parámetro
Descripción
Valor predeterminado

source

Configura el scraper.

amazon_product

consulta

Código ASIN de 10 símbolos.

-

render

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

-

parse

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

false

callback_url

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

Parámetro
Descripción
Valor predeterminado

geo_location

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

-

domain

Localización de dominios 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.

-

Otros

Configuraciones y controles avanzados adicionales para requisitos especializados.

Parámetro
Descripción
Valor predeterminado

contexto: autoselect_variant

Para obtener datos precisos de pricing/buybox, establezca este parámetro en true (lo que nos indica añadir 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 del producto del ASIN padre, omita este parámetro o establézcalo en false.

false

contexto: moneda

Establece la moneda. Consulte los valores disponibles aquí.

Depende del marketplace. Consulte los valores predeterminados aquí.

Ejemplo de código

Datos estructurados

Web Scraper API es capaz de extraer tanto un objeto HTML como 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 de la derecha o desplazándose hacia abajo en la página.

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.

Ejemplo en HTML

Estructura JSON

La tabla a continuación presenta una lista detallada de cada elemento de la página de producto de Amazon que analizamos, incluida su descripción, tipo de dato y si el elemento siempre está presente en el diseño o es 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.

cadena

page

El número de página actual.

entero

page_type

Identifica el tipo de página de Amazon.

cadena

asin

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

cadena

asin_in_url

Extrae el número de identificación estándar de Amazon de la URL.

cadena

title

El título del producto.

cadena

manufacturer

El nombre del fabricante del producto.

cadena

product_name

El nombre del producto.

cadena

description

La descripción del producto, analizada de la sección 'Descripción del producto'.

cadena

bullet_points

Los elementos de viñetas analizados de la sección 'Acerca de este producto'.

cadena

opcional

category

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

arreglo

opcional

variation

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

arreglo

opcional

rating

La valoración del producto.

entero

precio

El precio del producto.

flotante

price_upper

El límite superior del precio.

flotante

opcional

price_sns

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

flotante

price_initial

El precio original, sin descuento, de un producto.

flotante

price_shipping

El precio del envío.

flotante

opcional

price_buybox

El precio del producto tal como se muestra en la buybox.

flotante

deal_type

Identifica la categoría de la oferta promocional.

cadena

opcional

coupon

Indica cualquier descuento digital disponible.

cadena

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 cumplen con un umbral mínimo de valor.

booleano

opcional

moneda

La moneda en la que está expresado el precio.

cadena

discount_end

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

cadena

opcional

stock

Indica el nivel de inventario del producto.

cadena

reviews_count

La cantidad de reseñas del producto.

entero

reseñas

Una lista de reseñas con sus respectivos detalles.

arreglo

answered_questions_count

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

entero

opcional

pricing_count

La cantidad de ofertas del producto.

entero

opcional

pricing_url

La URL para recuperar los listados de ofertas de productos de Amazon.

cadena

opcional

pricing_str

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

cadena

opcional

featured_merchant

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

objeto

opcional

sales_rank

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

arreglo

opcional

sns_discounts

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

arreglo

developer_info

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

objeto

opcional

images

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

arreglo

product_overview

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

arreglo

opcional

store_url

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

cadena

opcional

has_videos

Indica si el producto tiene algún video.

booleano

delivery

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

objeto

opcional

marca

La marca del producto.

cadena

opcional

item_form

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

cadena

opcional

sales_volume

La cantidad de unidades vendidas en un periodo específico.

cadena

opcional

other_sellers

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

cadena

opcional

rating_stars_distribution

Una lista de detalles sobre las calificaciones del producto.

arreglo

opcional

buybox

Una lista de detalles sobre los precios del producto.

arreglo

opcional

lightning_deal

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

objeto

opcional

product_details

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

objeto

opcional

product_dimensions

Las dimensiones del producto.

cadena

opcional

max_quantity

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

entero

opcional

warranty_and_support

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

objeto

opcional

discount.percentage

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

entero

opcional

amazon_choice

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

booleano

opcional

coupon_discount_percentage

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

entero

opcional

parent_asin

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

cadena

opcional

creado_en

La marca de tiempo en que se creó el trabajo de scraping.

marca_de_tiempo

actualizado_en

La marca de tiempo en que terminó el trabajo de scraping.

marca_de_tiempo

id_del_trabajo

El ID del trabajo asociado con el trabajo de scraping.

cadena

código_de_estado

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

entero

parse_status_code

El código de estado del trabajo de análisis. Puedes ver los códigos de estado del parser descritos aquí.

entero

Categoría

Este campo muestra la estructura jerárquica de las categorías de productos de un producto de Amazon. Cada categoría en la secuencia 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.

Clave (category)
Descripción
Tipo

ladder

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

arreglo

ladder.name

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

cadena

ladder.url

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

cadena

Anuncios

Este campo contiene información sobre los anuncios que se muestran 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 para Prime y precio.

Clave (ads)
Descripción
Tipo

type

El tipo del anuncio de Amazon.

cadena

location

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

cadena

title

El título del producto.

cadena

asin

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

cadena

images

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

cadena

pos

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

entero

rating

La valoración del producto.

entero

reviews_count

La cantidad de reseñas del producto.

entero

is_prime_eligible

Indica si el producto es elegible para Amazon Prime.

booleano

precio

El precio del producto.

flotante

price_upper

El límite superior del precio, si aplica.

flotante

Distribución de estrellas de calificación

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

Clave (rating_stars_distribution)
Descripción
Tipo

rating

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

entero

porcentaje

Indica el porcentaje específico para esa calificación.

cadena

Reseñas

Contiene reseñas de clientes del producto, y cada reseña se representa como un objeto que contiene detalles relevantes.

Clave (reviews)
Descripción
Tipo

id

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

cadena

title

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

cadena

author

El usuario que envió la reseña.

cadena

rating

La calificación de estrellas asignada al enviar la reseña, normalmente entre 1 y 5.

entero

content

El texto completo del contenido de la reseña.

cadena

marca_de_tiempo

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

cadena

profile_id

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

cadena

is_verified

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

booleano

review_from

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

cadena

helpful_count (opcional)

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

entero

product_attributes (opcional)

Identifica las características del producto.

cadena

image (opcional)

Una lista de URL de imágenes adjuntas a la reseña por el autor.

arreglo

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 información sobre herramientas.

Clave (variaciones)
Descripción
Tipo
Diseño

asin

El número de identificación estándar de Amazon de la variante del producto.

arreglo

selected

Identifica la variante de producto seleccionada.

booleano

dimensions

Las dimensiones del producto variante.

objeto

opcional

dimensions.size

El tamaño del producto variante.

cadena

opcional

dimensions.color

El color del producto variante.

cadena

opcional

dimensions.style

El estilo del producto variante.

cadena

opcional

dimensions.unit count

El conteo estándar de unidades del producto variante.

cadena

opcional

tooltip_image

La URL de la imagen de la variante.

cadena

opcional

Garantía y soporte

Este campo contiene información sobre las opciones de garantía y soporte del 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.

cadena

links

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

arreglo

links.title

El título de la garantía.

cadena

links.url

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

cadena

Comerciante destacado

Este campo proporciona información sobre el comerciante destacado que vende el producto. Incluye detalles como el nombre del comerciante, el ID del vendedor, el 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

nombre

El nombre del vendedor principal.

cadena

seller_id

El ID del vendedor.

cadena

link

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

cadena

is_amazon_fulfilled

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

booleano

shipped_from (opcional)

Indica la ubicación de envío.

cadena

Ranking de ventas

Este campo proporciona información sobre el ranking de ventas del producto dentro de categorías específicas en Amazon. Cada objeto representa una entrada de ranking de ventas, incluida la posición en sí y la jerarquía de categorías, mostrando la jerarquía de categorías que lleva a la categoría clasificada.

Clave(sales_rank)
Descripción
Tipo

rank

Indica la posición en el ranking.

entero

ladder

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

arreglo

ladder.url

La URL de la página de la categoría de más vendidos correspondiente.

cadena

ladder.name

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

cadena

Entrega

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

Clave (delivery)
Descripción
Tipo

type

Indica el tipo de entrega.

cadena

fecha

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

objeto

date.from

La ubicación de envío.

cadena

date.by

La fecha estimada de entrega.

cadena

Caja de compra

Este campo proporciona información sobre la sección "caja de compra" 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 estimadas de llegada.

Clave (buybox)
Descripción
Tipo
Diseño

nombre

El nombre de la opción de precio.

cadena

opcional

stock

El nivel de inventario del producto.

cadena

opcional

delivery_type

Indica el tipo de entrega.

cadena

opcional

delivery_details

Una lista de detalles sobre la entrega del producto.

arreglo

opcional

fecha

Una lista de detalles sobre la fecha de entrega.

objeto

opcional

delivery_details.by

La fecha estimada de entrega.

cadena

opcional

delivery_details.from

La ubicación de envío del producto.

cadena

opcional

delivery_details.type

El tipo de entrega

cadena

opcional

condition

La condición del producto.

cadena

opcional

precio

El precio del producto.

flotante

Oferta relámpago

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

Clave(lightning_deal)
Descripción
Tipo

percent_claimed

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

cadena

price_text

El precio rebajado del producto.

cadena

expires

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

cadena

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.

Arreglo

title

El título del atributo del producto.

cadena

description

La descripción detallada del atributo del producto.

cadena

Última actualización

¿Te fue útil?