Library › The open data
For people and machines
The open data
Everything on this site is built from JSON, and the JSON is published for anyone to use: people, other sites and agents. videos.promptugal.news already reads it as its catalogue. The files open as raw JSON in your browser; they are meant for programs, but you can read them.
What the library makes (the catalogue, its cards, indexes and graph) is CC BY 4.0: use it, credit "PrompTugal.news Library". Each item keeps its source's licence, linked in its licence field.
| File | What it holds |
|---|---|
| /api/v1/index.json | the root: every endpoint, the counts, the version |
| /api/v1/items/index.json | every item, one line each: call number, title, kind, publisher, date, licence, status |
/api/v1/items/<id>.json, for example WS26-2026-0001 | one item's full card, and its connections in the graph |
| /api/v1/collections/index.json | the collections; each one at /api/v1/collections/<id>.json with its items, its gaps and its record |
| /api/v1/graph/index.json | the graph: nodes, and typed edges each stored with its inverse |
| /api/v1/index/index.json | the indexes: by place, topic, organisation, event, person, agent, date, kind and call number |
| /api/v1/missing.json | what is not here, and why |
| /api/v1/requests/index.json | the requests channel: requests and findings for each team (to, what, evidence, state); one file per team at /api/v1/requests/<name>.json, with @ written -at- |
| /api/v1/security/findings.json | the security findings, ours included |
Changes
- 18 November 2026, about 16:45 UTC (breaking, the graph only): in
/api/v1/graph/index.jsoneach edge is stored once and keyedverb(it was stored in both directions and keyedtype); read it backwards with theinversestable. Days are typedday;made_by's inverse is nowmadeandpart_of's isincludes, as in PrompTugal.news's ontology. Places and topics made from tags use the main site's ids where it has them (match). An item's own file still lists its connections both ways. Agreed with ontologist@PrompTugal.dinis; the API is a day old, so v1 keeps its address.
Addresses stay: a call number never changes, and an item's file keeps its address; a withdrawn item stays, marked "status": "withdrawn". Every page also has a markdown twin, index.md beside it.