# Alan Partridge Scripts and Quotes

> alanpartridgescripts.co.uk is a fan-made database of full episode transcripts from the British comedy character Alan Partridge, created by Steve Coogan and Armando Iannucci. Every line of dialogue is available as structured JSON through a free, public, read-only API that needs no key.

The site offers a human-friendly web UI and a public JSON API covering the same data, so agents can browse and quote dialogue programmatically.

## Fetching the data

The whole corpus is about 47,000 words, and a single episode is about 5,000. It is designed to be fetched directly rather than searched: request the episodes you want and read them in full. There is no search endpoint.

- Every episode, with metadata but no transcripts: https://alanpartridgescripts.co.uk/api/v1/episodes.json
- One episode, with its complete transcript: https://alanpartridgescripts.co.uk/api/v1/episodes/im-alan-partridge/series-1/episode-1-a-room-with-an-alan.json

## Developer resources

- [Developer portal](https://alanpartridgescripts.co.uk/developers): API overview, endpoint reference and examples.
- [OpenAPI specification](https://alanpartridgescripts.co.uk/openapi.json): Machine-readable description of every endpoint (OpenAPI 3.1).
- [API root](https://alanpartridgescripts.co.uk/api/v1/index.json): Discovery document listing every endpoint.
- [Sitemap](https://alanpartridgescripts.co.uk/sitemap-index.xml): All public pages.
- [Robots policy](https://alanpartridgescripts.co.uk/robots.txt): Crawling allowed.

## API endpoints

Paths are also served without the `.json` extension.

- [GET /api/v1/programmes.json](https://alanpartridgescripts.co.uk/api/v1/programmes.json): List all programmes.
- [GET /api/v1/programmes/{programme}.json](https://alanpartridgescripts.co.uk/api/v1/programmes/im-alan-partridge.json): A single programme with its series and episodes.
- [GET /api/v1/series.json](https://alanpartridgescripts.co.uk/api/v1/series.json): List every series.
- [GET /api/v1/series/{programme}/{series}.json](https://alanpartridgescripts.co.uk/api/v1/series/im-alan-partridge/series-1.json): A single series with its episodes.
- [GET /api/v1/episodes.json](https://alanpartridgescripts.co.uk/api/v1/episodes.json): List every episode, without transcripts.
- [GET /api/v1/episodes/{programme}/{series}/{episode}.json](https://alanpartridgescripts.co.uk/api/v1/episodes/im-alan-partridge/series-1/episode-1-a-room-with-an-alan.json): A single episode with its scenes and lines (full transcript).
- [GET /api/v1/characters.json](https://alanpartridgescripts.co.uk/api/v1/characters.json): List every character that appears in the transcripts.

Each line carries both `text` (the original markdown, where `_italics_` mark stage directions) and `dialogue` (the same line as plain text).

## Content

Currently covering *I'm Alan Partridge* only.

### Series 1 (1997)
- Episode 1: A Room with an Alan
- Episode 2: Alan Attraction
- Episode 3: Watership Alan
- Episode 4: Basic Alan
- Episode 5: To Kill a Mocking Alan
- Episode 6: Towering Alan

### Series 2 (2002)
- Episode 1: The Talented Mr Alan
- Episode 2: The Colour of Alan
- Episode 3: Brave Alan
- Episode 4: Never Say Alan Again
- Episode 5: I Know What Alan Did Last Summer
- Episode 6: Alan Wide Shut

## Web pages

- `/` — Homepage, listing every series, with an on-site search box.
- `/im-alan-partridge/{series}` — A series and its episodes.
- `/im-alan-partridge/{series}/{episode}` — A full episode transcript with scenes, speaker names and stage directions.

## Copyright

Alan Partridge quotes and transcripts are the property of their respective copyright holders, including the BBC, Baby Cow Productions, and TalkBack Productions. Content provided under fair use/fair dealing principles for informational and entertainment purposes.