DESARROLLADORES

API REST

Endpoints disponibles para el corpus Tomo Mi cuerpo es la verdad, sección mujeres - Informe Final de la Comisión de la Verdad de Colombia. Todos los endpoints devuelven JSON y no requieren autenticación.

Base URLhttp://localhost:3000

GET/api/v1/corpora

Lista todos los corpus activos con sus contadores básicos.

GET/api/v1/corpora/tdg-betancur-villegas-2025

Detalle completo del corpus: estadísticas, principios FAIR, licencia, autores y cómo citar.

GET/api/v1/corpora/tdg-betancur-villegas-2025/expressions

Lista paginada de expresiones metafóricas del corpus.

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
`limit`	integer	No	Número de resultados (default 20, max 100)
`offset`	integer	No	Desplazamiento para paginación
`metafora`	string	No	Filtro parcial por nombre de metáfora
`dominio_fuente`	string	No	Filtro por nombre de dominio fuente
`dominio_meta`	string	No	Filtro por nombre de dominio meta
`tipologia`	string	No	Filtro por tipología
`cat_gramatical`	string	No	Filtro por categoría gramatical
`fuente`	string	No	Filtro por fuente textual
`sort`	orden\|id	No	Campo de ordenamiento
`order`	asc\|desc	No	Dirección de ordenamiento

GET/api/v1/corpora/tdg-betancur-villegas-2025/expressions/:id

Detalle completo de una expresión metafórica por su UUID.

GET/api/v1/corpora/tdg-betancur-villegas-2025/metaphors

Lista paginada de metáforas conceptuales del corpus.

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
`limit`	integer	No	Número de resultados (default 20, max 100)
`offset`	integer	No	Desplazamiento para paginación
`dominio_fuente`	string	No	Filtro por nombre de dominio fuente
`dominio_meta`	string	No	Filtro por nombre de dominio meta
`tipologia`	string	No	Filtro por tipología (usar OTRA para metáforas sin tipología)
`cat_gramatical`	string	No	Filtro por categoría gramatical del foco

GET/api/v1/corpora/tdg-betancur-villegas-2025/metaphors/:id

Detalle de una metáfora conceptual: estadísticas, correspondencias y muestra de expresiones.

GET/api/v1/corpora/tdg-betancur-villegas-2025/metaphors/:id/expressions

Expresiones asociadas a una metáfora conceptual (paginadas).

GET/api/v1/corpora/tdg-betancur-villegas-2025/metaphors/:id/related

Metáforas relacionadas por dominios compartidos o adyacentes.

GET/api/v1/corpora/tdg-betancur-villegas-2025/domains

Lista de dominios semánticos del corpus con frecuencia y nivel jerárquico.

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
`tipo`	fuente\|meta	No	Filtrar por tipo de dominio

GET/api/v1/corpora/tdg-betancur-villegas-2025/domain-relations

Relaciones semánticas entre dominios (hiperonimia, hiponimia, meronimia, etc.).

GET/api/v1/corpora/tdg-betancur-villegas-2025/stats/typologies

Distribución de tipologías del corpus con conteo de expresiones por tipología.

GET/api/v1/corpora/tdg-betancur-villegas-2025/grammatical-categories

Categorías gramaticales presentes en el corpus con conteo de expresiones.

GET/api/v1/corpora/tdg-betancur-villegas-2025/stats/density

Densidad metafórica por orden: distribución de expresiones en buckets según posición en texto.

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
`bucket`	integer	No	Tamaño del bucket (default 100, min 10, max 1000)

GET/api/v1/corpora/tdg-betancur-villegas-2025/stats/proximity

Datos para scatter plot de proximidad textual: expresiones cercanas en el texto.

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
`range`	integer	No	Ventana de proximidad (default 50, min 10, max 200)
`limit`	integer	No	Máximo de puntos (default 1000, min 100, max 5000)

GET/api/v1/corpora/tdg-betancur-villegas-2025/stats/domain-matrix

Matriz de co-ocurrencia dominio fuente × dominio meta para heatmap.

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
`minCount`	integer	No	Mínimo de expresiones (default 1, min 1, max 100)
`limit`	integer	No	Máximo de dominios (default 50, min 10, max 100)

Notas de uso

Todas las respuestas tienen la forma { "data": { ... } }.
Los listados incluyen total, limit, offset e items.
Los errores devuelven { "error": "mensaje" } con código HTTP apropiado.
La documentación interactiva OpenAPI está disponible en http://localhost:3000/api/v1/openapi.json.