Documentación de la API

Bienvenido a la API de Melibel. Esta documentación te ayudará a integrar nuestros servicios en tus aplicaciones. La API es un beneficio exclusivo de nuestros usuarios con plan top-tier Te da acceso a una serie de endpoints en crecimiento. Esta información le ayudará a tomar mejores decisiones a tu negocio. ¿Tienes algún endpoint que te sería útil? Queremos escucharte contáctanos y lo desarrollamos para ti.

Autenticación

Todos los endpoints de la API requieren autenticación usando un Token de Acceso Personal.

Formato del encabezado: Authorization: <Access-Token <TOKEN>>

Reemplaza TOKEN con tu token de acceso personal de la página de tokens

Endpoints

GET Ofertas Recientes

Devuelve una lista de ofertas recientes con filtros opcionales.

Detalles del Endpoint

URL: /api/products/recent-offers/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
page Integer No Número de página
category String No Filtrar por categoría (puede repetirse para múltiples)
lower_price Integer No Filtro de precio mínimo
higher_price Integer No Filtro de precio máximo
percentage Integer No Filtro de porcentaje de descuento (por defecto: 100)
store String No Filtrar por tienda (puede repetirse para múltiples)
q String No Búsqueda

Ejemplo de Solicitud

curl -X GET "/api/products/recent-offers/?page=1" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "count": 123,
  "next": "http://localhost:8000/api/products/recent-offers/?page=2",
  "previous": null,
  "results": [
    {
      "id": 123,
      "name": "Product Name",
      "last_price_found": 99.99,
      "second_last_price_found": 129.99,
      "origin": "MLM",
      "url": "https://...",
      "thumbnail": "https://...",
      "created_at": "2026-04-11T12:00:00Z",
      "last_price": {
        "extra_prices": [],
        "created": "2026-04-11",
        "amount": 1356.0,
        "currency": "MXN"
      },
      "average_price": 2224.67,
      "price_difference": -868.67
    },
    ...
  ]
}

GET Stock Uno

Devuelve una lista de productos con stock próximo a agotarse de acuerdo a nuestros datos sobre Mercado Libre.

Detalles del Endpoint

URL: /api/products/stock-one/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
page Integer No Número de página (por defecto: 1)

Ejemplo de Solicitud

curl -X GET "/api/products/stock-one/" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "count": 48,
  "next": "http://localhost:8000/api/products/stock-one/?page=2",
  "previous": null,
  "results": [
    {
      "id": 4570082,
      "product": {
        "id": 152,
        "product": "Apple Pencil Pro",
        "origin": "ML",
        "url": "https://www.mercadolibre.com.mx/apple-pencil-pro/up/MLMU399490896",
        "image": "https://http2.mlstatic.com/D_Q_NP_2X_771749-MLM76442010789_052024-E.webp",
        "location": "MEX",
        "alternative_id": "MLMU399490896",
        "category": [
          "computación",
          "tablets y accesorios",
          "accesorios",
          "lápiz óptico"
        ]
      },
      "created": "2026-04-11T00:55:51.733012Z",
      "modified": "2026-04-11T00:55:51.732998Z",
      "products_available": 0,
      "products_sold": 0,
      "seller": null
    },
    ...
  ]
}

GET Niveles de Stock

Devuelve niveles de stock para productos con opciones de filtrado.

Detalles del Endpoint

URL: /api/products/stock-levels/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
page Integer No Número de página (por defecto: 1)
alternative_id String No ID del producto de Mercado Libre (ej., 'MLM12345678' o 'MLM-123456789'). Usa en lugar de product_url
product_url String No URL del producto (coincidencia parcial, ej. 'iphone-15' o URL completa)
stock_status String No Filtrar por: in_stock, low_stock, out_of_stock
category String No Filtrar por nombre de categoría
days Integer No Días de retroalimentación (por defecto: 15)

Ejemplo de Solicitud

