O princípio
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.
Ela está reservada aos planos Desenvolvedor (29 € HT por mês) e Negócios (290 € HT por mês), com 14 dias de teste. Ver os preços.
Obter uma chave
As ofertas Desenvolvedor e Business dão acesso à API, ao MCP e ao cartão. Elas não abrem as ferramentas do site (plataforma, gráfico IA, listas): essas últimas pertencem aos planos Descoberta, Investidor 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.
Solução de contingência: se seu recurso não souber enviar cabeçalhos, adicione ?key=ilv_SEUACODIGO à URL. Atenção: uma chave colocada na URL é registrada nos logs dos servidores (o seu, os proxies, o histórico do navegador). Prefira o cabeçalho sempre que possível, e nunca publique sua chave em uma página web.
As 5 endereços
Toutes commencent par https://investlytic.co/api/v1 et répondent en GET. Ajoutez lang=en pour recevoir les textes en anglais.
| Endereço | O que ela retorna | Parâmetros |
|---|---|---|
/api/v1/recherche?q=lvmh | Les symboles qui correspondent (resultats) | q (obrigatório), limite (1 a 50) |
/api/v1/action/MC.PA | A nota de uma ação e os detalhes dos 5 critérios | direct=1 (análise em direto), 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 | Sua utilização do mês (não contabilizada) | nenhum |
/pesquisa retorna até 50 resultados, independentemente do plano. /tendência e /dividendos vão até 50 linhas com o plano Desenvolvedor e até 200 linhas com o plano Negócios.
Exemplo de resposta 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": "Tendência do preço", "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.
Exemplos
curl
curl -H "Authorization: Bearer ilv_SEU_TOKEN" \ "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_SEU_CHEFE"}) with urllib.request.urlopen(req) as r: fiche = json.load(r) print(fiche["nome"], fiche["nota"], "/", fiche["sobre"], "— dados de", fiche["dados_do"])JavaScript (fetch)
// lado do servidor (Node 18+): nunca coloque a chave no código enviado ao navegador const r = await fetch("https://investlytic.co/api/v1/action/MC.PA", { headers: { Authorization: "Bearer ilv_SEUACHAVE" } }); const fiche = await r.json(); if (!r.ok) throw new Error(fiche.erro); console.log(fiche.nome, fiche.nota + "/" + fiche.sobre, fiche.dados_do);Erros
Em caso de erro, a resposta contém uma mensagem legível e o código HTTP :
{ "erro": "Chave inválida ou revogada.", "code": 401 }| Código | Significado |
|---|---|
| 400 | Paramètre manquant ou symbole mal écrit (exemple : MC.PA, AAPL). |
| 401 | Chave ausente, inválida ou revogada. |
| 402 | Pagamento pendente : assinatura suspensa até a atualização do seu cartão. |
| 403 | Seu plano não inclui a 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 | Serviço temporariamente indisponível: tente novamente em breve. A chamada não é cobrada. |
Cotas e faturamento
| Desenvolvedor | Negócios | |
|---|---|---|
| Assinatura | 29 € sem impostos / mês | 290 € sem impostos / mês |
| Chamadas incluídas a cada mês | 3 000 | 50 000 |
| Além disso | 0,01 € por chamada, faturado por faixa de 100 chamadas iniciadas (1 €) | 0,01 € por chamada, faturado por faixa de 100 chamadas iniciadas (1 €) |
| Análise em tempo real 0,10 € (200 por dia máximo) | 0,10 € (2 000 por dia máximo) | |
| Listas (tendência, dividendos) | até 50 linhas | até 200 linhas |
| Pesquisa | 50 resultados | 50 resultados |
| Encarte com o logotipo Investlytic | marca branca |
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.
Frescor dos dados
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.
O cartão para o seu site
Para exibir a nota de uma ação em uma página web sem escrever código, use o widget : apenas uma linha para colar, gratuita com o logotipo Investlytic. Veja Exibir Investlytic no seu site.
Seu assistente IA
Para consultar o Investlytic a partir de Claude, ChatGPT ou Cursor, use o conector MCP : Conectar sua IA.
Aviso
Os dados Investlytic são informações factuais, não um conselho de investimento. Se você os republicar, cite a fonte (Investlytic) e a data dos dados, e conserve este aviso junto aos seus usuários.