{"openapi":"3.1.0","info":{"title":"Structural Power Index API","version":"1.0.0","description":"Read-only access to the Structural Power Index — Susan Strange's four structures of power scored across twelve nations. Every score carries its reasoning, vintage, and sources.","license":{"name":"See structuralpower.org"}},"servers":[{"url":"https://api.structuralpower.org"}],"paths":{"/v1/editions":{"get":{"summary":"List published editions (year, methodology, DOI).","responses":{"200":{"description":"OK","content":{"application/json":{}}}}}},"/v1/countries":{"get":{"summary":"All twelve nations with headline structural-power scores, ranked.","parameters":[{"name":"edition","in":"query","required":false,"schema":{"type":"integer"},"description":"Edition year. Defaults to the latest published edition."}],"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}},"/v1/countries/{id}":{"get":{"summary":"One nation: headline + four structures + all metrics + components + sources.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"ISO3 (USA), short name (US), or display name (United States)."},{"name":"edition","in":"query","required":false,"schema":{"type":"integer"},"description":"Edition year. Defaults to the latest published edition."}],"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}},"/v1/metrics":{"get":{"summary":"The metric set grouped by structure, with definitions.","responses":{"200":{"description":"OK","content":{"application/json":{}}}}}},"/v1/metrics/{key}":{"get":{"summary":"One metric: definition + all twelve nations' scores, ranked.","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"},"description":"Metric key, e.g. reserves, nuclear-order-setting."},{"name":"edition","in":"query","required":false,"schema":{"type":"integer"},"description":"Edition year. Defaults to the latest published edition."}],"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}},"/v1/data":{"get":{"summary":"Full export: every nation, structure, metric, and component for one edition.","parameters":[{"name":"edition","in":"query","required":false,"schema":{"type":"integer"},"description":"Edition year. Defaults to the latest published edition."}],"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}}}}