curl -X GET "/api/products/stock-levels/?stock_status=low_stock" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Definiciones de Estado de Stock

  • in_stock: Más de 2 unidades disponibles
  • low_stock: 1-2 unidades disponibles (por agotarse)
  • out_of_stock: 0 unidades disponibles

Ejemplo de Respuesta

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "product_id": 1250,
      "product_name": "Xiaomi Poco X7 Pro 5g Dual Slm 256 Gb Negro 8 Gb Ram",
      "product_url": "https://www.mercadolibre.com.mx/xiaomi-poco-x7-pro-5g-dual-slm-256-gb-negro-8-gb-ram/p/MLM45824212",
      "product_alternative_id": "MLM45824212",
      "current_stock": 50,
      "products_sold": 10000,
      "stock_status": "in_stock",
      "last_stock_update": "2026-04-13T00:06:47.988229Z",
      "seller_url": "https://www.mercadolibre.com.mx/tienda/poco",
      "price": "5964.48"
    }
  ]
}

GET Precios de Competidores

Busca un producto por URL para ver los precios de todos los vendedores. Compara tu precio contra los competidores.

Detalles del Endpoint

URL: /api/products/competitor-pricing/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
alternative_id String No ID del producto de Mercado Libre (ej., 'MLM12345678' o 'MLM-123456789'). Usa en lugar de product_url
product_url String Sí URL del producto (coincidencia parcial, ej. 'iphone-15' o URL completa)
seller_url String No Tu URL de vendedor para encontrar tu posición en el ranking
days Integer No Días de retroalimentación (por defecto: 15)

Ejemplo de Solicitud

# Search for a product by URL to see competitor prices
curl -X GET "/api/products/competitor-pricing/?product_url=iphone-15-pro" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

# Search using Mercado Libre ID (alternative_id)
curl -X GET "/api/products/competitor-pricing/?alternative_id=MLM123456789" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

# Also see where you rank among competitors
curl -X GET "/api/products/competitor-pricing/?product_url=iphone-15-pro&seller_url=mystore" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "product_id": 7412,
  "product_name": "iPhone 15 Pro 256GB",
  "product_url": "https://www.mercadolibre.com.mx/iphone-15-pro...",
  "category": "iphone",
  "total_sellers": 12,
  "your_position": {
    "seller_id": 5,
    "seller_url": "https://www.mercadolibre.com.mx/tienda/mystore",
    "price": 15499.00,
    "last_updated": "2026-04-12T10:30:00Z"
  },
  "your_rank": 3,
  "your_price_vs_competitors": 200.00,
  "lowest_price": 14990.00,
  "highest_price": 17990.00,
  "average_price": 16200.00,
  "all_sellers": [
    {
      "seller_id": 8,
      "seller_url": "https://www.mercadolibre.com.mx/tienda/cheapseller",
      "price": 14990.00,
      "last_updated": "2026-04-12T08:00:00Z"
    },
    {
      "seller_id": 3,
      "seller_url": "https://www.mercadolibre.com.mx/tienda/competitor2",
      "price": 15299.00,
      "last_updated": "2026-04-12T09:15:00Z"
    },
    {
      "seller_id": 5,
      "seller_url": "https://www.mercadolibre.com.mx/tienda/mystore",
      "price": 15499.00,
      "last_updated": "2026-04-12T10:30:00Z"
    },
    ...
  ]
}

Campos de Respuesta

  • total_sellers: Número de vendedores con precios para este producto
  • your_position: Tu información de vendedor (si seller_url coincide)
  • your_rank: Tu posición en el ranking de precios (1 = más barato)
  • your_price_vs_competitors: Tu precio menos el precio más bajo. Positivo = eres más caro
  • all_sellers: Todos los vendedores ordenados por precio (más barato primero)

GET Tendencias de Precios

Muestra tendencias de precios para productos con cambios significativos de precio (caídas o aumentos). Úsalo para encontrar ofertas o identificar oportunidades de precios.

Detalles del Endpoint

