L'API Scorvest

Les scores de santé financière, leurs cinq piliers et les principaux ratios, en JSON, pour vos tableurs, vos outils internes et vos applications.

Accès

L'API est incluse dans la formule Pro, avec 5000 requêtes par jour. Créez votre clé depuis « Mon compte » et envoyez-la dans l'en-tête Authorization.

Authorization: Bearer sv_live_…

Besoin de volumes plus importants ou d'une licence de diffusion ? Voir l'offre entreprises →

Points d'accès

GET /api/v1/company/{id}

Une entreprise : score, piliers, ratios, historique du score et source officielle.

curl -H "Authorization: Bearer sv_live_…" https://scorvest.com/api/v1/company/aapl

GET /api/v1/scores?ids=aapl,msft,…

Jusqu'à 25 entreprises par appel (sans l'historique).

curl -H "Authorization: Bearer sv_live_…" "https://scorvest.com/api/v1/scores?ids=aapl,msft,tw-2330"

GET /api/v1/rankings?country=US&sector=tech&min_score=70&limit=100

Le classement des grandes entreprises suivies, filtrable par pays, secteur et score minimum (1 000 lignes au plus).

curl -H "Authorization: Bearer sv_live_…" "https://scorvest.com/api/v1/rankings?country=FR&min_score=70"

Réponse

{
  "data": {
    "id": "aapl",
    "name": "Apple Inc.",
    "country": "US",
    "currency": "USD",
    "fiscal_year": 2025,
    "score": 81,
    "grade": "Strong",
    "pillars": { "profitability": 92, "strength": 63, "cash": 95, "stability": 84, "growth": 58 },
    "ratios": { "operating_margin": 0.32, "roe": 1.5, "net_debt_to_ebitda": 0.4, "altman_z": 4.1, "piotroski_f": 7, "…": "…" },
    "score_history": [{ "fiscal_year": 2024, "score": 79 }, { "fiscal_year": 2025, "score": 81 }],
    "last_filed": "2025-10-31",
    "source": { "name": "SEC EDGAR", "url": "https://www.sec.gov/…" }
  }
}

Valeurs illustratives. Les ratios sont exprimés en décimales (0,32 = 32 %). Les identifiants sont ceux des URL du site : ticker américain (aapl), LEI européen, ou préfixe pays (br-, kr-, jp-, tw-).

Python

import requests

KEY = "sv_live_…"
r = requests.get("https://scorvest.com/api/v1/scores", params={"ids": "aapl,msft"},
                 headers={"Authorization": f"Bearer {KEY}"})
for c in r.json()["data"]:
    print(c["name"], c["score"])

Conditions

Ce que contient l'API: Les scores, piliers et ratios calculés par Scorvest. Les états financiers bruts ne sont pas redistribués : chaque réponse renvoie vers la source officielle.
Usage: Usage interne par l'abonné. La revente ou la diffusion publique des données nécessite une licence entreprise.
Limites: 5000 requêtes par jour et par compte ; l'en-tête X-RateLimit-Remaining indique le solde.
Avertissement: Information générale, sans garantie d'exactitude, pas un conseil en investissement.

Commencez avec la formule Pro.

Voir la formule Pro Créer ma clé