Polity Atlas
Entwickeln · Offene API v1

API & offene Daten

Jede Entität, Aussage, Quelle und jedes Experiment ist als strukturierte Daten verfügbar. Lesezugriff erfordert keinen Schlüssel; es gelten großzügige Ratenbegrenzungen.

Basis-URLhttps://polityatlas.org/api/v1
LizenzInhalte CC BY-SA 4.0 · Daten ODbL

Authentifizierung

Lesen ist anonym. Schreiben nutzt das Django-Sitzungs-Cookie: einmal GET /auth/csrf abrufen, dann das Token als X-CSRFToken bei POST, PATCH und DELETE senden, mit eingeschlossenen Anmeldedaten.

Paginierung & Fehler

Listen akzeptieren page und page_size und liefern {"items", "count", "page", "page_size"}. Fehler lauten immer {"detail": "…"} mit einem aussagekräftigen Status (400, 401, 403, 404, 409, 422, 429).

Lokalisierung

?lang=ru anhängen (oder Accept-Language senden) für russische Felder; fehlende Übersetzungen fallen auf Englisch zurück.

GET

/entities/{slug}

Liefert eine Entität mit ihren nach Typ gruppierten Relationen, ihren Aussagen samt Belegen und Quellen sowie Bewertungen.

curl "https://polityatlas.org/api/v1/entities/polycentric-law?lang=de"
Antwort · 200
{
  "id": 11,
  "slug": "polycentric-law",
  "kind": "concept",
  "title": "Polycentric law",
  "summary": "Several coexisting centres of rule-making and dispute resolution.",
  "review_state": "published",
  "last_verified_at": "2026-10-02T00:00:00Z",
  "relations": [
    {
      "type": "implements",
      "direction": "incoming",
      "label": "implemented by",
      "items": [{ "entity": { "slug": "arbitration", "kind": "mechanism" } }]
    }
  ],
  "claims": [{
    "id": 318,
    "text": "…",
    "epistemic_status": "disputed",
    "verification_status": "verified",
    "evidence": [{ "stance": "supports", "source": { "id": 41 } }]
  }]
}

Wissen

GET/entitiesFilter: kind, theme, tag, q
GET/entities/{slug}Entität mit Relationen, Aussagen, Bewertungen
GET/entities/{slug}/graphEgo-Netzwerk, Tiefe 1–2
GET/graphGesamter veröffentlichter Graph; kinds, theme
GET/claims/{id}Aussage, Belege, Quellen, offene Streitpunkte
GET/sourcesFilter: type, q, primary
GET/glossaryBegriffe; letter, q
GET/searchq, kind, mode=keyword|semantic
POST/askAntwort ausschließlich aus veröffentlichten Aussagen erstellt

Lebendiger Atlas

GET/experimentsFilter u. a. bbox, autonomy, uses_ai
GET/experiments/geojsonGeoJSON FeatureCollection
GET/experiments/networkNetzwerk-Gemeinwesen und gemeinsame Mechanismen
GET/experiments/facetsAnzahl je Facettenwert

Explorer & Observatorium

GET/criteriaBewertungskriterien
POST/explorer/compareGewichteter Vergleich anhand bekannter Kriterien
GET/observatorykind: signal, news, research, briefing
GET/scenariosTreiber, Indikatoren, Wahrscheinlichkeit in Worten

Polity Lab

GET/lab/optionsKonfigurationsdimensionen und Belastungsszenarien
POST/lab/projects/{id}/analyzeRegelbasierte Konsistenzanalyse
GET/repository/componentsVersionierte Institutionsbausteine
GET/export/entities.jsonlMassenexport, JSON Lines

Ontologie

Das Vokabular, das jeder Datensatz verwendet. Redakteure können das vollständige Schema samt Attributdefinitionen unter /cp/ontology abrufen.

EntitätsartenKonzeptconceptMechanismusmechanismTheorietheoryDenkerthinkerExperimentexperimentInstitutionstypinstitution_typeIdeologieideologyorganisationorganisation
Relationstypensetzt umimplementserprobt intested_invorgeschlagen vonproposed_bybeeinflussteinfluencedkritisiertcriticisesAlternativealternative_toTeil vonpart_ofnutzt Mechanismususes_mechanismverwandt mitrelated_to
Epistemischer StatusGesichertestablishedTheorietheoryUmstrittendisputedHypothesehypothesisPrognoseforecast
PrüfstatusUngeprüftunverifiedKI-Entwurfai_draftedIn Revisionin_reviewGeprüftverifiedAbgelehntrejected
MassenexportDer vollständige Graph als JSON Lines, nächtlich aktualisiert.
GET /export/entities.jsonl