# Vanderbilt Television News Archive API

**Canonical:** https://apis.io/apis/vanderbilt/television-news-archive/  
**Provider:** Vanderbilt University — https://apis.io/providers/vanderbilt/  
**Base URL:** https://7itm2l2dz8.execute-api.us-east-1.amazonaws.com/prod  
**Documentation:** https://tvnews.vanderbilt.edu/

Vanderbilt Television News Archive API is one of 10 APIs that [Vanderbilt University](https://apis.io/providers/vanderbilt/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Television News, Digital Collections, Search, Media Archive, and Open Access. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

Public read API behind tvnews.vanderbilt.edu, self-identifying as the "TVNA Serverless API" v1.0.0. Search, browse and retrieve United States network television news broadcasts and segments recorded continuously since 5 August 1968 — 98,371 broadcasts, 969,224 news segments, 396,720 commercial segments, 58,517 hours of runtime. Every read operation probed returned 200 with no credential. Built and operated by the Jean and Alexander Heard Libraries; the source repository is HeardLibrary/TVNA-serverless-api. Vanderbilt publishes no OpenAPI for it, so the contract here is derived from live probes and is marked as such.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/` | Service identification |
| GET | `/broadcasts` | Archive-wide counts |
| GET | `/broadcasts/full-date-range` | Earliest and latest broadcast dates held |
| GET | `/broadcasts/calendar` | Broadcasts available within a date window |
| GET | `/broadcasts/{broadcastId}` | Retrieve one broadcast and its segments |
| POST | `/broadcasts/search/keyword` | Keyword search across segment titles, descriptions and transcripts |
| POST | `/broadcasts/search` | Faceted search over broadcasts and segments |
| GET | `/search/metadata/filters` | Controlled vocabularies available as search facets |
| GET | `/auth/sso-providers` | Subscribing institutions with federated sign-in configured |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/vanderbilt/refs/heads/main/openapi/vanderbilt-television-news-archive-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vanderbilt/refs/heads/main/json-schema/vanderbilt-television-news-archive-schema.json
- **Documentation** — https://blog.tvnews.vanderbilt.edu/welcome/access-information/
- **Website** — https://tvnews.vanderbilt.edu/
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/vanderbilt/refs/heads/main/apis.yml

## Other Vanderbilt University APIs (9)

- [Vanderbilt Libraries SPARQL Endpoint](https://apis.io/apis/vanderbilt/sparql/)
- [Vanderbilt Institutional Repository (VUIR)](https://apis.io/apis/vanderbilt/institutional-repository/)
- [Vanderbilt Institutional Repository OAI-PMH](https://apis.io/apis/vanderbilt/institutional-repository-oai-pmh/)
- [Vanderbilt Okta Identity Provider (OneVU)](https://apis.io/apis/vanderbilt/onevu-identity/)
- [Vanderbilt Microsoft Entra ID Tenant](https://apis.io/apis/vanderbilt/entra-identity/)
- [VUIR Shibboleth Service Provider](https://apis.io/apis/vanderbilt/shibboleth-service-provider/)
- [Ex Libris Primo / Alma Library Discovery (01VAN_INST)](https://apis.io/apis/vanderbilt/primo-discovery/)
- [Crossref Membership — Vanderbilt University Library](https://apis.io/apis/vanderbilt/crossref-member/)
- [ROR Registration — Vanderbilt University](https://apis.io/apis/vanderbilt/ror/)

## Tags

Television News, Digital Collections, Search, Media Archive, Open Access

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/vanderbilt/television-news-archive/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/vanderbilt/.
