Base URL
https://geopolitique.aubeetoilee.com/api
Authentification & limites
Aucune clé requise. CORS * activé. Pas de quota dur ;
merci de mettre en cache côté client. Pour usage industriel,
contactez l'institut.
Endpoints
GET /api/countries
Liste des 250 pays. Champs légers (nom bilingue, capitale, drapeau, chef d'État/gouvernement, métriques heatmap : V-Dem, Freedom House, CPI, RSF, défense %PIB, sanctions bool, statut nucléaire).
curl -s "https://geopolitique.aubeetoilee.com/api/countries" | jq '.items[0]'
GET /api/countries/<iso3>
Payload pays brut (Wikidata + dossier institut). ISO 3166-1 alpha-3 en majuscules.
curl -s "https://geopolitique.aubeetoilee.com/api/countries/FRA" | jq '.head_of_state, .nuclear, .chokepoints'
GET /api/contexte/<code>
Résumé court d'un pays, par code ISO alpha-2 (FR) ou
alpha-3 (FRA) : régime, chefs d'État et de gouvernement,
alliances, sanctions, posture nucléaire, passages stratégiques,
conflits actifs, prochaines élections et lien vers la fiche.
?lang=en pour l'anglais.
curl -s "https://geopolitique.aubeetoilee.com/api/contexte/IR" | jq '.pays[0] | {regime, chef_etat, sanctions, nucleaire}'
GET /api/contexte?lat=<lat>&lon=<lon>
Pays d'une position puis pays voisins dans un rayon
(rayon_km, 200 par défaut, 1000 au plus), du plus proche
au plus loin, chacun avec le résumé ci-dessus plus
relation (territoire ou voisin)
et distance_km. En mer, aucun pays n'est
« territoire ». Frontières Natural Earth simplifiées à environ 2 km :
assez pour situer une zone, pas pour trancher un litige frontalier.
curl -s "https://geopolitique.aubeetoilee.com/api/contexte?lat=26.6&lon=56.4" | jq '.pays[] | {nom, relation, distance_km}'
GET /api/dossier/<iso3> recommandé
Dossier complet avec toutes les couches : identité, gouvernement, parlement, économie (World Bank), militaire (Wikidata + manuel), gouvernance (V-Dem/FH/CPI/RSF), minerais (USGS), défense (SIPRI), sanctions (OFAC/UE/UN), nucléaire (SIPRI/FAS), verrous géostratégiques, hymne national, articles liés.
curl -s "https://geopolitique.aubeetoilee.com/api/dossier/IRN" | jq '.country.nuclear, .country.chokepoints, .related_articles'
GET /api/articles
Articles publiés. Filtres optionnels : ?section=carnet|influence|dossier|briefing,
?iso3=FRA, ?limit=20.
curl -s "https://geopolitique.aubeetoilee.com/api/articles?section=influence&limit=5"
GET /article/<slug>.pdf
Génère un briefing PDF L'Aube Étoilée (couverture + corps + carte de citation APA/BibTeX/Chicago). Email facultatif (lead capture). Cookie d'1 an pour les téléchargements suivants.
Comment citer
La couche institut (sanctions, dossiers, articles, analyses) est sous licence CC-BY 4.0. Les couches dérivées suivent leurs licences d'origine :
- Wikidata — CC0
- World Bank Open Data — CC-BY 4.0
- USGS Mineral Commodity Summaries — domaine public US
- SIPRI — usage non commercial avec attribution
- OFAC / EU / UN sanctions lists — domaine public
- flagcdn.com — CC0
Format BibTeX :
@misc{aubegeopolitique-2026,
author = {L'Aube Étoilée},
title = {AubeGeopolitique — fiche pays consolidée},
year = { 2026 },
url = { https://geopolitique.aubeetoilee.com },
publisher = {AubeGeopolitique — L'Aube Étoilée}
}
Exemple : alignement diplomatique
# Liste des pays sanctionnés simultanément US, UE et ONU
curl -s "https://geopolitique.aubeetoilee.com/api/countries" \
| jq '[.items[] | select(.sanctioned)] | length'
# Top 10 budgets de défense
for iso in USA CHN RUS IND SAU GBR DEU UKR FRA JPN; do
curl -s "https://geopolitique.aubeetoilee.com/api/dossier/$iso" \
| jq -r "[.country.iso3, .country.defense_sipri.spending_usd_b] | @tsv"
done
Stabilité, support
L'API est en v1. Les ajouts de champs sont rétro-compatibles.
Les changements cassants seront signalés via le carnet et un changelog.
Pour usage soutenu : référencez la version de l'institut dans votre code
(en-tête User-Agent) pour qu'on puisse vous prévenir.