Raspado de Etsy: Cómo recopilar listados de productos y precios

Recopilar datos de listados de Etsy autorizados con conversión de moneda correcta, registros a nivel de variantes, verificación de paginación y un flujo de trabajo práctico de revisión en navegador.

Nov 13, 2026Carlos Rivera

TL;DR

Los proyectos de scraping de Etsy deben evaluar primero la API oficial Open y el acceso permitido para la aplicación.
La identidad del listado, la identidad de la variación, el estado de la oferta y el precio observado son dimensiones separadas.
Los valores de dinero de Etsy usan amount, divisor y currency_code; no asuma que el divisor siempre es 100.
El precio de inicio mostrado en un listado no necesariamente es el precio de cada variación comprable.
El ejemplo ejecutable siguiente valida registros de dinero sintéticos localmente; no llama a Etsy ni recopila datos del mercado.

Lo que debe representar un conjunto de datos de listado de Etsy

Un conjunto de datos de listado de Etsy debe representar el listado y la oferta o variación específica que se intente comparar. Un archivo que contenga solo título y un precio de punto flotante puede ser adecuado para un inventario aproximado, pero es insuficiente para un monitoreo confiable de precios. Se necesita identidad, moneda, hora de observación y suficiente contexto de variante para explicar un cambio.

Para una integración de tienda propia, comience con lo que Etsy proporciona para la operación requerida. Para un proyecto de investigación más amplio, verifique el acceso permitido y el uso antes de recopilar datos. Una página de listado público no es evidencia de que cada método de recolección automatizada esté permitido. Un entorno de navegador gestiona la ejecución; no amplía el nivel de acceso de la aplicación.

Elija entre datos de API, exportaciones de tienda y revisión del navegador

Elija la ruta de datos según los campos y el alcance que su proyecto tenga realmente permiso para usar. Los datos estructurados pueden reducir la ambigüedad en la interpretación, pero aún requieren validación de esquema y un modelo de autorización adecuado. La revisión del navegador es útil para resolver una discrepancia específica cuando se permite, en lugar de reemplazar cada integración estructurada.

Use la API Abierta para Operaciones de Aplicación Soportadas

La guía de autenticación de Etsy documenta una clave de API y requisitos de OAuth para operaciones con ámbito. La guía actual especifica un valor x-api-key compuesto por keystring y secreto compartido separados por dos puntos. Verifique los requisitos actuales en la referencia oficial al implementar; tutoriales antiguos pueden mostrar un formato de encabezado incompatible.

Solicite solo el ámbito necesario por el endpoint real. Una ingesta de listado de solo lectura no debe solicitar privilegios de escritura o eliminación simplemente porque un ejemplo los incluya. Mantenga los tokens y secretos de aplicación fuera del código, registros y datos exportados. No se ejecutó ninguna solicitud de API de Etsy autenticada para este artículo.

Separe el estado del listado de los fallos en la extracción

La guía de listados oficial describe estados de ciclo de vida y variaciones de inventario. Un listado puede estar inactivo o agotado, mientras que un recolector también puede fallar en recuperarlo. Preserve esas posibilidades por separado. Un registro faltante en una página parcial de resultados no es suficiente evidencia de que el vendedor haya eliminado un listado.

Use la revisión del navegador para investigar una discrepancia específica

Para un flujo de trabajo de tienda autorizado, compare la variación seleccionada, cantidad, moneda y hora de observación antes de tratar una discrepancia como un defecto de analizador. Registre lo que realmente mostró el navegador. No equivoque un precio de inicio en una tarjeta de categoría, un precio de variación configurado y un total final de compra.

Modele listados y variaciones antes de comparar precios

Use una tabla de listado para identidad de nivel de listado y una tabla de oferta o variación cuando la fuente suministre ese detalle. Almacene identificadores sin procesar como texto para evitar problemas de conversión de hojas de cálculo. Preserve la relación de la fuente entre productos, ofertas y propiedades de variación en lugar de aplanar opciones no relacionadas en una sola cadena de título.

Observación	Contexto requerido	Error común de interpretación
Precio del listado	Moneda, hora, significado del precio	Tratándolo como el precio de cada variación
Oferta de variación	Propiedades seleccionadas e identificador	Comparando tallas diferentes como un cambio de precio
Cantidad	Alcance y estado de origen	Llamando a un número de lista universal de stock
Fila faltante	Paginación y completitud de ejecución	Informando eliminación tras un lote fallido
Monto relacionado con envío	Destino y contexto de cálculo	Mezclando precio del artículo con costo total

