El principio
L'API Investlytic donne à vos outils la note Investlytic d'une action (sur 5 critères), avec l'explication de chaque critère, les actions en tendance et les meilleures actions à dividende. Les réponses sont en JSON, en français ou en anglais, et indiquent toujours la date des données.
Está reservada a los planes Desarrollador (29 € HT por mes) y Business (290 € HT por mes), con 14 días de prueba. Ver los precios.
Obtener una clave
Las ofertas Desarrollador y Negocios dan acceso a la API, al MCP y al widget. No abren las herramientas del sitio (plataforma, gráfico IA, listas): estos pertenecen a los planes Descubrimiento, Inversor y Pro.
Après la souscription, ouvrez Paramètres → API & IA et créez une clé. Elle commence par ilv_ et ne s'affiche qu'une fois : copiez-la dans un endroit sûr. Vous pouvez la révoquer et en créer une nouvelle à tout moment.
Envoyez la clé dans l'en-tête Authorization: Bearer ilv_VOTRE_CLE. C'est la méthode recommandée.
Solución de respaldo: si su herramienta no puede enviar encabezados, agregue ?key=ilv_SU_PALABRA_CLAVE a la dirección. Cuidado: una clave colocada en la dirección es registrada en los registros de los servidores (el suyo, los proxy, el historial del navegador). Prefiera los encabezados siempre que sea posible, y nunca publique su clave en una página web.
Las 5 direcciones
Toutes commencent par https://investlytic.co/api/v1 et répondent en GET. Ajoutez lang=en pour recevoir les textes en anglais.
| Dirección | Lo que devuelve | Parámetros |
|---|---|---|
/api/v1/recherche?q=lvmh | Les symboles qui correspondent (resultats) | q (obligatorio), límite (1 a 50) |
/api/v1/action/MC.PA | La calificación de una acción y los detalles de los 5 criterios | direct=1 (análisis en directo), lang=en |
/api/v1/tendance | Les actions en tendance (resultats) | marche (fr, us, de…), note_min, limite |
/api/v1/dividendes | Les meilleures actions à dividende (resultats) | marche, rendement_min, rendement_max, limite |
/api/v1/usage | Su consumo del mes (no contabilizado) | ningún |
/recherche devuelve hasta 50 resultados, independientemente del plan. /tendencia y /dividendos llegan hasta 50 filas con el plan Desarrollador y hasta 200 filas con el plan Empresarial.
Ejemplo de respuesta de /api/v1/action/MC.PA :
{ "symbole": "MC.PA", "nom": "LVMH", "note": 4, "sur": 5,
"donnees_du": "2026-10-06", "donnees": "stockees",
"criteres": [ { "cle": "tendance", "libelle": "Tendencia del precio", "verdict": true,
"explication": "Le cours monte sur la durée : le marché accompagne l'entreprise." }, … ],
"variation_annuelle": { "2024": 12.3, "2025": -4.1 },
"source": "Investlytic", "fiche": "https://investlytic.co/action-public?symbol=MC.PA",
"avertissement": "Information factuelle, pas un conseil en investissement." }donnees vaut stockees (dernière mise à jour Investlytic, datée par donnees_du) ou direct (analyse du jour).
/api/v1/usage renvoie plan, mois, inclus, utilises, reste, depassement, direct_aujourdhui et direct_plafond_jour.
Ejemplos
curl
curl -H "Authorization: Bearer ilv_VOTRE_CLAVE" \ "https://investlytic.co/api/v1/action/MC.PA"Python (bibliothèque standard, urllib)
import json, urllib.request req = urllib.request.Request("https://investlytic.co/api/v1/action/MC.PA", headers={"Authorization": "Bearer ilv_VOTRE_CLE"}) with urllib.request.urlopen(req) as r: fiche = json.load(r) print(fiche["nom"], fiche["note"], "/", fiche["sur"], "— datos del", fiche["datos_del"])JavaScript (fetch)
// lado servidor (Node 18+): nunca coloque la clave en el código enviado al navegador const r = await fetch("https://investlytic.co/api/v1/action/MC.PA", { headers: { Authorization: "Bearer ilv_VOTRE_CLE" } }); const fiche = await r.json(); if (!r.ok) throw new Error(fiche.erreur); console.log(fiche.nom, fiche.note + "/" + fiche.sur, fiche.donnees_du);Errores
En caso de error, la respuesta contiene un mensaje legible y el código HTTP :
{ "error": "Clave inválida o revocada.", "code": 401 }| Código | Significado |
|---|---|
| 400 | Paramètre manquant ou symbole mal écrit (exemple : MC.PA, AAPL). |
| 401 | Clave ausente, inválida o revocada. |
| 402 | Pago pendiente : suscripción suspendida hasta la actualización de su tarjeta. |
| 403 | Su plan no incluye la API. |
| 404 | Symbole absent de la base Investlytic : vérifiez-le avec /recherche. Non facturé. |
| 429 | Plus de 10 appels par seconde, ou plafond quotidien d'analyses en direct atteint (revenez le lendemain, ou appelez sans direct=1). |
| 503 | Servicio temporalmente no disponible: inténtelo de nuevo en un momento. La llamada no se factura. |
Cuotas y facturación
| Desarrollador | Negocio | |
|---|---|---|
| Suscripción | 29 € HT / mes | 290 € HT / mes |
| Llamadas incluidas cada mes | 3 000 | 50 000 |
| Más allá | 0,01 € el llamado, facturado por tramo de 100 llamadas iniciadas (1 €) | 0,01 € el llamado, facturado por tramo de 100 llamadas iniciadas (1 €) |
| Análisis en directo 0,10 € (200 por día máximo) | 0,10 € (2 000 por día máximo) | |
| Listas (tendencia, dividendos) | hasta 50 líneas | hasta 200 líneas |
| Búsqueda | 50 resultados | 50 resultados |
| Encarte con el logotipo de Investlytic | marca blanca |
Chaque appel réussi est décompté ; /api/v1/usage ne compte pas. Les appels au-delà du forfait et les analyses en direct sont ajoutés à votre facture du mois. Suivez votre consommation avec /api/v1/usage ou dans Paramètres → API & IA.
Actualidad de los datos
Par défaut, l'API renvoie la note de la dernière mise à jour Investlytic, toujours datée. Avec ?direct=1 sur /api/v1/action/…, la note est recalculée avec les données du jour : c'est l'analyse en direct, réservée aux plans Développeur et Business et facturée 0,10 €. Si l'analyse en direct n'aboutit pas, vous recevez la note stockée ("donnees": "stockees"), comptée comme un appel ordinaire.
El encarte para su sitio
Para mostrar la calificación de una acción en una página web sin escribir código, utilice el widget : una sola línea para copiar, gratuita con el logotipo de Investlytic. Ver Mostrar Investlytic en su sitio.
Su asistente IA
Para consultar a Investlytic desde Claude, ChatGPT o Cursor, utilice el conector MCP : Conectar su IA.
Advertencia
Los datos de Investlytic son información factual, no un consejo de inversión. Si los reproduce, cite la fuente (Investlytic) y la fecha de los datos, y conserve este aviso junto a sus usuarios.