URL: /api/products/price-trends/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
page Integer No Número de página (por defecto: 1)
trend String No Filtrar por: price_drop, price_increase, all (por defecto: all)
days Integer No Días de retroalimentación (por defecto: 30)
min_percentage Integer No Porcentaje mínimo de cambio de precio (por defecto: 1)

Ejemplo de Solicitud

# Get products with price drops
curl -X GET "/api/products/price-trends/?trend=price_drop&min_percentage=5" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "count": 892,
  "next": "http://localhost:8000/api/products/price-trends/?page=2",
  "previous": null,
  "results": [
    {
      "product_id": 7412,
      "product_name": "Samsung Galaxy S24 Ultra",
      "product_url": "https://...",
      "category": "samsung",
      "current_price": 18990.00,
      "previous_price": 21999.00,
      "price_change": -3009.00,
      "percentage": -13.68,
      "trend": "price_drop",
      "last_updated": "2026-04-12T10:30:00Z"
    },
    ...
  ]
}

GET Información de Categorías

Devuelve información de mercado para categorías hojas (nivel más específico de categoría). Los productos solo están registrados en categorías hojas.

Detalles del Endpoint

URL: /api/categories/category-insights/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
page Integer No Número de página (por defecto: 1)
category String No Filtrar por nombre de categoría (coincidencia parcial)
parent String No Filtrar por nombre de categoría padre
days Integer No Días de retroalimentación (por defecto: 30)

Ejemplo de Solicitud

curl -X GET "/api/categories/category-insights/?parent=Celulares" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "count": 4293,
  "next": "http://localhost:8000/api/products/category-insights/?page=2",
  "previous": null,
  "results": [
    {
      "category_id": 123,
      "category_name": "iphone",
      "parent_category": "celulares y smartphones",
      "product_count": 892,
      "active_sellers": 45,
      "average_price": 12500.50,
      "min_price": 3500.00,
      "max_price": 45000.00,
      "avg_products_available": 0.5,
      "trending_score": 8.5
    },
    ...
  ]
}

GET Rendimiento de Vendedor

Devuelve métricas de rendimiento para vendedores incluyendo cantidad de productos, precios y puntajes de competitividad.

Detalles del Endpoint

URL: /api/products/seller-performance/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
page Integer No Número de página (por defecto: 1)
days Integer No Días de retroalimentación (por defecto: 30)
seller_url String No Buscar vendedor por URL (coincidencia parcial, sin distinción de mayúsculas). Devuelve un solo vendedor si se encuentra.

Ejemplo de Solicitud

# Get all sellers
curl -X GET "/api/products/seller-performance/" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

# Search for a specific seller by URL
curl -X GET "/api/products/seller-performance/?seller_url=gadgettroops" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "count": 309,
  "next": "http://localhost:8000/api/products/seller-performance/?page=2",
  "previous": null,
  "results": [
    {
      "seller_id": 698,
      "seller_url": "https://www.mercadolibre.com.mx/pagina/seller123",
      "product_count": 45,
      "average_price": 5200.00,
      "lowest_price": 450.00,
      "highest_price": 15000.00,
      "avg_products_available": 12.5,
      "price_competitiveness_score": -5.2,
      "last_updated": "2026-04-12T10:30:00Z"
    },
    ...
  ]
}

Campos de Respuesta

  • price_competitiveness_score: Diferencia porcentual del promedio del mercado. Negativo = más barato que el promedio, Positivo = más caro que el promedio
  • product_count: Número de productos únicos de los cuales el vendedor tiene precios
  • average_price: Precio promedio de todos sus productos

GET Velocidad de Stock

Identifica inventario de alta rotación calculando products_sold a lo largo del tiempo. Compara products_sold entre dos puntos para obtener velocidad por día. Los productos están ordenados por velocidad (más vendidos primero).

Detalles del Endpoint

URL: /api/products/stock-velocity/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
page Integer No Número de página (por defecto: 1)
days Integer No Días hacia atrás para calcular velocidad (por defecto: 30)

Ejemplo de Solicitud

