Desarrolladores

Construye sobre el museo: un grafo abierto y con fuentes de la historia islámica, como enlaces, como widgets y como datos que tus sistemas pueden leer. Sin clave, sin tarifa, sin permiso que pedir.

Todo lo que el museo publica para los lectores también se publica para las máquinas. Cada registro (persona, lugar, edificio, obra, acontecimiento) tiene una página web permanente y un gemelo JSON en una dirección estable, y toda la colección se sirve como un único grafo conectado: registros (nodos) y las relaciones con fuentes entre ellos (aristas).

No hay clave de API, ni cuenta, ni tarifa. Los datos subyacentes son CC0 1.0: de dominio público, para que los descargues, los conserves y construyas sobre ellos. Los artículos escritos son CC BY-SA 4.0, como en Wikipedia. Si tu sistema puede abrir una dirección web, puede leer el museo.

La colección viva en esta versión: 87.800 registros · 116.968 conexiones con fuentes · 26 clases de registro · 1873 esbozos, nombrados por otros registros y aún no escritos.

Qué lo hace diferente

Muchas colecciones guardan piezas del pasado islámico. La afirmación del museo es más acotada y, creemos, sin igual en su combinación; no se conoce ninguna combinación comparable:

Un grafo, todas las superficies

El museo no es un sitio web con una API añadida. Su forma primaria es un único grafo de conocimiento (los registros como datos estructurados, los artículos como texto) guardado en un repositorio git público. El sitio web, esta API, la búsqueda, la línea de tiempo, las inserciones y el ala infantil son todos representaciones de ese único grafo. Corrige un hecho una vez y se corrigen todas las superficies.

Las fuentes dentro de la estructura

En la mayoría de los conjuntos de datos la evidencia vive en notas a pie de página. Aquí vive en el modelo de datos: las conexiones llevan las fuentes en las que se apoyan, los resúmenes llevan sus citas, y los puntos controvertidos conservan sus lecturas, etiquetadas en lugar de aplanadas. Puedes consultar no solo lo que dice el museo, sino en qué se apoya.

Primero el árabe, tres ediciones en todo

El grafo se escribe primero en árabe (las etiquetas y los resúmenes en árabe son el original, no una traducción), con ediciones completas en inglés y urdu de todo, tanto de los registros como de la interfaz. La mayoría de las colecciones de este campo están en inglés con traducciones, o solo en árabe.

Catorce siglos, una red conectada

Veintidós clases (personas, lugares, edificios, objetos, libros, pasajes coránicos y de hadices, conceptos, acontecimientos, viajes) comparten un grafo, de modo que una pregunta puede viajar de un erudito a un libro, a sus manuscritos, a una ciudad, a un siglo. Las enciclopedias dividen todo esto por disciplina y por volumen; el grafo lo cruza.

El tiempo como dato, en dos calendarios

Las fechas son valores estructurados en EDTF, el estándar bibliotecario para fechas históricas, con los años hegíricos registrados junto a los gregorianos, de modo que las líneas de tiempo, los siglos y los aniversarios se calculan a partir de los datos, no se escriben página por página.

Abierto en cada capa y reproducible

Datos CC0, prosa CC BY-SA, código MIT: sin clave, sin rastreo, sin servidor que responda a cada visitante; el sitio son archivos estáticos, y el conjunto de datos completo son dos descargas. Cualquier institución puede replicar todo el museo, verificarlo de forma independiente y reconstruir sobre él. No se retiene nada para hacerte depender de este sitio web.

Otros son más grandes en una dimensión: una enciclopedia mayor, un corpus de texto único más profundo, un grafo más amplio sin prosa y sin curación. Lo que no existe en otro lugar, hasta donde sabemos, es la combinación: un grafo con fuentes, primero en árabe y con licencia abierta de todo el pasado islámico, publicado como un museo que cualquiera puede leer, consultar, insertar y llevarse.

Tres formas de entrar, desde una tarde hasta una plataforma

Elige la profundidad que convenga a tu institución. Cada nivel incluye todo lo anterior.

Nivel 1: Enlázalo

