vitruko.

Tiendas distintas. La misma respuesta.

Conecta fichas públicas de distintas plataformas sin mantener un contrato diferente por tienda.

Crea tu API key
Ejemplo de petición
curl "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.

Primero, la información de la página

El primer paso es común: consultar la URL HTTPS pública y leer sus metadatos. Vitruko no necesita que la persona identifique la plataforma antes de enviar el enlace. Cuando existe una ficha útil en el HTML, puede devolverla directamente. No hay integración con cuentas privadas de comerciantes ni lectura de pedidos o datos de compradores.

Complementos públicos de Shopify y VTEX

Para rutas products compatibles, el extractor consulta primero la API pública de producto de Shopify, conservando prefijos de idioma. Para VTEX puede complementar el HTML con su fuente pública de catálogo cuando identifica una página compatible terminada en p. Estos complementos usan el mismo cliente que verifica destinos públicos. En VTEX se comprueba la coincidencia del identificador de la ficha para evitar devolver otro artículo del catálogo.

Enlaces compartidos de Mercado Libre

Los enlaces compartidos pueden contener un identificador de artículo además del producto agrupado. Vitruko elimina seguimiento conocido y mantiene el identificador seleccionado. El perfil de vista previa se limita a dominios reales de Mercado Libre; no se aplica a hosts que solo incluyen ese nombre como parte de otro dominio. El resultado depende de la información pública disponible en el momento de consultar.

Lo que debes prever en producción

Una tienda puede restringir solicitudes automatizadas, mover sus rutas o exigir JavaScript. Vitruko no ejecuta un navegador ni resuelve CAPTCHA; esos casos pueden devolver HTTP 422. Maneja el error con edición manual y conserva el enlace. Si la tienda impone una espera, HTTP 429 con code source_rate_limited y Retry-After indica cuándo reintentar. Las consultas al mismo dominio se espacian y durante esa espera no se vuelve a consultar la tienda. Respeta los límites de tu plan y las condiciones de cada fuente. Los nombres de plataformas describen compatibilidad técnica y no una asociación comercial.

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.

Consultar parámetros y respuestas