Polity Atlas
Разработчикам · Открытый API v1

API и открытые данные

Каждая статья, утверждение, источник и эксперимент доступны как структурированные данные. Для чтения ключ не нужен; лимиты щедрые.

Базовый URLhttps://polityatlas.org/api/v1
ЛицензияТексты CC BY-SA 4.0 · Данные ODbL

Аутентификация

Чтение анонимно. Запись использует сессионную cookie Django: один раз запросите GET /auth/csrf, затем отправляйте токен в заголовке X-CSRFToken в POST, PATCH и DELETE с credentials.

Пагинация и ошибки

Списки принимают 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=ru"
Ответ · 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Окрестность в графе, depth 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/experimentsФильтры, включая bbox, 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
Статус проверкиНе провереноunverifiedЧерновик ИИai_draftedНа проверкеin_reviewПровереноverifiedОтклоненоrejected
Полная выгрузкаВесь граф в формате JSON Lines, обновляется ежедневно.
GET /export/entities.jsonl