GET /api/obrasReturns the complete work catalogue with its public metadata.
API
ETSO provides a public API to query catalogue works and authors and reuse their identifiers, titles, attributions, stylometric results, and links.
The information is returned as JSON and can be used to integrate ETSO data into catalogues, visualizations, search engines, or research tools.
Endpoints
GET /api/obras/{id-publicId-o-slug}Returns a single work using its identifier or public slug.
GET /api/autoresReturns the complete author list with metadata and the five categories of related works.
GET /api/autores/{id-o-key}Returns one author’s metadata and five work categories using their numeric id or textual key.
Selecting response fields
All four endpoints accept the optional fields parameter with comma-separated public top-level field names. The tables below describe the fields for each resource. Selecting an object, such as resources, returns that entire public object.
Without fields, all public fields are returned. Selection preserves the authors, author, works, or work wrapper and any applicable meta information. Empty selections, unknown or private fields, and nested paths such as resources.work return HTTP 400.
https://etso.es/api/obras/690677?fields=publicId,displayTitle{
"meta": {
"contentPolicy": {
"includesFullText": false,
"includesSummaries": false,
"excludedFields": [
"fullText",
"text",
"shortSummary",
"summaryText",
"resumen_breve",
"resumen_largo"
]
}
},
"work": {
"publicId": 690677,
"displayTitle": "La francesa Laura"
}
}Work metadata
| Field | Description |
|---|---|
id | Stable work identifier. |
publicId | Stable numeric public identifier for the work. |
slug | Readable identifier used in public URLs. |
title | Title as stored in the database, including the final article when present. |
displayTitle | Title transformed with the same process used by the ETSO website. |
titleVariants | Other work titles as stored in the database. |
displayTitleVariants | Other titles transformed with the same process used by the website. |
genre | Work genre. |
origin | Source or provenance of the text used by ETSO. |
textState | Text state in the catalogue. |
addedOn | Date added to the catalogue, when available. |
bitesoPublishedOn | BITESO publication date; null when unavailable. |
summaryPublishedOn | Summary publication date; null when unavailable. |
resultado1 | Stylometric result for the work as a sentence. |
flags | Boolean indicators for report, summary, authorship exam, and text access. |
traditionalAttributionText | Traditional attribution ready for display. |
traditionalAttributionPhrase | Traditional attribution sentence with text, Markdown, HTML, and linkable parts. |
stylometryAttributionText | Stylometric attribution ready for display. |
traditionalAttribution | Normalized traditional attribution. |
stylometryAttribution | Normalized stylometric attribution. |
resources | Related public links within ETSO. |
Within attribution objects, authorId is the public numeric author identifier and authorKey is the textual key used in ETSO URLs. These are attribution properties, not top-level fields.
Complete response example
Query for a specific work and complete response:
https://etso.es/api/obras/690677{
"meta": {
"contentPolicy": {
"includesFullText": false,
"includesSummaries": false,
"excludedFields": [
"fullText",
"text",
"shortSummary",
"summaryText",
"resumen_breve",
"resumen_largo"
]
}
},
"work": {
"id": "DESCONOCIDO_FrancesaLaura",
"publicId": 690677,
"slug": "la-francesa-laura",
"title": "Francesa Laura, La",
"displayTitle": "La francesa Laura",
"titleVariants": [],
"displayTitleVariants": [],
"genre": "Comedia",
"origin": "El texto procede de la edición crítica de Álvaro Cuéllar y Germán Vega García-Luengos (Gredos, 2023).",
"textState": "Bueno",
"addedOn": "2021/03",
"bitesoPublishedOn": "2026-06-18",
"summaryPublishedOn": "2026-06-18",
"resultado1": "Los analisis de estilometria permiten asociar esta obra de forma clara con el perfil autorial de Lope de Vega Carpio.",
"flags": {
"inAuthorshipExam": true,
"hasSummary": true,
"hasReport": true,
"hasTextAccess": true
},
"traditionalAttributionText": "Lope de Vega Carpio",
"traditionalAttributionPhrase": {
"text": "Obra atribuida a Lope de Vega Carpio.",
"markdown": "Obra atribuida a [Lope de Vega Carpio](https://etso.es/autores/vega_carpio_lope_de).",
"html": "Obra atribuida a <a href=\"/autores/vega_carpio_lope_de\">Lope de Vega Carpio</a>.",
"parts": [
{
"kind": "text",
"value": "Obra atribuida a "
},
{
"kind": "author",
"value": "Lope de Vega Carpio",
"authorId": 364,
"authorKey": "vega_carpio_lope_de",
"href": "/autores/vega_carpio_lope_de",
"url": "https://etso.es/autores/vega_carpio_lope_de"
},
{
"kind": "text",
"value": "."
}
]
},
"stylometryAttributionText": "Lope de Vega Carpio [Segura]",
"traditionalAttribution": {
"groups": [
{
"members": [
{
"authorId": 364,
"authorKey": "vega_carpio_lope_de",
"authorName": "Lope de Vega Carpio"
}
]
}
],
"connector": "and",
"rawExpression": "vega_carpio_lope_de"
},
"stylometryAttribution": {
"groups": [
{
"members": [
{
"authorId": 364,
"authorKey": "vega_carpio_lope_de",
"authorName": "Lope de Vega Carpio",
"confidence": "segura"
}
]
}
],
"connector": "and",
"rawExpression": "vega_carpio_lope_de[segura]"
},
"resources": {
"work": "/obras/la-francesa-laura",
"summary": "/obras/la-francesa-laura/resumen",
"report": "/informes/analisis-estilometrico-la-francesa-laura",
"textAccess": [
{
"label": "Texto BITESO",
"href": "/biteso/la-francesa-laura",
"kind": "biteso"
}
]
}
}
}Recommended Use
Responses are served with public cache: public, max-age=3600, s-maxage=86400, stale-while-revalidate=604800. For external integrations, cache the response locally and avoid calling the API on every render.
Selecting fields reduces response size and data transfer. By itself, it does not reduce the number of requests or eliminate all database queries.