API

ETSO bietet eine öffentliche API zum Abfragen von Werken und Autoren des Katalogs und zur Weiterverwendung ihrer Kennungen, Titel, Zuschreibungen, stilometrischen Ergebnisse und Links.

Die Informationen werden im JSON-Format geliefert und können in Kataloge, Visualisierungen, Suchsysteme oder Forschungswerkzeuge integriert werden.

Endpoints

GET /api/obras

Gibt den vollständigen Werkkatalog mit seinen öffentlichen Metadaten zurück.

GET /api/obras/{id-publicId-o-slug}

Gibt ein einzelnes Werk anhand seiner Kennung oder seines öffentlichen Slugs zurück.

GET /api/autores

Gibt die vollständige Autorenliste mit Metadaten und den fünf Kategorien zugehöriger Werke zurück.

GET /api/autores/{id-o-key}

Gibt die Metadaten und fünf Werkkategorien eines Autors anhand seiner numerischen ID oder seines Textschlüssels zurück.

Antwortfelder auswählen

Alle vier Endpunkte akzeptieren den optionalen Parameter fields mit kommagetrennten öffentlichen Feldnamen der obersten Ebene. Die folgenden Tabellen beschreiben die Felder jeder Ressource. Die Auswahl eines Objekts wie resources liefert das vollständige öffentliche Objekt.

Ohne fields werden alle öffentlichen Felder zurückgegeben. Die Auswahl behält die Hüllen authors, author, works oder work und gegebenenfalls meta bei. Leere Auswahlen, unbekannte oder private Felder und verschachtelte Pfade wie resources.work führen zu 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"
  }
}

Metadaten der Werke

Feld	Beschreibung
`id`	Stabile Werkkennung.
`publicId`	Stabile numerische öffentliche Kennung des Werkes.
`slug`	Lesbare Kennung, die in öffentlichen URLs verwendet wird.
`title`	Titel wie in der Datenbank gespeichert, einschließlich nachgestelltem Artikel, falls vorhanden.
`displayTitle`	Titel, der mit demselben Verfahren umgeformt wird wie auf der ETSO-Website.
`titleVariants`	Weitere Werktitel wie in der Datenbank gespeichert.
`displayTitleVariants`	Weitere Titel, die mit demselben Verfahren wie auf der Website umgeformt werden.
`genre`	Gattung des Werkes.
`origin`	Herkunft oder Quelle des von ETSO verwendeten Textes.
`textState`	Textzustand im Katalog.
`addedOn`	Datum der Aufnahme in den Katalog, sofern vorhanden.
`bitesoPublishedOn`	Veröffentlichungsdatum in BITESO; null, wenn unbekannt.
`summaryPublishedOn`	Veröffentlichungsdatum der Zusammenfassung; null, wenn unbekannt.
`resultado1`	Stilometrisches Ergebnis des Werkes als Satz.
`flags`	Boolesche Angaben zu Bericht, Zusammenfassung, Autorschaftsprüfung und Textzugang.
`traditionalAttributionText`	Traditionelle Zuschreibung zur direkten Anzeige.
`traditionalAttributionPhrase`	Satz der traditionellen Zuschreibung mit Text, Markdown, HTML und verlinkbaren Teilen.
`stylometryAttributionText`	Stilometrische Zuschreibung zur direkten Anzeige.
`traditionalAttribution`	Normalisierte traditionelle Zuschreibung.
`stylometryAttribution`	Normalisierte stilometrische Zuschreibung.
`resources`	Zugehörige öffentliche Links innerhalb von ETSO.

In Zuschreibungsobjekten ist authorId die öffentliche numerische Autorenkennung und authorKey der in ETSO-URLs verwendete Textschlüssel. Dies sind Eigenschaften der Zuschreibungen, keine Felder der obersten Ebene.

Beispiel einer vollständigen Antwort

Abfrage eines bestimmten Werkes und vollständige Antwort:

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"
        }
      ]
    }
  }
}

Autoren und zugehörige Werke

Die numerische Autoren-id ist die ETSO-Kennung und entspricht authorId in den Werkzuschreibungen. Der Textschlüssel key identifiziert den Autor in ETSO-URLs.

Feld	Beschreibung
`id`	Öffentliche numerische Autorenkennung; entspricht authorId in Werkzuschreibungen.
`key`	In Autoren-URLs verwendeter Textschlüssel.
`name`	Name des Autors.
`nameVariants`	Varianten des Autorennamens.
`resources`	Links zum öffentlichen Autorenprofil: author ist der Pfad und url die absolute URL.

Werke nach Autor

Jeder Autor enthält fünf Arrays numerischer Werk-publicId-Werte (number[]), entsprechend den fünf Kategorien seines Profils in der Autorschaftsprüfung. Enthalten sind nur Werke dieser Prüfung, nach denselben Kriterien wie auf der Website: Wahrscheinliche oder mögliche Zuschreibungen und Gemeinschaftswerke werden berücksichtigt; ungeklärte traditionelle oder stilometrische Zuschreibungen werden auf der jeweiligen Seite ausgeschlossen. Die Aufnahme bedeutet keine sichere oder alleinige Autorschaft.

Jede Kategorie ohne Werke liefert []. Die Kategorien werden für den abgefragten Autor berechnet. Jede Werk-publicId kann über /api/obras/{publicId} abgefragt oder über https://etso.es/obras/{publicId} verlinkt werden; dieser Link leitet zur kanonischen Werkseite weiter.

Feld	Beschreibung
`relatedWorkPublicIds`	Mit dem Autor verbundene Werke: traditionelle oder stilometrische Zuschreibung.
`traditionalWorkPublicIds`	Durch die Tradition gestützte Werke.
`stylometryWorkPublicIds`	Durch Stilometrie gestützte Werke.
`traditionalOnlyWorkPublicIds`	Nur durch die Tradition gestützte Werke: ohne stilometrische Unterstützung für diesen Autor.
`newStylometrySupportedWorkPublicIds`	Durch Stilometrie gestützte neue Zuschreibungen: ohne traditionelle Zuschreibung an diesen Autor.

Alle Autoren mit ihren fünf Werklisten

https://etso.es/api/autores

Ein Autor mit seinen fünf Werklisten

https://etso.es/api/autores/374

Nur die mit einem Autor verbundenen Werke

https://etso.es/api/autores/374?fields=id,relatedWorkPublicIds

Empfohlene Nutzung

Antworten werden mit öffentlichem Cache ausgeliefert: public, max-age=3600, s-maxage=86400, stale-while-revalidate=604800. Für externe Integrationen wird empfohlen, die Antwort lokal zwischenzuspeichern und die API nicht bei jedem Rendern aufzurufen.

Die Feldauswahl verringert die Antwortgröße und die Datenübertragung. Sie allein reduziert weder die Anzahl der Anfragen noch entfallen dadurch sämtliche Datenbankabfragen.