// Open API & widgets

API & widgets

KRIMINIS as open data: 988 villains and 107 criminological theories in JSON, free to use — plus an embeddable widget any site can drop in with one line.

Live demo

Embed the widget

Paste this where you want the card. It shows a villain of the day, links back to KRIMINIS and styles itself — no CSS needed on your side.

Other modes: data-widget="villain-of-the-day" · data-widget="random" · data-widget="theory" data-slug="psicopatia"

The data API

Plain JSON, open CORS, free with attribution. No key needed. Each villain: slug, name, alias, media, type, theory, theorySlug, stats {int, man, vio, emp}, danger, url.

/api/villains.json — 988 villains
/api/theories.json — 107 theories
/api/meta.json — index & counts
/api/expedientes/<id>.json — each villain’s case file, summarised

{
  "id": "walter",
  "slug": "walter-white",
  "name": "Walter White",
  "alias": "Heisenberg",
  "media": "Breaking Bad",
  "type": "Series",
  "theory": "Elección racional",
  "theorySlug": "eleccion-racional",
  "stats": {
    "int": 95,
    "man": 85,
    "vio": 70,
    "emp": 35
  },
  "danger": 79,
  "url": "https://kriminis.com/expediente-walter-white.html"
}

🤖 Using an AI assistant? Connect it to the archive through our MCP server →

The dataset, to research and cite

The whole archive as a citable dataset: 988 villains with their theory, approach and four axes, and 107 theories. CC BY 4.0. Read how we measure before using the scores: they are editorial judgements, not clinical assessments, and real people are scored as a specific work portrays them.

kriminis-villanos.csv — 988 villains · 19 columns
kriminis-teorias.csv — 107 theories
kriminis-dataset.json — both, in JSON
README.md — columns and methodology (in Spanish) · CITATION.cff

Preview: the 5 most dangerous rows of kriminis-villanos.csv
nombre	teoria	inteligencia	manipulacion	violencia	empatia	peligrosidad
Judge Holden	Situational action	98	92	95	1	95
Pablo Escobar	Institutional anomie	88	92	96	10	93
Donquixote Doflamingo	Human ecological systems	88	95	92	10	92
Madara Uchiha	Integrated theory (Elliott)	92	88	95	10	92
All For One	Criminal heredity	93	96	88	3	92

How to cite

Castillo Martín, A. J. (2026). KRIMINIS: fictional villains analysed with criminology (Version 5.0.0) [Data set]. https://kriminis.com/api.html#dataset

@dataset{kriminis_2026_5_0_0,
  author    = {Castillo Martín, Antonio Javier},
  title     = {{KRIMINIS: villanos de ficción analizados con criminología}},
  year      = {2026},
  version   = {5.0.0},
  publisher = {KRIMINIS},
  url       = {https://kriminis.com/api.html#dataset}
}