Extrae la ficha. Construye lo demás.
Extrae nombre, marca, galería, precio y disponibilidad publicados por tiendas en una ficha JSON con calidad y procedencia.
Crea tu API keycurl "https://api.vitruko.lat/v1/extract" \
-H "X-API-Key: TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://tienda.com/products/articulo"}'Permiso de la clave: extract. Cada petición admitida consume una unidad del plan.
Un contrato para tu interfaz
Una lista de regalos o una colección de productos empieza con un enlace. Copiar a mano nombre, descripción e imagen añade trabajo y errores. Vitruko recibe la URL y devuelve una ficha JSON. Puedes asignarlos a tus componentes, revisarlos y guardarlos en tu propia aplicación. La API también devuelve marca, galería, precio con moneda y disponibilidad cuando la fuente los publica, junto con datos de calidad. No estima los valores ausentes.
Cómo se elige la información
El extractor lee el HTML público de la página. Considera Open Graph, metadatos de Twitter, el título del documento, JSON-LD de tipo Product o ProductGroup y microdatos de producto. Cuando encuentra un producto estructurado, su nombre tiene prioridad sobre el título genérico de la tienda y su imagen sobre un logotipo. JSON-LD también puede estar dentro del cuerpo del documento; la lectura está acotada para no procesar respuestas arbitrariamente grandes.
El enlace identifica el artículo
La normalización elimina parámetros de seguimiento conocidos, como utm_source o gclid. Conserva parámetros de variante y vendedor. En enlaces compartidos de Mercado Libre, mantiene pdp_filters e intenta preservar el artículo que se encuentre en el fragmento. No sustituye la ficha por un resultado de búsqueda ni por otro producto que tenga una imagen más fácil de obtener.
Integra la respuesta con revisión
Una respuesta HTTP 200 incluye title, description, imageUrl y url. Los campos de descripción e imagen pueden estar vacíos. No presentes esos vacíos como un fallo total ni inventes un valor; ofrece una edición manual. Si la página no publica una ficha útil o bloquea la consulta, HTTP 422 permite conservar la URL y pedir los datos necesarios. La disponibilidad de las fuentes externas puede cambiar sin aviso.
Autenticación, cuotas y errores
Envía la clave en X-API-Key o Authorization: Bearer. HTTP 401 indica una clave ausente o inválida; 403, falta de permiso o cuenta suspendida; 429, cuota o velocidad excedida. Consulta las cabeceras de cuota y respeta Retry-After. El panel muestra tu plan y consumo real.