Añade el museo a tu catálogo y a tu lista de recursos electrónicos, y enlaza en profundidad a cualquier registro: cada dirección de página es permanente, en árabe, inglés y urdu. El equipo de las colecciones asiáticas y africanas de la Biblioteca Británica está en contacto con el museo sobre este paso. Cero trabajo de desarrollo.

Nivel 2: Insértalo

Pon un fragmento vivo del museo en tus propias páginas con un solo fragmento de HTML: una tarjeta de dato y un itinerario guiado de la semana, en cualquiera de los tres idiomas. El contenido se actualiza de nuestra parte; tu página solo lo enmarca.

Nivel 3: Construye sobre los datos

Descarga el propio grafo (cada registro y cada conexión con fuentes como archivos JSON sencillos) y construye encima tu propia búsqueda, exposiciones, recursos escolares o herramientas de investigación. CC0 significa que la copia es tuya por completo; la fuente viva sigue creciendo y corrigiéndose, y puedes volver a sincronizar cuando quieras.

Endpoints

Toda dirección empieza por https://api.islam.museum/api/v1/ (ese prefijo no es una página en sí; la puerta de entrada es https://api.islam.museum/api/v1/index.json). Las mismas rutas en islam.museum redirigen aquí. Son solicitudes HTTPS GET sencillas; las respuestas son JSON, o NDJSON (un objeto JSON por línea) para los dos archivos del grafo, de modo que se puedan procesar como flujo. CORS está abierto (Access-Control-Allow-Origin: *), así que los navegadores pueden llamar a la API directamente.

EndpointQué devuelve
https://api.islam.museum/api/v1/index.jsonLa puerta de entrada: qué contiene esta API, sus archivos y carpetas, y dónde está su descripción OpenAPI.
https://api.islam.museum/api/v1/meta/index.jsonEl índice de la API: versión, las 22 clases de registro y las licencias en formato legible por máquina.
https://api.islam.museum/api/v1/meta/coverage.jsonTotales en vivo: cuántos registros existen y cuántos por clase.
https://api.islam.museum/api/v1/{class}/index.jsonTodos los registros de una clase en un único arreglo JSON; por ejemplo, las 10.884 personas.
https://api.islam.museum/api/v1/{class}/{slug}.jsonUn registro completo: etiquetas y resúmenes en tres idiomas, sus datos estructurados, sus fuentes y sus conexiones precalculadas.
https://api.islam.museum/api/v1/graph/nodes.ndjsonLos registros y esbozos de todo el grafo, un objeto JSON por línea (89.673 líneas).
https://api.islam.museum/api/v1/graph/edges.ndjsonCada conexión entre registros, una por línea (116.968); cada una lleva las fuentes en las que se apoya.
https://islam.museum/{lang}/embed/fact/ · /{lang}/embed/trail-of-the-week/Widgets insertables para tus propias páginas: una tarjeta de dato y el itinerario de la semana, en árabe, inglés o urdu.
https://doi.org/10.5281/zenodo.23692511El conjunto de datos archivado en Zenodo, con un DOI permanente para citarlo: 10.5281/zenodo.23692511.

Consultas de ejemplo, con resultados reales

Todo lo que sigue lo devolvió la API en vivo en noviembre de 2026, recortado solo por extensión.

¿Qué tamaño tiene la colección?

GET https://api.islam.museum/api/v1/meta/coverage.json

{
  "entities": 47718,
  "stubs": 1852,
  "byClass": { "person": 10884, "passage": 10079, "source": 7599,
               "building": 5664, "event": 4960, … }
}

Un registro completo

GET https://api.islam.museum/api/v1/person/ibn-khaldun.json

{
  "id": "person/ibn-khaldun",
  "class": "person",
  "slug": "ibn-khaldun",
  "label":   { "ar": "ابن خلدون", "en": "Ibn Khaldun" },
  "summary": { "ar": "عبد الرحمن بن محمد بن خلدون الحضرمي، مؤلف المقدمة…", … },
  "data":        { … the full structured record … },
  "connections": [ … ],
  "license":     { … }
}

Los archivos del grafo: un nodo y algunas aristas