# Get products with highest velocity (fastest selling)
curl -X GET "/api/products/stock-velocity/?days=30" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "count": 156,
  "next": "http://localhost:8000/api/products/stock-velocity/?page=2",
  "previous": null,
  "results": [
    {
      "product_id": 1234,
      "product_name": "iPhone 15 Pro 256GB",
      "product_url": "https://www.mercadolibre.com.mx/iphone-15-pro...",
      "category": "iphone",
      "velocity": 333.33,
      "total_products_sold": 10000,
      "products_available": 10,
      "average_price": 15499.00
    },
    {
      "product_id": 5678,
      "product_name": "Samsung Galaxy S24",
      "product_url": "https://www.mercadolibre.com.mx/samsung-galaxy-s24...",
      "category": "samsung",
      "velocity": 100.00,
      "total_products_sold": 3000,
      "products_available": 25,
      "average_price": 12999.00
    }
  ]
}

Campos de Respuesta

  • velocity: Productos vendidos por día en el período
  • total_products_sold: Total productos vendidos en el período (diferencia entre inicio y fin)
  • products_available: Stock disponible actual
  • average_price: Precio promedio entre vendedores

GET Productos del Vendedor

Rastrea los productos y precios de un vendedor. Devuelve los últimos productos con historial de precios de un vendedor específico.

Detalles del Endpoint

URL: /api/products/seller-products/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
seller_url String Sí URL del vendedor a rastrear (coincidencia parcial, sin distinción de mayúsculas)
page Integer No Número de página (por defecto: 1)
days Integer No Días de retroalimentación (por defecto: 15)

Ejemplo de Solicitud

# Get products and prices from a specific seller
curl -X GET "/api/products/seller-products/?seller_url=mystore&days=7" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "count": 50,
  "next": "http://localhost:8000/api/products/seller-products/?page=2&seller_url=mystore",
  "previous": null,
  "results": [
    {
      "product_id": 1234,
      "product_name": "iPhone 15 Pro 256GB",
      "product_url": "https://www.mercadolibre.com.mx/iphone-15-pro...",
      "category": "iphone",
      "price": 15499.00,
      "products_available": 10,
      "products_sold": 100,
      "last_updated": "2026-04-13T10:30:00Z",
      "prices": [
        {"amount": 15499.00, "currency": "MXN", "created": "2026-04-13T10:30:00Z"},
        {"amount": 15299.00, "currency": "MXN", "created": "2026-04-12T10:30:00Z"},
        {"amount": 15199.00, "currency": "MXN", "created": "2026-04-11T10:30:00Z"}
      ]
    }
  ]
}

Campos de Respuesta

  • prices: Arreglo con los últimos 30 precios para este producto (amount, currency, created)

GET Elasticidad por categoría

Calcula la elasticidad precio de los productos de una categoría comparando los cambios de precio con el agotamiento del inventario (productos_vendidos). Muestra la sensibilidad de la demanda a los cambios de precio.

Detalles del Endpoint

URL: /api/categories/price-elasticity/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
category String Sí Nombre de categoría (match parcial, insensible a mayúsculas). Include a todas las categorías descendientes.
days Integer No Periodo en días(por defecto: 60)

Ejemplo de Solicitud

# Calculate elasticity for "Phone Chargers" category
curl -X GET "/api/categories/price-elasticity/?category=Phone%20Chargers&days=60" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "category": "Phone Chargers",
  "elasticity_score": 2.4,
  "interpretation": "HIGHLY_ELASTIC",
  "meaning": "10% price drop → 24% sales increase"
}

Niveles de interpretación

  • PERFECTLY_INELASTIC: La demanda no cambia con el precio
  • INELASTIC: La demanda cambia menos que el precio
  • ELASTIC: 1 <= Elasticity < 3.5 (La demanda cambia más que el precio)
  • HIGHLY_ELASTIC: Elasticity >= 3.5 (La demanda es muy sensible al precio)

GET Nested Categories

Devuelve las categorías en una estructura de árbol, paginada por categorías raíz. Cada página incluye las categorías raíz y todos sus hijos anidados.

Detalles del Endpoint

