API

Query the index.

The whole index is a read-only REST API — every nation, metric, component, score, and source, with the reasoning behind each judgment. Built for two readers: scholars who want the data, and AI agents that need a callable contract. No key required to read.

Base URL

https://api.structuralpower.org

Every data route defaults to the latest edition; add ?edition=2026 to pin one. Responses are JSON, cached at the edge, open CORS for GET.

Endpoints

GET /v1/editions

Published editions — year, methodology version, DOI.

GET /v1/countries

All twelve nations with headline scores, ranked.

GET /v1/countries/{id}

One nation: headline + four structures + every metric, component, and source. Accepts ISO3 (USA), short name (US), or display name.

GET /v1/metrics

The 21-metric set grouped by structure, with definitions.

GET /v1/metrics/{key}

One metric: definition + all twelve nations’ scores, ranked.

GET /v1/data

Full export — every nation, structure, metric, and component for one edition.

GET /v1/openapi.json

OpenAPI 3.1 spec. Point an LLM agent at this to make the index a callable tool.

Example

The United States’ finance structure, with the reserves metric and its sources:

curl https://api.structuralpower.org/v1/countries/US

{
  "iso3": "USA",
  "name": "United States",
  "headline": 91.4,
  "structures": [
    {
      "key": "finance",
      "score": 86.1,
      "metrics": {
        "reserves": {
          "definition": "reserves measures the structural power a state derives…",
          "normalized": 95,
          "components": [ { "area": "Trade & payments denomination",
            "score": 95, "reason": "USD 50.5% of intl payments…",
            "vintage": "2026-03-31" } ],
          "citations": [ { "title": "SWIFT Global Currency Tracker", "url": "…" } ]
        }
      }
    }
  ]
}

For AI agents

The OpenAPI spec at https://api.structuralpower.org/v1/openapi.json describes every endpoint as a tool definition. Register it with a function-calling model (or an MCP gateway) and the agent can ask the index directly — “what is China’s finance score, and what sources back it?” resolves to a single call. Every score returns its reasoning and citations, so an agent can quote the evidence, not just the number.

Access

Reads are open and unauthenticated — this is public research data. A free account for higher-volume or programmatic use is planned; until then, please be considerate with request volume. The dataset is also available as a single download on the methodology page.