// one line of graph/nodes.ndjson — a record (a node)
{"id":"building/99-domes-mosque","class":"building",
 "label":{"ar":"مسجد القباب التسع والتسعون","en":"99 Domes Mosque, Makassar"},
 "summary":{"ar":"…","en":"…"},"wings":["objects"],
 "regions":["southeast-asia"],"wikidata":"Q116827711","status":"draft"}

// two lines of graph/edges.ndjson — connections (edges), each with its sources
{"from":"person/muhammad-ali-jauhar","to":"person/abadi-bano-begum",
 "type":"child_of","inverse":false,
 "sources":["source/wikipedia-abadi-bano-begum-en","source/wikipedia-abadi-bano-begum-ur"]}
{"from":"person/a-k-fazlul-huq","to":"place/dhaka","type":"died_in","inverse":false,
 "sources":["source/wikipedia-a-k-fazlul-huq-en","source/wikipedia-a-k-fazlul-huq-ar",
            "source/wikidata-a-k-fazlul-huq"]}

Recorriendo el grafo (Python): ¿con quién estaba conectado Muhammad Ali Jauhar?

Muhammad Ali Jauhar
child_of -> Abadi Bano Begum | sources: 2

Las respuestas se recortan con … donde continúan.

Esquema

Dos formas cubren casi todo: el nodo (un registro, en los archivos del grafo y los índices de clase) y la arista (una conexión). La respuesta de un solo registro añade los datos estructurados completos del registro y su vecindad precalculada.

Nodo: un registro

CampoTipoSignificado
idstringEl identificador permanente del registro, class/slug.
classstringUna de las 24 clases: person, place, building, work, event, passage, source, invention, award…
label{ ar, en, ur }El nombre del registro en árabe, inglés y urdu, según disponibilidad.
summary{ ar, en, ur }Un resumen breve con fuentes en hasta tres idiomas.
wingsstring[]A cuál de las nueve alas del museo pertenece el registro (un registro puede estar en varias).
regionsstring[]Regiones geográficas a las que pertenece el registro.
statusstringpublished, o draft (incorporado, aún en proceso de enriquecimiento). Los esbozos no llevan estado.
wikidatastring (QID)El identificador de Wikidata del registro (QID), cuando existe; úsalo para cotejar registros con tu propio catálogo.
born · died · dateEDTF stringCampos de fecha donde correspondan (nacimiento, muerte o una sola fecha) como valores EDTF.

Arista: una conexión

CampoTipoSignificado
fromstring (id)El registro del que parte la conexión (un id).
tostring (id)El registro al que apunta (un id).
typestringEl tipo de conexión: uno de 55 tipos (véase abajo).
inversebooleanSi esta arista es la lectura inversa de una relación almacenada.
sourcesstring[] (ids)Las fuentes en las que se apoya esta conexión; toda arista tiene fuentes.

Registro individual: la forma completa

La respuesta de un solo registro lleva estas claves: id, class, slug, label, summary, stub, wings, regions, periods, tags, aliases, themes, span, display, data, prose, degree, contemporaries, updated, connections, related, license. La clave data contiene el contenido estructurado completo del registro (fechas, lugares, ocupaciones, fe cuando está atestiguada, y más); connections y related son su vecindad precalculada en el grafo; degree es su número de conexiones.

Hay 55 tipos de conexión. Los más frecuentes: part_of (9.845), mentions (9.504), participated_in (5.317), basis_for (3.749), occurred_at (2.120), about (1.825), died_in (750), member_of (726), born_in (608), child_of (570). Las fechas usan EDTF (el Formato Extendido de Fecha/Hora, ISO 8601-2, el estándar de bibliotecas y archivos para fechas históricas), con los años hegíricos registrados junto a los gregorianos.

Una clase que merece nombrarse: job

La clase job es la taxonomía de oficios y profesiones del museo: 19 registros hoy, cada uno con su dominio, su tipo, si era un oficio gremial (hirfa), su época y primera atestación con fuentes, sus lugares, su organización y su formación. Obtén toda la taxonomía en /api/v1/job/index.json, o un oficio en /api/v1/job/{slug}.json. Las ocupaciones aún no están integradas en el grafo como aristas (las personas las llevan dentro de sus propios registros), así que esa integración está en la hoja de ruta, y el registro de cambios lo anotará cuando llegue.

