API Investlytic pour les développeurs

Le principe

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.

Elle est réservée aux plans Développeur (29 € HT par mois) et Business (290 € HT par mois), avec 14 jours d'essai. Voir les tarifs.

Obtenir une clé

Les offres Développeur et Business donnent accès à l'API, au MCP et à l'encart. Elles n'ouvrent pas les outils du site (plateforme, graphique IA, listes) : ceux-ci relèvent des plans Découverte, Investisseur et 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.

Les 5 adresses

Toutes commencent par https://investlytic.co/api/v1 et répondent en GET. Ajoutez lang=en pour recevoir les textes en anglais.

Adresse	Ce qu'elle renvoie	Paramètres
/api/v1/recherche?q=lvmh	Les symboles qui correspondent (resultats)	q (obligatoire), limite (1 à 50)
/api/v1/action/MC.PA	La note d'une action et le détail des 5 critères	direct=1 (analyse en direct), 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	Votre consommation du mois (non comptée)	aucun

/recherche renvoie au plus 50 résultats, quel que soit le plan. /tendance et /dividendes vont jusqu'à 50 lignes avec le plan Développeur et jusqu'à 200 lignes avec le plan Business.

Exemple de réponse 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": "Tendance du prix", "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.

Exemples

curl

curl -H "Authorization: Bearer ilv_VOTRE_CLE" \
  "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"], "— données du", fiche["donnees_du"])

JavaScript (fetch)

// côté serveur (Node 18+) : ne mettez jamais la clé dans le code envoyé au navigateur
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);

Erreurs

En cas d'erreur, la réponse contient un message lisible et le code HTTP :

{ "erreur": "Clé invalide ou révoquée.", "code": 401 }

Code	Signification
400	Paramètre manquant ou symbole mal écrit (exemple : MC.PA, AAPL).
401	Clé absente, invalide ou révoquée.
402	Paiement en attente : abonnement suspendu jusqu'à la mise à jour de votre carte.
403	Votre plan ne comprend pas l'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	Service momentanément indisponible : réessayez dans un instant. L'appel n'est pas facturé.

Quotas et facturation

	Développeur	Business
Abonnement	29 € HT / mois	290 € HT / mois
Appels inclus chaque mois	3 000	50 000
Au-delà	0,01 € l'appel, facturé par tranche de 100 appels entamée (1 €)	0,01 € l'appel, facturé par tranche de 100 appels entamée (1 €)
Analyse en direct	0,10 € (200 par jour maxi)	0,10 € (2 000 par jour maxi)
Listes (tendance, dividendes)	jusqu'à 50 lignes	jusqu'à 200 lignes
Recherche	50 résultats	50 résultats
Encart	avec le logo Investlytic	marque blanche

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.

Fraîcheur des données

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.

L'encart pour votre site

Pour afficher la note d'une action sur une page web sans écrire de code, utilisez l'encart : une seule ligne à coller, gratuite avec le logo Investlytic. Voir Afficher Investlytic sur votre site.

Votre assistant IA

Pour interroger Investlytic depuis Claude, ChatGPT ou Cursor, utilisez le connecteur MCP : Connecter votre IA.

Avertissement

Les données Investlytic sont des informations factuelles, pas un conseil en investissement. Si vous les republiez, citez la source (Investlytic) et la date des données, et conservez cet avertissement auprès de vos utilisateurs.