Het 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.
Het is gereserveerd voor de ontwikkelaarsplannen (29 € HT per maand) en zakenplannen (290 € HT per maand), met 14 dagen proefperiode. Zie de prijzen.
Een sleutel verkrijgen
De aanbiedingen Developer en Business geven toegang tot de API, MCP en het widget. Ze openen niet de gereedschappen van de website (platform, IA-grafiek, lijsten) : die zijn onderdeel van de plannen Discovery, Investor en 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.
Oplossing voor het geval dat uw hulpmiddel geen header kan verzenden, voeg ?key=ilv_UWEN_CODE toe aan de adreslijn. Let op: een code die in de adreslijn staat, wordt vastgelegd in de serverlogs (de uwe, de proxys, de navigatielogboeken). Prefereer de header zoveel mogelijk, en publiceer nooit uw code op een webpagina.
De 5 adressen
Toutes commencent par https://investlytic.co/api/v1 et répondent en GET. Ajoutez lang=en pour recevoir les textes en anglais.
| Dirección | Wat ze retourneert | Parameters |
|---|---|---|
/api/v1/recherche?q=lvmh | Les symboles qui correspondent (resultats) | q (verplicht), limiet (1 tot 50) |
/api/v1/action/MC.PA | De rating van een aandeel en de details van de 5 criteria | direct=1 (analyse in 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 | Uw consumptie van dit maand (niet meegerekend) | geen |
/zoeken retourneert maximaal 50 resultaten, ongeacht het abonnement. /tendens en /dividenden gaan tot 50 regels met het ontwikkelaar-abonnement en tot 200 regels met het zakelijke abonnement.
Voorbeeld antwoord van /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": "Prijsontwikkeling", "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_TOEGANGSLEEG" \ "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"], "— gegevens van", fiche["donnees_du"])JavaScript (fetch)
// server-side (Node 18+): nooit de sleutel in het code dat wordt verzonden naar de browser plaatsen 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
In geval van een fout bevat de reactie een leesbare boodschap en het HTTP-code:
{ "fout": "Ongeldige of ingetrokken sleutel.", "code": 401 }| Code | Betekenis |
|---|---|
| 400 | Paramètre manquant ou symbole mal écrit (exemple : MC.PA, AAPL). |
| 401 | Sleutel afwezig, ongeldig of ingetrokken. |
| 402 | Betaling in afwachting : abonnement geschorst tot aanpassing van uw kaart. |
| 403 | Uw plan bevat geen 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 | Dienst momenteel niet beschikbaar : probeer opnieuw over een paar seconden. De oproep wordt niet berekend. |
Limieten en facturering
| Ontwikkelaar | Business | |
|---|---|---|
| Suscripción | 29 € excl. BTW / maand | 290 € excl. BTW / maand |
| Ongerekende oproepen elke maand | 3 000 | 50 000 |
| Buiten | 0,01 € per aanroep, factureerd per traject van 100 aanroepen (1 €) | 0,01 € per aanroep, factureerd per traject van 100 aanroepen (1 €) |
| Live-analyse 0,10 € (maximaal 200 per dag) | 0,10 € (maximaal 2 000 per dag) | |
| Lijsten (trend, dividenden) | tot 50 regels | tot 200 regels |
| Zoeken | 50 resultaten | 50 resultaten |
| Encart met het logo Investlytic | merk wit |
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.
Verschillendheid van de data
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.
Het widget voor uw website
Om de score van een beursnotering op een webpagina weer te geven zonder code te schrijven, gebruik de widget : één regel te kopiëren, gratis met het logo Investlytic. Zie Toon Investlytic op uw website.
Uw IA-assistent
Om Investlytic te raadplegen via Claude, ChatGPT of Cursor, gebruik de connector MCP : Verbind uw AI.
Waarschuwing
De data van Investlytic zijn feitelijke informatie, geen beleggingsadvies. Als u deze herpubliceert, citeer de bron (Investlytic) en de datum van de data, en behoud dit waarschuwing bij uw gebruikers.