API REST de Búsqueda y Valuación Prendaria — Valuabot

El API REST de Valuabot permite consultar en tiempo real o mediante caché inteligente de 15 días los precios de mercado, métricas de préstamo sugerido, pisos de liquidez inmediata y listados depurados de artículos a través de 7 canales simultáneos en México: Mercado Libre (filtrado con envío a CP 06700), Facebook Marketplace, Coppel, CeX México (WeBuy), Efectimundo, Maxilana y Fundación Dondé.

Endpoint principal recomendado para consultar la valuación integral de cualquier artículo. Devuelve los KPIs prendarios (precio de mercado, préstamo sugerido mínimo y máximo, piso de compra en efectivo CeX, percentiles P15/P85), el resumen estadístico separado por cada uno de los 7 canales, la calibración de riesgo prendario opcional y la lista de publicaciones depuradas.

# Consulta síncrona (usa caché de 15 días si existe o calcula en vivo)
curl -X GET "https://valuabot.com/api/v1/valuate/?product=play+station+5&loan=5000" \
  -H "Accept: application/json"

# Consulta mediante POST enviando JSON y filtrando canales específicos
curl -X POST "https://valuabot.com/api/v1/valuate/" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "play station 5",
    "refresh": false,
    "channels": "mercadolibre,facebook,coppel,cex,efectimundo,maxilana,donde",
    "condition": "all",
    "loan": 5000
  }'

import requests

url = "https://valuabot.com/api/v1/valuate/"
params = {
    "product": "play station 5",
    "refresh": "false",
    "condition": "all",
    "loan": 5000
}

response = requests.get(url, params=params, timeout=45)
data = response.json()

kpis = data["valuation_kpis"]
print(f"Precio de Mercado: ${kpis['market_price']} MXN")
print(f"Préstamo Sugerido: ${kpis['loan_suggested_min']} - ${kpis['loan_suggested_max']} MXN")
print(f"Piso Liquidez CeX: ${kpis['cash_floor_cex']} MXN")

for canal, info in data["channels_summary"].items():
    print(f" - {info['name']}: {info['count']} ofertas (Promedio: ${info['avg_price']} MXN)")

const params = new URLSearchParams({
  product: 'play station 5',
  refresh: 'false',
  loan: '5000'
});

const response = await fetch(`https://valuabot.com/api/v1/valuate/?${params.toString()}`);
const data = await response.json();

console.log('KPIs de Valuación:', data.valuation_kpis);
console.log('Desglose por Canal:', data.channels_summary);
console.log(`Total artículos filtrados: ${data.articles_count}`);

<?php
$query = http_build_query([
    'product' => 'play station 5',
    'refresh' => 'false',
    'loan'    => 5000
]);

$ch = curl_init("https://valuabot.com/api/v1/valuate/?" . $query);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 45);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "Préstamo sugerido: $" . $data['valuation_kpis']['loan_suggested_min'] . " MXN\n";
?>

