Newcastle University

Newcastle University TEI API

A set of endpoints providing metadata and content definitions of documents encoded using [Text Encoding Initiative](https://tei-c.org/) guidance.

GitHub OpenAPI

Operations 1

GET /v1/tei/{id}/content TEI Document Content #

Documentation

📖
Documentation
https://api.usb.urbanobservatory.ac.uk/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/openapi/newcastle-tei-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/json-schema/newcastle-timeseries-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/json-schema/newcastle-timeseriesentry-schema.json

Other Resources

🔗
x-vocabulary
https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/vocabulary/newcastle-vocabulary.yml
🔗
x-rules
https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/rules/newcastle-rules.yml
🔗
x-json-ld
https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/json-ld/newcastle-context.jsonld
🔗
x-examples
https://raw.githubusercontent.com/api-evangelist/newcastle/refs/heads/main/examples/newcastle-timeseries-entry-example.json
🔗
Website
https://urbanobservatory.ac.uk/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/newcastle:newcastle-tei-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

newcastle-tei-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Newcastle University | Digitised Objects Repository |…
  version: 1.27.0
  description: 'The *Search and Data API* provides a single point of truth interface for searching, browsing and displaying digitised objects held in Newcastle University Library''s Special Collections.


    Data curators: Special Collections and Archives\

    Administrators: Digital Library Services'
servers:
- url: https://api-dor.ncl.ac.uk
tags:
- name: TEI
  description: A set of endpoints providing metadata and content definitions of documents encoded using Text Encoding Initiative guidance.
paths:
  /v1/tei/{id}/content:
    get:
      operationId: getV1TEIContent
      summary: TEI Document Content
      description: Signpost to to a service responsible for providing the content of a TEI document with the given identifier.
      parameters:
      - in: path
        name: id
        schema:
          type: string
        example: UkLWZg9D
        required: true
        description: TEI document's identifier.
      tags:
      - TEI
      responses:
        '302':
          description: Redirects to an XML content of the given TEI document.
          content:
            application/xml:
              schema:
                type: object
                additionalProperties: true
              example: "<TEI xmlns=\"http://www.tei-c.org/ns/1.0\">\n  (...)\n</TEI>\n"
          headers:
            Location:
              description: URL where the TEI content can be consumed.
              schema:
                type: string
                format: uri
              required: true
        '400':
          description: The server could not finalise the response due to the malformed, invalid or missing request parameters.
        '404':
          description: A TEI document with the specified ID was not found.
        5XX:
          description: Indicates that the server encountered an unexpected exception preventing it from fulfilling the request.