Toute la base européenne, en JSON, dans votre code

GET /api/v1/pays

Les 25 pays avec leurs compteurs et leur source. Public, sans clef.

GET /api/v1/secteurs?pays=FR,IT

Les 84 secteurs avec compteurs, pour tous les pays ou pour un périmètre. Public, sans clef.

GET /api/v1/societes

Recherche paginée. Paramètres : pays, secteur, q, tri, limit, offset, ca_min, ca_max, effectif_min, effectif_max, site_web=1, avec_ca=1.

curl "https://argos-finance.fr/api/v1/societes?pays=IT&secteur=machinerie&limit=50" \
  -H "Authorization: Bearer as_live_XXXX"

{
  "total": 12456, "limit": 50, "offset": 0, "apercu": false,
  "societes": [{
    "iso2": "IT", "id": "00123456789", "nom": "ESEMPIO S.P.A.",
    "secteur": "Machinerie", "grand_secteur": "Industrie manufacturière & Matériaux",
    "ville": "Bergamo", "effectif": 240, "ca_eur": 58400000, "ca_year": 2024,
    "site_web": "www.esempio.it", "url_registre": "https://..."
  }]
}

GET /api/v1/societes/{iso}/{id}

Fiche complète. Les états financiers ligne à ligne (bilan, compte de résultat, jusqu'à 5 exercices) sont renvoyés aux appels identifiés. Une fiche complète consomme 5 crédits, une seule fois par mois pour la même société.

curl "https://argos-finance.fr/api/v1/societes/FR/552032534" -H "Authorization: Bearer as_live_XXXX"

GET|POST /api/v1/export

Classeur xlsx du périmètre (mêmes paramètres, plus lang=fr|en). Compte requis, quota mensuel : 2 classeurs avec Découverte, 200 avec Intégral.

curl -L "https://argos-finance.fr/api/v1/export?pays=FR,BE&secteur=restauration&limit=500" \
  -H "Authorization: Bearer as_live_XXXX" -o restauration_FR_BE.xlsx

Conventions

• pays : codes ISO 2 lettres séparés par des virgules ; UK pour le Royaume-Uni.
• secteur : slug ou libellé FR exact, plusieurs valeurs avec |.
• tri : ca_desc (défaut), ca_asc, nom, effectif_desc, recent, capital_desc, score.
• Montants : ca_eur en euros ; ca_last × ca_mult en devise locale (ca_devise).
• Réponses JSON UTF-8, CORS ouvert sur /api/v1, pagination par limit + offset.

Python

import requests

CLE = "as_live_XXXX"
r = requests.get("https://argos-finance.fr/api/v1/societes",
    params={"pays": "FR,BE", "secteur": "restauration|hotellerie", "limit": 100},
    headers={"Authorization": f"Bearer {CLE}"})
r.raise_for_status()
for s in r.json()["societes"]:
    print(s["nom"], s["ville"], s["ca_eur"])

JavaScript

const r = await fetch("https://argos-finance.fr/api/v1/societes?pays=IT&secteur=machinerie&limit=50",
  { headers: { Authorization: "Bearer as_live_XXXX" } });
const { total, societes } = await r.json();

Pagination : limit et offset

limit ne dépasse jamais le plafond de votre offre (5 sociétés en Découverte, 200 en Data, 500 en Intégral) : une valeur supérieure est ramenée au plafond, sans erreur. total donne le nombre réel de sociétés du périmètre : parcourez-le en incrémentant offset.

# page 1 : sociétés 1 à 500
curl "https://argos-finance.fr/api/v1/societes?pays=DE&secteur=machinerie&limit=500&offset=0" \
  -H "Authorization: Bearer as_live_XXXX"
# page 2 : sociétés 501 à 1000
curl "https://argos-finance.fr/api/v1/societes?pays=DE&secteur=machinerie&limit=500&offset=500" \
  -H "Authorization: Bearer as_live_XXXX"

import requests

CLE, PAGE = "as_live_XXXX", 500
params = {"pays": "DE", "secteur": "machinerie", "limit": PAGE, "offset": 0}
tout = []
while True:
    r = requests.get("https://argos-finance.fr/api/v1/societes", params=params,
                     headers={"Authorization": f"Bearer {CLE}"})
    r.raise_for_status()
    j = r.json()
    tout += j["societes"]
    params["offset"] += PAGE
    if params["offset"] >= j["total"] or not j["societes"]:
        break
print(len(tout), "sociétés")

Gérer le 429 (quota atteint)

Chaque réponse identifiée porte X-Quota-Used et X-Quota-Limit : surveillez-les pour vous arrêter avant le mur. Le quota est journalier, il repart à minuit UTC : une nouvelle tentative immédiate ne sert à rien, mieux vaut reprendre la boucle le lendemain depuis le dernier offset.

r = requests.get(url, params=params, headers=entetes)

if r.status_code == 429:
    utilise = r.headers.get("X-Quota-Used")
    limite = r.headers.get("X-Quota-Limit")
    # { "erreur": { "code": "quota_api", "message": "...", "quota": {...} } }
    raise SystemExit(
        f"Quota journalier atteint : {utilise}/{limite}. "
        f"Reprendre demain a l'offset {params['offset']}."
    )

r.raise_for_status()

const r = await fetch(url, { headers });
if (r.status === 429) {
  const utilise = r.headers.get("X-Quota-Used");
  const limite = r.headers.get("X-Quota-Limit");
  console.warn(`Quota atteint : ${utilise}/${limite}, reprise demain (UTC).`);
  return null;
}