The principle
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.
It is reserved for Developer (29 € HT per month) and Business (290 € HT per month) plans, with a 14-day trial. See prices.
Obtain a key
Developer and Business offers give access to the API, MCP, and the widget. They do not open the site's tools (platform, AI chart, lists): these belong to the Discovery, Investor, and Pro plans.
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.
Backup solution: if your tool cannot send a header, add ?key=ilv_YOUR_KEY to the address. Warning: a key placed in the address is recorded in server logs (yours, proxies, browser history). Prefer the header whenever possible, and never publish your key on a webpage.
The 5 addresses
Toutes commencent par https://investlytic.co/api/v1 et répondent en GET. Ajoutez lang=en pour recevoir les textes en anglais.
| Address | What it returns | Parameters |
|---|---|---|
/api/v1/search?q=lvmh | Les symboles qui correspondent (resultats) | q (required), limit (1 to 50) |
/api/v1/action/MC.PA | The rating of a stock and the details of the 5 criteria | direct=1 (live analysis), 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 | Your monthly consumption (not counted) | none |
/search returns up to 50 results regardless of plan. /trend and /dividends return up to 50 rows with Developer plan and up to 200 rows with Business plan.
Example response from /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": "Price trend", "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.
Examples
curl
curl -H "Authorization: Bearer ilv_YOUR_KEY" \ "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_YOUR_KEY"}) with urllib.request.urlopen(req) as r: fiche = json.load(r) print(fiche["name"], fiche["score"], "/", fiche["out_of"], "— data from", fiche["data_from"])JavaScript (fetch)
// server-side (Node 18+): never put the key in the code sent to the browser const r = await fetch("https://investlytic.co/api/v1/action/MC.PA", { headers: { Authorization: "Bearer ilv_YOUR_KEY" } }); const fiche = await r.json(); if (!r.ok) throw new Error(fiche.error); console.log(fiche.name, fiche.score + "/" + fiche.out_of, fiche.data_from);Errors
In case of error, the response contains a readable message and the HTTP status code:
{ "error": "Invalid or revoked key.", "code": 401 }| Code | Meaning |
|---|---|
| 400 | Paramètre manquant ou symbole mal écrit (exemple : MC.PA, AAPL). |
| 401 | Absent key, invalid or revoked. |
| 402 | Payment pending: subscription suspended until your card is updated. |
| 403 | Your plan does not include the 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 temporarily unavailable: try again shortly. The call is not charged. |
Quotas and Billing
| Developer | Business | |
|---|---|---|
| Subscription | 29 € HT / month | 290 € HT / month |
| Calls included each month | 3 000 | 50 000 |
| Beyond | 0.01 € call, billed in increments of 100 calls started (1 €) | 0.01 € call, billed in increments of 100 calls started (1 €) |
| Live analysis 0,10 € (max 200 per day) | 0.10 € (2,000 per day max) | |
| Lists (trends, dividends) | up to 50 lines | up to 200 lines |
| Search | 50 results | 50 results |
| Card with the Investlytic logo | white label |
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.
Data freshness
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.
Widget for your website
To display the rating of a stock on a webpage without writing any code, use the widget: just one line to copy, free with the Investlytic logo. See Display Investlytic on your site.
Your AI assistant
To query Investlytic from Claude, ChatGPT, or Cursor, use the MCP connector: Connect your AI.
Warning
Investlytic data are factual information, not investment advice. If you republish them, cite the source (Investlytic) and the date of the data, and keep this warning among your users.