Una clase que merece nombrarse: invention

La clase invention registra invenciones y descubrimientos con su dominio, tipo, época y primera atestación, sus artífices con roles documentados, la afirmación de atribución y su base, lo que vino antes y lo que se construyó sobre ellas, y su imagen y diagrama. Obtén todos los registros en /api/v1/inventions.json, las cadenas en /api/v1/inventions/chains.json, o un registro en /api/v1/invention/{slug}.json. El explorador para personas está en /en/inventions/.

Código de ejemplo

Los tres patrones que necesitan la mayoría de las integraciones. Todos se ejecutan contra la API en vivo tal como están escritos.

JavaScript

// Fetch one full record — no key needed, CORS is open.
const res = await fetch("https://api.islam.museum/api/v1/person/ibn-khaldun.json");
const rec = await res.json();

console.log(rec.id);          // "person/ibn-khaldun"
console.log(rec.label.en);    // "Ibn Khaldun"
console.log(rec.label.ar);    // "ابن خلدون"
console.log(rec.summary.en);  // short sourced biography (also .ar / .ur)

Python

import json, urllib.request

BASE = "https://api.islam.museum/api/v1"

def lines(url):
    with urllib.request.urlopen(url) as r:
        for raw in r:
            if raw.strip():
                yield json.loads(raw)

# 89673 records and stubs, 116968 sourced connections
nodes = {n["id"]: n for n in lines(f"{BASE}/graph/nodes.ndjson")}
edges = list(lines(f"{BASE}/graph/edges.ndjson"))

person = "person/muhammad-ali-jauhar"
print(nodes[person]["label"]["en"])          # Muhammad Ali Jauhar
for e in edges:
    if e["from"] == person:                  # everything he connects to
        other = nodes.get(e["to"], {})
        name = other.get("label", {}).get("en", e["to"])
        print(e["type"], "->", name, "| sources:", len(e["sources"]))

HTML — embeds

<!-- "Fact" card, Arabic (use /en/ or /ur/ for the other editions) -->
<iframe src="https://islam.museum/ar/embed/fact/"
        width="360" height="220" style="border:0" loading="lazy"
        title="islam.museum — fact"></iframe>

<!-- "Trail of the week" — a guided path through connected records -->
<iframe src="https://islam.museum/ar/embed/trail-of-the-week/"
        width="360" height="480" style="border:0" loading="lazy"
        title="islam.museum — trail of the week"></iframe>

Shell — the whole dataset

# The two graph files are the complete museum data (CC0 — keep them, reuse them):
curl -O https://api.islam.museum/api/v1/graph/nodes.ndjson
curl -O https://api.islam.museum/api/v1/graph/edges.ndjson

# Or fetch the archived preservation copy by its DOI:
open "https://doi.org/10.5281/zenodo.23692511"

Empieza con un agente de IA

Entrega uno de estos prompts a tu asistente de programación (Claude, Devin, Copilot o cualquier otro) junto con la dirección de esta página. Cada prompt es autocontenido: nombra los endpoints, la licencia y el resultado que se debe producir. Los prompts se dan en inglés, como texto de trabajo.

Prompt 1 — Add museum widgets to our library portal

You are helping a public library add islam.museum content to its website.
The museum offers two embeddable widgets, no API key needed:
  https://islam.museum/ar/embed/fact/              (a daily fact card)
  https://islam.museum/ar/embed/trail-of-the-week/ (a guided trail)
Task: create a self-contained HTML page section that embeds both widgets
in iframes (Arabic by default, with a small ar/en/ur switcher that swaps
the iframe language), keeps our existing layout intact on phone, tablet
and desktop, adds no cookies or tracking, and shows a plain link to
https://islam.museum if an iframe fails to load. Data licence: CC0.
Prompt 2 — Build catalogue entries from the open data