Haga explícito su clave de comparación. Por ejemplo, un registro de historial de precios podría estar claveado por listing_id, firma de variación, moneda y observed_at. Es un diseño propuesto de almacén, no una afirmación de que Etsy devuelva un campo llamado variation_signature. Distinga sus columnas normalizadas de los campos del proveedor.

Convierta el dinero de Etsy sin perder su significado

Las definiciones de dinero de Etsy describen amount dividido por divisor y un código de moneda separado. Una división codificada en 100 corrompe registros cuyo divisor difiera. La aritmética de punto flotante binario también introduce problemas evitables cuando los valores se usan para reconciliación.

Ejecute una prueba de conversión basada en decimales

Este ejemplo de Python usa objetos de dinero sintéticos basados en esos campos documentados. Valida el divisor y preserva la moneda. Es una prueba de conversión, no una respuesta de API capturada de una tienda real.

python Copy

from decimal import Decimal
import json

def money(value):
    amount, divisor = value["amount"], value["divisor"]
    if type(amount) is not int or type(divisor) is not int or divisor <= 0:
        raise ValueError("integer amount and positive integer divisor required")
    currency = value["currency_code"]
    if not isinstance(currency, str) or len(currency) != 3 or not currency.isalpha():
        raise ValueError("three-letter currency code required")
    return {"value": format(Decimal(amount) / Decimal(divisor), "f"),
            "currency": currency.upper()}

samples = [{"amount": 1299, "divisor": 100, "currency_code": "USD"},
           {"amount": 2500, "divisor": 1000, "currency_code": "USD"}]
result = [money(x) for x in samples]
assert result[0]["value"] == "12.99"
assert result[1]["value"] == "2.5"
try:
    money({"amount": 1, "divisor": 0, "currency_code": "USD"})
except ValueError:
    rejected_zero_divisor = True
else:
    raise AssertionError("zero divisor was accepted")
print(json.dumps({"converted": result, "rejected_zero_divisor": rejected_zero_divisor}))

La prueba local ejecutada devolvió 12.99 y 2.5 USD y rechazó un divisor cero. La segunda prueba utiliza intencionalmente un divisor diferente para revelar una suposición común de implementación. La validación de un código de tres letras es solo una verificación de formato; la política de moneda en producción debe usar el conjunto de monedas soportadas para la integración. No convierta silenciosamente monedas ni redondee valores antes de definir la política de contabilidad del informe.

Construya un flujo de trabajo de recolección y reconciliación incremental

Comience con un conjunto limitado de tiendas o listados autorizados. Almacene la respuesta cruda con su operación, hora y contexto diagnóstico enmascarado. Normalice cada listado solo después de validar identificadores y estructura de precio requeridos. Rastree por separado la finalización de página o cursor y el número de registros devueltos.

Para ejecuciones repetidas, actualice la representación actual y anexe observaciones históricas de precios donde el proyecto las necesite. Reconcilie filas aceptadas, filas rechazadas y identificadores repetidos. Si una página falla, marque la ejecución como parcial y reintente según las indicaciones actuales del endpoint. No etiquete listados no vistos como eliminados hasta que una comparación completa y la política de eliminación deseada respalden esa conclusión.

Cómo Nstbrowser cumple con las verificaciones de calidad de Etsy autorizadas

Nstbrowser puede organizar la inspección del navegador alrededor de un Perfil guardado para el flujo de trabajo de la tienda deseada. Eso es útil cuando un humano necesita comparar registros estructurados con una vista de página permitida. La configuración de grupos le ayuda a revisar opciones de almacenamiento y sincronización para el entorno. La automatización de procesos (RPA) puede apoyar una secuencia de revisión limitada cuando su alcance esté autorizado y su salida esté revisada. Estas características no reemplazan la aprobación de la aplicación de Etsy, la autenticación de API o un modelo de datos de nivel de variación correcto.

Contexto de tienda: Verifique qué cuenta o vista autorizada produjo una observación.
Comparación controlada: Mantenga el idioma deseado y la variación seleccionada con la verificación.
Flujo de revisión: Registre discrepancias para investigación en lugar de reescribir precios automáticamente.

Prueba gratis >

Pruebe un listado con variaciones conocidas

Prepare el entorno usando creación de Perfil, inspeccione configuración de grupo y adapte una secuencia permitida de documentación de RPA. Compare un listado conocido y una variación seleccionada contra el registro estructurado. No se ejecutó ningún navegador de Etsy en vivo ni integración de Nstbrowser aquí.

Use la prueba para validar significado, no solo extracción exitosa. Una fila es útil solo cuando otro revisor puede indicar qué listado, variación, moneda y momento en el tiempo representa.

Prueba gratis >