Polity Atlas
Desarrollo · API abierta v1

API y datos abiertos

Cada entidad, afirmación, fuente y experimento está disponible como datos estructurados. La lectura no requiere clave; se aplican límites de uso generosos.

URL basehttps://polityatlas.org/api/v1
LicenciaContenido CC BY-SA 4.0 · Datos ODbL

Autenticación

La lectura es anónima. La escritura usa la cookie de sesión de Django: obtenga GET /auth/csrf una vez y envíe el token como X-CSRFToken en POST, PATCH y DELETE, incluyendo las credenciales.

Paginación y errores

Las listas aceptan page y page_size y devuelven {"items", "count", "page", "page_size"}. Los errores son siempre {"detail": "…"} con un estado significativo (400, 401, 403, 404, 409, 422, 429).

Localización

Añada ?lang=ru (o envíe Accept-Language) para obtener los campos en ruso; las traducciones que falten se sustituyen por el inglés.

GET

/entities/{slug}

Devuelve una entidad con sus relaciones agrupadas por tipo, sus afirmaciones con evidencia y fuentes, y las valoraciones.

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

Conocimiento

GET/entitiesFiltros: kind, theme, tag, q
GET/entities/{slug}Entidad con relaciones, afirmaciones y valoraciones
GET/entities/{slug}/graphRed egocéntrica, profundidad 1–2
GET/graphTodo el grafo publicado; kinds, theme
GET/claims/{id}Afirmación, evidencia, fuentes y disputas abiertas
GET/sourcesFiltros: type, q, primary
GET/glossaryTérminos; letter, q
GET/searchq, kind, mode=keyword|semantic
POST/askRespuesta construida solo a partir de afirmaciones publicadas

Atlas Vivo

GET/experimentsFiltros, incl. bbox, autonomy, uses_ai
GET/experiments/geojsonGeoJSON FeatureCollection
GET/experiments/networkEntidades políticas en red y mecanismos compartidos
GET/experiments/facetsRecuentos por valor de faceta

Explorador y Observatorio

GET/criteriaCriterios de valoración
POST/explorer/compareComparación ponderada según criterios conocidos
GET/observatorykind: signal, news, research, briefing
GET/scenariosFactores, indicadores y probabilidad expresada en palabras

Polity Lab

GET/lab/optionsDimensiones de configuración y escenarios de prueba bajo tensión
POST/lab/projects/{id}/analyzeAnálisis de coherencia basado en reglas
GET/repository/componentsComponentes institucionales versionados
GET/export/entities.jsonlExportación masiva, JSON Lines

Ontología

El vocabulario que usa cada registro. Los editores pueden obtener el esquema completo, con las definiciones de atributos, desde /cp/ontology.

Tipos de entidadConceptoconceptMecanismomechanismTeoríatheoryPensadorthinkerExperimentoexperimentTipo de institucióninstitution_typeIdeologíaideologyorganisationorganisation
Tipos de relaciónimplementaimplementspuesto a prueba entested_inpropuesto porproposed_byinfluyó eninfluencedcritica acriticisesalternativaalternative_toparte depart_ofusa el mecanismouses_mechanismrelacionado conrelated_to
Estado epistémicoEstablecidoestablishedTeoríatheoryDisputadodisputedHipótesishypothesisPronósticoforecast
Estado de verificaciónSin verificarunverifiedRedactado por IAai_draftedEn revisiónin_reviewVerificadoverifiedRechazadorejected
Exportación masivaEl grafo completo en JSON Lines, actualizado cada noche.
GET /export/entities.jsonl