The whole European database, as JSON, in your code

GET /api/v1/pays

The 25 countries with counts and source. Public, no key.

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

The 84 sectors with counts, for all countries or for a scope. Public, no key.

GET /api/v1/societes

Paginated search. Parameters: 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}

Full record. Line-by-line financial statements (balance sheet, income statement, up to 5 fiscal years) are returned to identified calls. A full record uses 5 credits, only once a month for the same company.

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

GET|POST /api/v1/export

xlsx workbook of the scope (same parameters, plus lang=fr|en). Account required, monthly quota: 2 workbooks with Discovery, 200 with Complete.

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 : 2-letter ISO codes separated by commas; UK for the United Kingdom.
• secteur : slug or exact FR label, multiple values with |.
• tri : ca_desc (default), ca_asc, nom, effectif_desc, recent, capital_desc, score.
• Amounts: ca_eur in euros; ca_last × ca_mult in local currency (ca_devise).
• UTF-8 JSON, open CORS on /api/v1, pagination by 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 and offset

limit never exceeds your plan cap (5 companies on Discovery, 200 on Data, 500 on Complete): a higher value is clamped to the cap, without an error. total gives the real number of companies in the scope: walk it by incrementing 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")

Handling 429 (quota reached)

Every identified response carries X-Quota-Used and X-Quota-Limit: watch them to stop before the wall. The quota is daily and resets at midnight UTC: retrying straight away is pointless, better resume the loop the next day from the last 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;
}