You are a library systems developer. islam.museum publishes every record
as JSON, no key needed: https://api.islam.museum/api/v1/{class}/{slug}.json for one
record, https://api.islam.museum/api/v1/{class}/index.json for a whole class (22 classes).
Task: write a script that downloads the person index and produces a CSV
for our catalogue with one row per published person: id, label (ar, en,
ur), one-line summary (en), canonical page URL
https://islam.museum/en/person/{slug}/, and the Wikidata QID where the
record has one. Skip records whose status is not "published". Data is
CC0 1.0; add the credit line "Data: islam.museum (CC0)" to the output.
Prompt 3 — Answer questions from the graph, with sources

You are a data analyst. Download the museum's graph (CC0, no key):
  https://api.islam.museum/api/v1/graph/nodes.ndjson  (one record per line)
  https://api.islam.museum/api/v1/graph/edges.ndjson  (one connection per line; each lists sources)
Task: load both files and answer, as a sourced table: which people are
connected to person/ibn-khaldun, by what type of connection, and which
sources support each connection? Then generalise your code so a librarian
can ask the same question for any record id. Never state a connection the
edges file does not contain; report the source ids with every row.
Prompt 4 — A local mirror with search, for our reading rooms

You are a web developer. islam.museum's full dataset is CC0 and published
as two NDJSON files (nodes and edges) at https://api.islam.museum/api/v1/graph/.
Task: build a small static website we can host ourselves that loads a
local copy of nodes.ndjson and offers fast search and filters by class,
region and century, in Arabic and English. Every result links back to the
record's canonical page on islam.museum. The site must work offline once
the data file is downloaded, use no tracking, and credit
"Data: islam.museum (CC0)" in the footer.

Cuánto queda: por qué importa la fuente viva

De los 87.800 registros de esta versión, 28.737 están publicados; los otros 59.063 son borradores aún en proceso de enriquecimiento, y 1873 más son esbozos a la espera de su construcción completa. Una descarga hoy es una fotografía de un taller, no de las estanterías terminadas.

Más allá de eso, el propio mapa de carencias del museo nombra los corpus aún no recopilados: la enciclopedia turca DİA (~16.800 artículos, hasta ahora usados solo para registros sueltos), el diccionario de 57 volúmenes de Nadwi sobre mujeres eruditas del hadiz (~9.000–10.000 maestras, casi ninguna aún en el museo), los grandes diccionarios de transmisores detrás del grafo de transmisores de hadices, el atraso de la Enciclopedia del Islam, un censo de manuscritos y de las bibliotecas que los guardan, y barridos regionales por el Sudeste Asiático, África, China y las Américas que apenas han comenzado. Solo tres diccionarios nombrados contienen unas 36.000 entradas más de las que el museo tiene registros hoy.

Así que toma los datos: para eso están. Pero construye contra la fuente viva donde puedas: corrige errores a medida que los eruditos los comunican, añade miles de registros al mes y mantiene una dirección canónica para todo. La copia es una instantánea; el museo es el jardín.

Lo que aún no está aquí

Dicho con claridad, para que tu planificación se apoye en hechos: todavía no hay documento OpenAPI/Swagger, ni endpoint SPARQL, ni exportación OAI-PMH o MARC. La taxonomía de oficios se sirve como registros pero aún no está integrada en el grafo como aristas, y los registros llevan identificadores de Wikidata pero aún sin búsqueda por QID. Las formas JSON de arriba son estables y están versionadas (v1 en cada dirección), y el índice meta anuncia la versión y las licencias. La documentación formal de la API y las exportaciones de estándar bibliotecario están en la hoja de ruta.

Licencia, cita y contacto

Datos: CC0 1.0, sin necesidad de permiso; se agradece una línea de crédito como «Datos: islam.museum (CC0)». Artículos: CC BY-SA 4.0, reutilización con crédito. Código: MIT. Para citar, el DOI del conjunto de datos es 10.5281/zenodo.23692511. El museo es una iniciativa personal y sin ánimo comercial, ofrecida gratis a bibliotecas, escuelas y lectores de todas partes; preguntas, correcciones y colaboración: discover@islam.museum.