Base URL
https://geopolitique.aubeetoilee.com/api
Auth & limits
No API key required. CORS * open. No hard quota;
please cache on the client side. For industrial usage, contact the
institute.
Endpoints
GET /api/countries
The 250 countries. Light fields (bilingual name, capital, flag, head of state/government, heatmap metrics: V-Dem, Freedom House, CPI, RSF, defense %GDP, sanctioned bool, nuclear status).
curl -s "https://geopolitique.aubeetoilee.com/api/countries" | jq '.items[0]'
GET /api/countries/<iso3>
Raw country payload (Wikidata + institute dossier). ISO 3166-1 alpha-3 uppercase.
curl -s "https://geopolitique.aubeetoilee.com/api/countries/FRA" | jq '.head_of_state, .nuclear, .chokepoints'
GET /api/dossier/<iso3> recommended
Complete dossier with all layers: identity, government, parliament, economy (World Bank), military (Wikidata + curated), governance (V-Dem/FH/CPI/RSF), minerals (USGS), defense (SIPRI), sanctions (OFAC/EU/UN), nuclear (SIPRI/FAS), strategic chokepoints, anthem, related articles.
curl -s "https://geopolitique.aubeetoilee.com/api/dossier/IRN" | jq '.country.nuclear, .country.chokepoints, .related_articles'
GET /api/articles
Published articles. Optional filters: ?section=…,
?iso3=FRA, ?limit=20.
curl -s "https://geopolitique.aubeetoilee.com/api/articles?section=influence&limit=5"
GET /article/<slug>.pdf
Generates an L'Aube Étoilée PDF briefing (cover + body + APA/BibTeX/ Chicago citation card). Optional email (lead capture). 1-year cookie for subsequent downloads.
How to cite
The institute layer (sanctions, dossiers, articles, analyses) is licensed under CC-BY 4.0. Derived layers follow their original licenses:
- 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
BibTeX format:
@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}
}
Example: diplomatic alignment
# Countries sanctioned by US, EU and UN at once
curl -s "https://geopolitique.aubeetoilee.com/api/countries" \
| jq '[.items[] | select(.sanctioned)] | length'
# Top 10 defense budgets
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
Stability, support
API is v1. Field additions are backwards-compatible.
Breaking changes will be announced via the logbook and a changelog.
For sustained use: reference the institute version in your client
(User-Agent header) so we can notify you.