API

Todo lo que hay en este catálogo se puede consultar por programa. Los metadatos están bajo licencia CC0 y la interfaz es pública: sin registro, sin claves, sin condiciones.

Es el mismo planteamiento del Living Lab de DemIA — recursos digitales abiertos para que investigadores, instituciones y ciudadanía puedan usarlos y experimentar con ellos.

Búsqueda semántica

Recupera las publicaciones más próximas por significado a una pregunta formulada en lenguaje natural, junto con una respuesta redactada a partir de ellas.

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

Parámetros del cuerpo:

Campo	Tipo	Descripción
consulta	texto	La pregunta. Entre 3 y 500 caracteres.
idioma	es o en	Idioma de la respuesta. Por defecto es.
limite	número	Fuentes a recuperar, entre 1 y 12. Por defecto 6.

Ejemplo:

curl -X POST https://hispanoverso-rag.joseadserias.workers.dev/api/buscar \
  -H "Content-Type: application/json" \
  -d '{"consulta":"didáctica del alemán como lengua extranjera","idioma":"es"}'

La respuesta incluye el texto redactado, las fuentes consultadas con su puntuación de proximidad, y el modelo empleado. Cuando ninguna publicación supera el umbral de relevancia, respuesta viene vacía y fuentes es una lista sin elementos: el sistema prefiere no responder antes que responder con material que no viene al caso.

Exportación del corpus

Devuelve todos los registros bibliográficos en un único documento JSON.

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

Recuento del corpus

Composición por tipo documental, idioma, año y eje temático, además de los indicadores de cobertura de metadatos.

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

Sindicación

Las incorporaciones recientes están disponibles como canal RSS en /es/rss.xml y /en/rss.xml.

Límites de uso

La búsqueda semántica admite un número acotado de consultas por minuto y dirección. Para un uso intensivo, conviene partir de la exportación completa del corpus en lugar de encadenar consultas.

Licencia

Los metadatos bibliográficos se publican como CC0: pueden reutilizarse sin restricciones ni atribución obligatoria, aunque la citación de la fuente se agradece.

Los documentos originales conservan la licencia de sus editoriales. Hispanoverso enlaza a ellos pero no los redistribuye.