Public API Docs

Base URL

https://atlasgeopolitica.com

Endpoints

• GET /api/rankings returns Nodesteader Index rankings for all ranked countries.
• GET /api/worldbank/{country} returns cached World Bank and micro-data for a two- or three-letter country code.
• GET /api/health returns service status and discovery metadata links.

Example

curl https://atlasgeopolitica.com/api/worldbank/CHL
curl https://atlasgeopolitica.com/api/rankings
curl https://atlasgeopolitica.com/api/health

Authentication Discovery

Atlas Geopolitica publishes OAuth discovery metadata for machine clients at /.well-known/oauth-authorization-server and an OpenID-compatible alias at /.well-known/openid-configuration.

• authorization_endpoint: https://atlasgeopolitica.com/oauth/authorize
• token_endpoint: https://atlasgeopolitica.com/oauth/token
• jwks_uri: https://atlasgeopolitica.com/.well-known/jwks.json
• scopes_supported: atlas.read
• Protected resource metadata: /.well-known/oauth-protected-resource

Public read endpoints remain anonymously accessible on this deployment. Managed OAuth clients can be enabled separately for higher-assurance or future rate-managed access. The interactive authorize endpoint is advertised for standards compatibility, but does not currently issue user-facing sessions on this deployment.

Access Policy

• Anonymous GET access is available for the documented public endpoints.
• The advertised atlas.read scope is reserved for managed OAuth clients.
• Protected routes are not yet exposed beyond the current public API surface.

Notes

• Responses are JSON encoded with public cache headers.
• Country routes on the website use lowercase slugs, while the API uses ISO country codes.
• The rankings endpoint is backed by Cloudflare KV and may return 404 until the cache has been warmed.