Structured intelligence

AI Governance World API

Query source-backed governance records from the same edge-rendered knowledge graph that powers the public platform.

Version 1

All v1 endpoints are rendered at the Cloudflare edge and require an active API key with the listed scope.

MethodEndpointScopeReturns
GET/api/v1/countriescountries:readPaginated country catalog with latest published Index fields.
GET/api/v1/countries/{country}countries:readCountry profile resolved by slug, name, ISO alpha-2, ISO alpha-3 or numeric code.
GET/api/v1/index/2026index:readIndex edition, methodology dimensions, results and evidence sources.
GET/api/v1/observatoryobservatory:readVerified timeline, upcoming deadlines, legislation and coverage.
GET/api/v1/search?q={query}catalog:readFull knowledge graph search across published entities.
GET/api/v1/reports/{slug}reports:readReport content, methodology, charts, references and PDF URL.

Bearer key

Send the API key in the Authorization header. API responses include quota headers for the current day and minute.

curl --request GET \
  --url "https://aigovernanceworld.com/api/v1/countries?page=1&pageSize=50" \
  --header "Authorization: Bearer agw_live_YOUR_KEY"

Direct country JSON

The Blueprint-compatible country route is public, read-only and edge cached. It accepts the same country identifiers as v1.

curl --request GET \
  --url "https://aigovernanceworld.com/country/RO"

Evidence remains attached

Collection endpoints accept page and pageSize; page size is capped at 100. Country lists also accept q, region and rankedOnly. Search requires a query between 2 and 120 characters.

Successful responses expose the requested data together with API version, generation time, publication and verification state, pagination links and source policy. Entity records retain their primary source URL, evidence tier and source date.

Errors use application/problem+json. Rate limits return HTTP 429 with a Retry-After header. The available authorization vocabulary is catalog:read, countries:read, index:read, sources:read, observatory:read, reports:read.