URL: /api/categories/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
page Integer No Número de página (por defecto: 1)

Ejemplo de Solicitud

curl -X GET "/api/categories/" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "count": 10,
  "next": "http://localhost:8000/api/products/categories/?page=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "name": "Electronics",
      "children": [
        {"id": 2, "name": "Celphones", "children": []},
        {"id": 3, "name": "Tablets", "children": []}
      ]
    }
  ]
}

GET Registro de Estado del Vendedor

Devuelve los registros de estado del vendedor a lo largo del tiempo, incluyendo nivel, calificaciones y datos de transacciones.

Detalles del Endpoint

URL: /api/sellers/state-registry/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
page Integer No Número de página (por defecto: 1)
seller_url String No Filtrar por URL del vendedor (coincidencia parcial, sin distinción de mayúsculas)
seller_name String No Filtrar por nombre del vendedor (coincidencia parcial, sin distinción de mayúsculas)
days Integer No Días de retroalimentación (por defecto: 30, máximo: 180)

Ejemplo de Solicitud

curl -X GET "/api/sellers/state-registry/?seller_url=mystore&days=30" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "count": 5,
  "next": null,
  "previous": null,
  "results": [
    {
      "seller_id": 123,
      "seller_name": "My Store",
      "seller_url": "https://www.mercadolibre.com.mx/tienda/mystore",
      "level_id": 3,
      "power_seller_status": true,
      "transactions_total": 1500,
      "transactions_canceled": 50,
      "transactions_completed": 1450,
      "rating_negative": 100.0,
      "rating_positive": 5000.0,
      "rating_neutral": 200.0,
      "sales_period": 30,
      "sales_completed": 450,
      "created": "2026-04-15T10:30:00Z"
    }
  ]
}

GET Oportunidades de Vendedores

Devuelve vendedores con calificaciones negativas más altas que las positivas, ordenados por ventas descendentes. Útil para encontrar vendedores con bajo rendimiento para dirigir.

Detalles del Endpoint

URL: /api/sellers/opportunities/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
page Integer No Número de página (por defecto: 1)
days Integer No Días de retroalimentación (por defecto: 30, máximo: 180)

Ejemplo de Solicitud

curl -X GET "/api/sellers/opportunities/?days=30" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "count": 25,
  "next": "http://localhost:8000/api/products/sellers/opportunities/?page=2",
  "previous": null,
  "results": [
    {
      "seller_id": 456,
      "seller_name": "Underperforming Store",
      "seller_url": "https://www.mercadolibre.com.mx/tienda/badstore",
      "level_id": 2,
      "power_seller_status": false,
      "transactions_total": 800,
      "transactions_completed": 650,
      "rating_negative": 150.0,
      "rating_positive": 100.0,
      "rating_neutral": 50.0,
      "sales_completed": 300,
      "created": "2026-04-15T10:30:00Z"
    }
  ]
}

GET Predictor de Riesgo de Perdida de clientes (Churn Risk)

Predicción de riesgo de pérdida de clientes (Churn Risk) basada en ML usandoDeclive de ventas, aumento de cancelaciones, nivel estancado y caídas de inventario. Útil para retención proactiva.

Detalles del Endpoint

URL: /api/sellers/churn-risk/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
seller_url String No URL del vendedor (coincidencia parcial, sin distinción de mayúsculas). Usar en lugar de seller_name
seller_name String No Nombre del vendedor (coincidencia parcial, sin distinción de mayúsculas). Usar en lugar de seller_url
days Integer No Días de retroalimentación (por defecto: 30, máximo: 180)

Ejemplo de Solicitud

curl -X GET "/api/sellers/churn-risk/?seller_url=mystore&days=30" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "seller_id": 123,
  "seller_name": "My Store",
  "seller_url": "https://www.mercadolibre.com.mx/tienda/mystore",
  "churn_risk_score": 75,
  "risk_level": "HIGH",
  "factors": {
    "sales_decline": 20.5,
    "cancel_rate": 15.0,
    "level_stagnant": 15.0,
    "inventory_drops": 24.5
  },
  "days_analyzed": 30
}

