Un enlace que ya dice algo.
Muestra una vista previa del producto con la información pública de la tienda y conserva el enlace original normalizado.
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.
De la URL a una vista legible
Una URL por sí sola no muestra qué eligió una persona. La respuesta de Vitruko permite construir una vista previa con título, descripción e imagen. Úsala en listas de deseos, regalos, comparadores que gestionen sus propios datos o colecciones personales. Vitruko entrega información; el diseño y la decisión de guardar el producto pertenecen a tu aplicación.
Imágenes sin copiar credenciales
imageUrl es una URL pública de imagen obtenida de los metadatos. Los enlaces relativos se resuelven contra la página consultada y se descartan esquemas o destinos locales evidentes. No se transfieren cookies del comprador ni credenciales de Vitruko a la tienda. Si el navegador carga esa imagen, contacta directamente con el servidor de origen; utiliza referrerpolicy no-referrer cuando corresponda y una política de imágenes adecuada.
Diseña para respuestas incompletas
No todas las tiendas publican Open Graph o JSON-LD completo. Muestra un bloque neutral cuando imageUrl esté vacío, limita el texto de descripción y deja que la persona confirme el título antes de guardar. Trata la salida como datos, nunca como HTML ejecutable: renderiza el texto con las protecciones normales de tu framework. El endpoint devuelve el precio y la disponibilidad publicados cuando puede identificarlos, sin garantía de inventario actual. price es null y availability es unknown si no se pudieron confirmar.
Repeticiones y cambios en la tienda
Las respuestas correctas pueden permanecer cinco minutos en caché en memoria. X-Cache indica HIT o MISS. La clave de caché conserva el identificador de variante para no mezclar enlaces de productos diferentes. Cada llamada autenticada admitida consume una petición, también cuando usa caché. Una modificación en la tienda puede tardar en reflejarse; si necesitas datos contractuales de compra, compruébalos en la fuente.
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.