Polity Atlas
ビルド · オープン API v1

API とオープンデータ

すべてのエンティティ、主張、出典、実験を構造化データとして利用できます。読み取りにキーは不要で、十分に余裕のあるレート制限が適用されます。

ベース URLhttps://polityatlas.org/api/v1
ライセンスコンテンツ CC BY-SA 4.0 · データ ODbL
スキーマ/api/v1/openapi.jsonインタラクティブなドキュメント ↗

認証

読み取りは匿名で行えます。書き込みには Django のセッション Cookie を使います。まず GET /auth/csrf を一度取得し、そのトークンを X-CSRFToken として、認証情報を含めた POST、PATCH、DELETE で送信してください。

ページネーションとエラー

一覧は page と page_size を受け取り、{"items", "count", "page", "page_size"} を返します。エラーは常に {"detail": "…"} の形式で、意味のあるステータス（400、401、403、404、409、422、429）とともに返されます。

ローカライズ

ロシア語のフィールドを取得するには ?lang=ru を付けるか、Accept-Language を送信します。翻訳がない場合は英語にフォールバックします。

GET

/entities/{slug}

種類別にまとめた関係、証拠と出典を伴う主張、評価を含むエンティティを返します。

curl "https://polityatlas.org/api/v1/entities/polycentric-law?lang=ja"
レスポンス · 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 } }]
  }]
}

知識

GET/entitiesフィルター：kind, theme, tag, q
GET/entities/{slug}関係、主張、評価を含むエンティティ
GET/entities/{slug}/graphエゴネットワーク、深さ 1–2
GET/graph公開済みのグラフ全体；kinds, theme
GET/claims/{id}主張、証拠、出典、未解決の争点
GET/sourcesフィルター：type, q, primary
GET/glossary用語；letter, q
GET/searchq, kind, mode=keyword|semantic
POST/ask公開済みの主張のみから構成した回答

生きたアトラス

GET/experimentsbbox、autonomy、uses_ai を含むフィルター
GET/experiments/geojsonGeoJSON FeatureCollection
GET/experiments/networkネットワーク型政治共同体と共有される仕組み
GET/experiments/facetsファセット値ごとの件数

エクスプローラーとオブザーバトリー

GET/criteria評価基準
POST/explorer/compare既知の基準に基づく加重比較
GET/observatorykind：signal, news, research, briefing
GET/scenarios推進要因、指標、言葉で表した可能性

Polity Lab

GET/lab/options構成の次元とストレスシナリオ
POST/lab/projects/{id}/analyzeルールに基づく整合性分析
GET/repository/componentsバージョン管理された制度コンポーネント
GET/export/entities.jsonl一括エクスポート、JSON Lines

オントロジー

すべてのレコードが用いる語彙です。編集者は、属性定義を含む完全なスキーマを /cp/ontology から取得できます。

エンティティの種類概念concept仕組みmechanism理論theory思想家thinker実験experiment制度の類型institution_typeイデオロギーideologyorganisationorganisation
関係の種類実装するimplements検証された場tested_in提唱者proposed_by影響を与えたinfluenced批判するcriticises代替案alternative_to一部part_of仕組みを用いるuses_mechanism関連先related_to
認識的ステータス確立established理論theory争点ありdisputed仮説hypothesis予測forecast
確認ステータス未確認unverifiedAI 起草ai_draftedレビュー中in_review確認済みverified却下rejected
一括エクスポートグラフ全体を JSON Lines 形式で提供し、毎晩更新します。
GET /export/entities.jsonl