API

Everything in this catalogue can be queried programmatically. Metadata is CC0 and the interface is public: no registration, no keys, no conditions.

This follows the approach of the DemIA Living Lab — open digital resources so that researchers, institutions and the public can use them and experiment with them.

Semantic search

Retrieves the publications closest in meaning to a plain-language question, along with an answer composed from them.

POST https://hispanoverso-rag.joseadserias.workers.dev/api/buscar
Content-Type: application/json

Body parameters:

Field	Type	Description
`consulta`	string	The question. Between 3 and 500 characters.
`idioma`	`es` or `en`	Answer language. Defaults to `es`.
`limite`	number	Sources to retrieve, 1 to 12. Defaults to 6.

Example:

curl -X POST https://hispanoverso-rag.joseadserias.workers.dev/api/buscar \
  -H "Content-Type: application/json" \
  -d '{"consulta":"teaching German as a foreign language","idioma":"en"}'

The response includes the composed text, the sources consulted with their proximity scores, and the model used. When no publication clears the relevance threshold, respuesta comes back empty and fuentes is an empty list: the system prefers not to answer rather than answer from material that doesn’t fit.

Corpus export

Returns every bibliographic record in a single JSON document.

GET https://hispanoverso-ingesta.joseadserias.workers.dev/exportar

Corpus summary

Composition by document type, language, year and thematic axis, plus metadata coverage indicators.

GET https://hispanoverso-ingesta.joseadserias.workers.dev/resumen

Syndication

Recent additions are available as RSS at /es/rss.xml and /en/rss.xml.

Usage limits

Semantic search accepts a bounded number of queries per minute per address. For heavy use, start from the full corpus export rather than chaining queries.

Licence

Bibliographic metadata is published as CC0: reusable without restriction or required attribution, though citing the source is appreciated.

Original documents retain their publishers’ licences. Hispanoverso links to them but does not redistribute them.