API
Chaque tableau du site répond aussi en JSON, sans clé, sans compte et sans quota.
Les chiffres appartiennent aux fonds qui les déclarent et aux régulateurs qui les publient. En les reprenant, citez la source d'origine.
| Adresse | Ce qu'elle rend |
|---|---|
/api/company/<isin> Essayer | Les fonds qui détiennent une société, avec le nombre de titres, le poids dans chaque fonds et la part du capital quand elle est connue. |
/api/fund/<id> Essayer | Ce qu'un fonds détient, ligne par ligne, à la date de sa déclaration. |
/api/isins Essayer | Toutes les sociétés servies, un ISIN et son adresse par ligne. |
/fr/feed.xml Essayer | Chaque fonds dont la composition entre ici ou y est mise à jour, lue dans le rapport que le fonds publie lui-même. |
/api/fund/<id>.csv Essayer | Le même tableau en fichier, pour un tableur. |
/api/company/<isin>.csv Essayer | Le même tableau en fichier, pour un tableur. |
/api/openapi.json Essayer | Le contrat OpenAPI, généré depuis les constantes que le code sert. |
Toutes ces adresses acceptent limit (1 000 lignes par défaut, 12 000 au plus) et offset ; le bloc page de la réponse porte le total, l’adresse de la page suivante et celle de la précédente. Les fichiers acceptent aussi lang, qui écrit les colonnes dans une des trois langues du site. Au-delà de 120 demandes par minute, une adresse reçoit une réponse 429 et le délai à attendre.
Pas de version dans les adresses, parce que rien ne cassera : un champ peut apparaître, aucun ne disparaît ni ne change de sens, et une adresse ne bouge pas.
Les refus
Une erreur répond en application/problem+json (RFC 9457) : son champ type pointe l’une des ancres ci-dessous, status et detail disent le reste.
company-not-found- Aucune société ne répond à cet identifiant. La liste vit à /api/isins.
fund-not-found- Aucun fonds ne répond à cet identifiant.
not-found- La ressource demandée n’existe pas.
no-such-endpoint- Aucune adresse de l’API ne répond ici.
method-not-allowed- Ces adresses sont en lecture seule : GET, HEAD et OPTIONS.
rate-limit-exceeded- Trop de demandes dans la minute. retry-after dit combien attendre.
server-error- Le site n’a pas su répondre. Réessayer un peu plus tard.