Il 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.
È riservata ai piani Sviluppatore (29 € HT al mese) e Business (290 € HT al mese), con 14 giorni di prova. Vedere le tariffe.
Ottenere una chiave
Le offerte Sviluppatore e Business danno accesso all'API, al MCP e al widget. Non aprono gli strumenti del sito (piattaforma, grafico IA, liste): questi appartengono ai piani Scoperta, Investitore e 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.
Soluzione di fallback: se il tuo strumento non può inviare intestazioni, aggiungi ?key=ilv_TUA_CLAVE all'indirizzo. Attenzione: una chiave inserita nell'URL viene registrata nei log dei server (il tuo, i proxy, l'history del browser). Preferisci l'intestazione sempre che sia possibile, e non pubblicare mai la tua chiave su una pagina web.
Le 5 indirizzi
Toutes commencent par https://investlytic.co/api/v1 et répondent en GET. Ajoutez lang=en pour recevoir les textes en anglais.
| Indirizzo | Ciò che restituisce | Parametri |
|---|---|---|
/api/v1/recherche?q=lvmh | Les symboles qui correspondent (resultats) | q (obbligatorio), limite (1 a 50) |
/api/v1/action/MC.PA | La valutazione di un'azione e i dettagli dei 5 criteri | direct=1 (analisi in diretta), 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 | La tua consumazione del mese (non conteggiata) | nessuno |
/ricerca restituisce al massimo 50 risultati, indipendentemente dal piano. /tendenza e /dividendi vanno fino a 50 righe con il piano Sviluppatore e fino a 200 righe con il piano Business.
Esempio di risposta di /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": "Tendenza del prezzo", "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.
Esempi
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"], "— dati del", fiche["donnees_du"])JavaScript (fetch)
// dal lato server (Node 18+): non mettere mai la chiave nel codice inviato al browser const r = await fetch("https://investlytic.co/api/v1/action/MC.PA", { headers: { Autorizzazione: "Bearer ilv_VOTRE_CLE" } }); const fiche = await r.json(); if (!r.ok) throw new Error(fiche.errore); console.log(fiche.nome, fiche.nota + "/" + fiche.sur, fiche.donnees_du);Errori
In caso di errore, la risposta contiene un messaggio leggibile e il codice HTTP :
{ "errore": "Chiave non valida o revocata.", "codice": OnClickListener }| Codice | Significato |
|---|---|
| 400 | Paramètre manquant ou symbole mal écrit (exemple : MC.PA, AAPL). |
| 401 | Chiave assente, invalida o revocata. |
| 402 | Pagamento in attesa : abbonamento sospeso fino alla aggiornamento della tua carta. |
| 403 | Il tuo piano non include 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 | Servizio temporaneamente non disponibile: riprova tra poco. La chiamata non è fatturata. |
Quote e fatturazione
| Sviluppatore | Business | |
|---|---|---|
| Abbonamento | 29 € IVA esclusa / mese | 290 € IVA esclusa / mese |
| Chiamate incluse ogni mese | 3 000 | 50 000 |
| Al di là | 0,01 € l'appello, fatturato a partire da 100 chiamate (1 €) | 0,01 € l'appello, fatturato a partire da 100 chiamate (1 €) |
| Analisi in diretta 0,10 € (200 al giorno massimo) | 0,10 € (2 000 al giorno massimo) | |
| Liste (tendenza, dividendi) | fino a 50 righe | fino a 200 righe |
| Ricerca | 50 risultati | 50 risultati |
| Encart con il logo Investlytic | marca bianca |
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.
Freschezza dei dati
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'inserzione per il vostro sito
Per visualizzare la nota di un'azione su una pagina web senza scrivere codice, usa l'articolo : una sola riga da incollare, gratuita con il logo Investlytic. Vedere Visualizzare Investlytic sul tuo sito.
Il tuo assistente IA
Per interrogare Investlytic da Claude, ChatGPT o Cursor, usa il connettore MCP : Collegare la tua IA.
Avvertenza
I dati Investlytic sono informazioni factuali, non un consiglio di investimento. Se li ripubblichi, citare la fonte (Investlytic) e la data dei dati, e conservare questo avviso tra i tuoi utenti.