{
  "status": "success",
  "query": "play station 5",
  "canonical_query": "playstation 5",
  "display_query": "Playstation 5",
  "from_cache": true,
  "cache_info": {
    "from_cache": true,
    "age_days": 0,
    "days_remaining": 15,
    "created_at": "14/10/2026"
  },
  "valuation_kpis": {
    "market_price": 7635,
    "suggested_sales_price": 6642.45,
    "loan_suggested_min": 4963,
    "loan_suggested_max": 5726,
    "cash_floor_cex": 5370,
    "precio_bajo_p15": 6500,
    "precio_promedio": 7635,
    "precio_alto_p85": 8900,
    "mean_price_used_c2c": 7635,
    "mean_price_new_retail": 10711,
    "mean_price_pawn_houses": 7540,
    "confidence": "Alta confianza",
    "total_articles_clean": 66,
    "total_articles_raw": 71,
    "outliers_excluded": 5,
    "featured_photo": "https://http2.mlstatic.com/D_NQ_NP_..."
  },
  "channels_summary": {
    "mercadolibre": { "name": "Mercado Libre (CP 06700)", "group": "retail_y_c2c", "count": 20, "avg_price": 8642, "min_price": 6200, "max_price": 11999 },
    "facebook":     { "name": "Facebook Marketplace", "group": "seminuevos_c2c", "count": 14, "avg_price": 7150, "min_price": 5500, "max_price": 8500 },
    "coppel":       { "name": "Coppel", "group": "retail_comercial", "count": 12, "avg_price": 12780, "min_price": 9499, "max_price": 15999 },
    "cex":          { "name": "CeX México", "group": "prendario_y_liquidez", "count": 9, "avg_price": 8833, "min_price": 7800, "max_price": 9800, "cash_floor_avg": 5370 },
    "efectimundo":  { "name": "Efectimundo", "group": "mercado_prendario", "count": 6, "avg_price": 7450, "min_price": 6800, "max_price": 7900 },
    "maxilana":     { "name": "Maxilana", "group": "mercado_prendario", "count": 3, "avg_price": 7466, "min_price": 7200, "max_price": 7599 },
    "donde":        { "name": "Fundación Dondé", "group": "mercado_prendario", "count": 2, "avg_price": 7899, "min_price": 7599, "max_price": 8199 }
  },
  "articles_count": 66,
  "articles": [
    {
      "id": "MAXI-410293",
      "id_valuabot": "MAXI-410293",
      "title": "Videojuego Play Station 5 Slim Sony, 1 Tb Sony",
      "price": 7200.0,
      "condition": "Usado",
      "state": "Maxilana",
      "city": "Palma Real (Guadalajara)",
      "photo": "https://...",
      "permalink": "https://www.maxilana.com/remates/...",
      "channel": "maxilana"
    }
  ]
}

Permite consultar de forma aislada y en tiempo real un único canal específico sin ejecutar los demás scrapers. Ideal cuando solo necesitas verificar disponibilidad en Mercado Libre con envío al CP 06700, precios retail en Coppel, piso de efectivo en CeX o remates en Maxilana / Efectimundo / Dondé.

# Ejemplo 1: Consultar únicamente Mercado Libre con filtro de envío al CP 06700
curl -X GET "https://valuabot.com/api/v1/channel/mercadolibre/?product=play+station+5"

# Ejemplo 2: Consultar únicamente remates de Maxilana
curl -X GET "https://valuabot.com/api/v1/channel/maxilana/?product=play+station+5"

# Ejemplo 3: Consultar únicamente catálogo retail de Coppel
curl -X GET "https://valuabot.com/api/v1/channel/coppel/?product=play+station+5"

Consulta especializada en las vitrinas comerciales de empeño (Efectimundo, Maxilana, Fundación Dondé), Retail (Coppel) y proveedor de liquidez (CeX). Calcula automáticamente la salida neta prendaria (descontando margen de regateo/comisión) y evalúa el nivel de riesgo de un préstamo mediante el parámetro loan.

curl -X GET "https://valuabot.com/api/commercial-catalogs/?product=play+station+5&loan=5200&refresh=false"

Diseñado para aplicaciones frontend reactivas que requieren mostrar avances canal por canal en tiempo real conforme cada uno de los 7 hilos termina su extracción.

// Ejemplo de flujo asíncrono progresivo en JavaScript
async function valuarProgresivamente(producto) {
  const startRes = await fetch(`/api/valuation/start/?product=${encodeURIComponent(producto)}`);
  const startData = await startRes.json();

  // Si ya estaba en la caché de 15 días, retorna completado de inmediato
  if (startData.is_complete && startData.consolidated) {
    return startData.consolidated;
  }

  const taskId = startData.task_id;
  while (true) {
    await new Promise(r => setTimeout(r, 1200));
    const statusRes = await fetch(`/api/valuation/status/${taskId}/`);
    const statusData = await statusRes.json();

    console.log('Avance parcial por canal:', statusData.channels);
    console.log('Resumen preliminar:', statusData.summary);

    if (statusData.is_complete) {
      return statusData.consolidated;
    }
  }
}

Devuelve la lista de los 7 canales activos en Valuabot, sus grupos de mercado (seminuevos_c2c, mercado_prendario, retail_comercial, prendario_y_liquidez) y la configuración de caché vigente.

Endpoint mantenido por retrocompatibilidad con integraciones previas (ej. /api/search/play%20station%205/price_ascend). Ahora está conectado al motor de 7 canales y a la caché inteligente de 15 días, devolviendo tanto el bloque clásico (search, offers, results) como los nuevos bloques valuation_kpis y channels_summary.