Polity Atlas
Desenvolver · API aberta v1

API e dados abertos

Toda entidade, afirmação, fonte e experimento está disponível como dados estruturados. A leitura não exige chave; aplicam-se limites de requisições generosos.

URL basehttps://polityatlas.org/api/v1
LicençaConteúdo CC BY-SA 4.0 · Dados ODbL

Autenticação

A leitura é anônima. A escrita usa o cookie de sessão do Django: busque GET /auth/csrf uma vez e envie o token como X-CSRFToken em POST, PATCH e DELETE, com as credenciais incluídas.

Paginação e erros

As listas aceitam page e page_size e retornam {"items", "count", "page", "page_size"}. Os erros são sempre {"detail": "…"} com um status significativo (400, 401, 403, 404, 409, 422, 429).

Localização

Adicione ?lang=ru (ou envie Accept-Language) para obter os campos em russo; traduções ausentes recorrem ao inglês.

GET

/entities/{slug}

Retorna uma entidade com suas relações agrupadas por tipo, suas afirmações com evidências e fontes, e avaliações.

curl "https://polityatlas.org/api/v1/entities/polycentric-law?lang=pt"
Resposta · 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 } }]
  }]
}

Conhecimento

GET/entitiesFiltros: kind, theme, tag, q
GET/entities/{slug}Entidade com relações, afirmações e avaliações
GET/entities/{slug}/graphRede egocêntrica, profundidade 1–2
GET/graphGrafo publicado completo; kinds, theme
GET/claims/{id}Afirmação, evidências, fontes e contestações em aberto
GET/sourcesFiltros: type, q, primary
GET/glossaryTermos; letter, q
GET/searchq, kind, mode=keyword|semantic
POST/askResposta construída apenas a partir de afirmações publicadas

Atlas Vivo

GET/experimentsFiltros, incluindo bbox, autonomy, uses_ai
GET/experiments/geojsonGeoJSON FeatureCollection
GET/experiments/networkEntidades políticas em rede e mecanismos compartilhados
GET/experiments/facetsContagens por valor de faceta

Explorador e Observatório

GET/criteriaCritérios de avaliação
POST/explorer/compareComparação ponderada segundo critérios conhecidos
GET/observatorykind: signal, news, research, briefing
GET/scenariosFatores determinantes, indicadores e probabilidade em palavras

Polity Lab

GET/lab/optionsDimensões de configuração e cenários de estresse
POST/lab/projects/{id}/analyzeAnálise de consistência baseada em regras
GET/repository/componentsComponentes institucionais versionados
GET/export/entities.jsonlExportação em massa, JSON Lines

Ontologia

O vocabulário usado por todos os registros. Os editores podem obter o esquema completo, incluindo as definições de atributos, em /cp/ontology.

Tipos de entidadeConceitoconceptMecanismomechanismTeoriatheoryPensadorthinkerExperimentoexperimentTipo de instituiçãoinstitution_typeIdeologiaideologyorganisationorganisation
Tipos de relaçãoimplementaimplementstestado emtested_inproposto porproposed_byinfluenciouinfluencedcriticacriticisesalternativaalternative_toparte depart_ofusa o mecanismouses_mechanismrelacionado arelated_to
Status epistêmicoEstabelecidoestablishedTeoriatheoryContestadodisputedHipótesehypothesisPrevisãoforecast
Status de verificaçãoNão verificadounverifiedRedigido por IAai_draftedEm revisãoin_reviewVerificadoverifiedRejeitadorejected
Exportação em massaO grafo completo em JSON Lines, atualizado toda noite.
GET /export/entities.jsonl