{"openapi":"3.1.0","info":{"title":"Spegeln Public API","version":"1.0.0","description":"All offentlig Spegeln-data: fullständiga personnummer med källa, källkopior och versioner, original, påståenden, AI-märkningar, röster och offentlig historik. Gratisnyckeln skapas anonymt direkt; premium öppnar bulk och export automatiskt."},"servers":[{"url":"https://spegeln.org/api/public"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"LeaderboardEntry":{"type":"object","properties":{"rank":{"type":"integer"},"alias":{"type":"string"},"score":{"type":"integer"},"complaintsWithResponse":{"type":"integer"},"investigationsReported":{"type":"integer"},"peerEndorsements":{"type":"integer"},"upvotes":{"type":"integer"}}},"DashboardItem":{"type":"object","properties":{"authorityId":{"type":"string"},"authorityName":{"type":"string"},"category":{"type":"string"},"regionCode":{"type":["string","null"]},"countryCode":{"type":"string"},"complaints":{"type":"integer"},"investigations":{"type":"integer"},"reports":{"type":"integer"},"attentionScore":{"type":"integer"},"resolutionRate":{"type":"number"}}},"ApiAccessTier":{"type":"object","properties":{"tier":{"type":"string"},"monthlyPriceSek":{"type":"integer"},"scopes":{"type":"array","items":{"type":"string"}},"notes":{"type":"string"}}}}},"security":[{"ApiKeyAuth":[]}],"paths":{"/register":{"post":{"summary":"Registrera en publik API-konsument","description":"Skapar en anonym gratisnyckel direkt utan namn eller e-post. Nyckeln ger 120 anrop per timme per endpoint till all offentlig data.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"scopes":{"type":"array","items":{"type":"string"}},"countryCode":{"type":"string"}}}}}},"responses":{"201":{"description":"API key created"}}}},"/data/{collection}":{"get":{"summary":"Hämta all offentlig data per samling","description":"Samlingar: officials, sources, reports, claims, media, votes, wiki, ai, changes och funding. Fullständiga offentliga fält lämnas ut utan maskning.","parameters":[{"name":"collection","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paginerad offentlig samling"}}}},"/leaderboard":{"get":{"summary":"Hämta pseudonymiserad leaderboard","parameters":[{"name":"window","in":"query","schema":{"type":"string","enum":["weekly","monthly","all-time"]}},{"name":"country","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Leaderboard rows","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/LeaderboardEntry"}}}}}}}}}},"/dashboard":{"get":{"summary":"Hämta realtidsaggregerad myndighetsdashboard","parameters":[{"name":"country","in":"query","schema":{"type":"string"}},{"name":"region","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"period","in":"query","schema":{"type":"string","enum":["7d","30d","90d"]}}],"responses":{"200":{"description":"Dashboard rows","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/DashboardItem"}}}}}}}}}},"/scorecards":{"get":{"summary":"Hämta myndighetsscorecards med reproducerbara formler","parameters":[{"name":"country","in":"query","schema":{"type":"string"}},{"name":"region","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"period","in":"query","schema":{"type":"string","enum":["7d","30d","90d"]}}],"responses":{"200":{"description":"Scorecard rows"}}}},"/access-tiers":{"get":{"summary":"Beskriv publika och premiumorienterade API-nivåer","responses":{"200":{"description":"Available access tiers","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ApiAccessTier"}}}}}}}}}}}}