Definiciones de Nivel de Riesgo

  • HIGH: Puntuación >= 70 - Se recomienda intervención inmediata
  • MEDIUM: Puntuación >= 40 - Monitorear de cerca
  • LOW: Puntuación < 40 - Estado saludable

GET Vendedores Emergentes

Descubre vendedores emergentes de alto crecimiento basados en la aceleración de ventas, velocidad de promoción, tracción de nuevos vendedores y mejora de calificaciones. Útil para encontrar potenciales socios o clientes de servicios asociados.

Detalles del Endpoint

URL: /api/sellers/emerging/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
page Integer No Número de página (por defecto: 1)
days Integer No Días de retroalimentación (por defecto: 30, máximo: 180)

Ejemplo de Solicitud

curl -X GET "/api/sellers/emerging/?days=30" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "count": 15,
  "next": "http://localhost:8000/api/products/sellers/emerging/?page=2",
  "previous": null,
  "results": [
    {
      "seller_id": 789,
      "seller_name": "Rising Star Store",
      "seller_url": "https://www.mercadolibre.com.mx/tienda/risingstar",
      "registration_date": "2026-01-15T00:00:00Z",
      "growth_score": 85,
      "growth_level": "HIGH",
      "transactions_completed": 1200,
      "sales_completed": 800,
      "level_id": 4,
      "factors": {
        "sales_acceleration": 25.0,
        "level_promotion": 25.0,
        "new_seller_traction": 15.0,
        "rating_improvement": 20.0
      }
    }
  ]
}

Definiciones de Nivel de Crecimiento

  • HIGH: Puntuación >= 70 - Alto potencial de crecimiento
  • MEDIUM: Puntuación >= 40 - Crecimiento moderado
  • LOW: Puntuación < 40 - Bajo crecimiento

GET Vitalidad del Vendedor

Puntuación compuesta de vitalidad que combina impulso de reputación, salud de inventario, confiabilidad de cumplimiento y trayectoria de vendedor poderoso. Usar para monitorear la salud del vendedor diariamente.

Detalles del Endpoint

URL: /api/sellers/vitality/

Parámetros de Consulta

Parámetro Tipo Requerido Descripción
seller_url String No URL del vendedor (coincidencia parcial, sin distinción de mayúsculas). Usar en lugar de seller_name
seller_name String No Nombre del vendedor (coincidencia parcial, sin distinción de mayúsculas). Usar en lugar de seller_url
days Integer No Días de retroalimentación (por defecto: 30, máximo: 180)

Ejemplo de Solicitud

curl -X GET "/api/sellers/vitality/?seller_url=mystore&days=30" \
  -H "Authorization: <Access-Token YOUR_TOKEN_HERE>"

Ejemplo de Respuesta

{
  "seller_id": 123,
  "seller_name": "My Store",
  "seller_url": "https://www.mercadolibre.com.mx/tienda/mystore",
  "vitality_score": 75,
  "vitality_level": "HEALTHY",
  "factors": {
    "reputation_momentum": 8.5,
    "inventory_health": 20,
    "fulfillment_reliability": 18.0,
    "power_seller_trajectory": 10
  },
  "latest_registry": {
    "level_id": 3,
    "power_seller_status": true,
    "transactions_completed": 1500
  },
  "days_analyzed": 30
}

Definiciones de Nivel de Vitalidad

  • HEALTHY: Puntuación >= 70 - El vendedor está prosperando
  • AT_RISK: Puntuación >= 40 - Necesita atención
  • CRITICAL: Puntuación < 40 - Se necesita intervención inmediata

Primeros pasos

  1. Crea tu token de acceso personal desde la Crear Token página.
  2. Copia tu token inmediatamente ya que no se mostrará de nuevo.
  3. Usa el token en el encabezado de Authorization como 'Access-Token ' para las solicitudes de la API.
  4. Consulta esta documentación para los endpoints y parámetros disponibles.