### Get Show Images

Source: https://www.tvmaze.com/api

Retrieves all available images for a specific show, including different types and resolutions.

```APIDOC
## GET /shows/:id/images

### Description
A list of all images available for this show. The image type can be "poster", "banner", "background", "typography", or NULL in case of legacy unclassified images. All image types are available under the "original" resolution; posters and banners are also available as a smaller resized version ("medium").

### Endpoint
/shows/:id/images
```

--------------------------------

### Get Shows (Paginated)

Source: https://www.tvmaze.com/api

Retrieves a paginated list of all shows in the database, with primary information. Useful for building local caches.

```APIDOC
## GET /shows

### Description
A list of all shows in our database, with all primary information included. This endpoint is paginated, with a maximum of 250 results per page. Results are cached for up to 24 hours.

### Endpoint
/shows

### Parameters
#### Query Parameters
- **page** (integer) - Optional - The page number to retrieve. Defaults to the first page if not specified.
```

--------------------------------

### Get Episode Guest Crew

Source: https://www.tvmaze.com/api

Retrieves all guest crew members who worked on a specific episode.

```APIDOC
## GET /episodes/:id/guestcrew

### Description
Retrieve all guest crew working on an episode.

### Endpoint
/episodes/:id/guestcrew
```

--------------------------------

### Get Episode Information

Source: https://www.tvmaze.com/api

Retrieves all primary information for a specific episode, with support for embedding additional data.

```APIDOC
## GET /episodes/:id

### Description
Retrieve all primary information for a given episode. This endpoint allows embedding of additional information.

### Endpoint
/episodes/:id

### Parameters
#### Query Parameters
- **embed** (string) - Optional - Allows embedding of additional information (e.g., show).
```

--------------------------------

### Get Person Information

Source: https://www.tvmaze.com/api

Retrieves all primary information for a specific person, with support for embedding additional data.

```APIDOC
## GET /people/:id

### Description
Retrieve all primary information for a given person. This endpoint allows embedding of additional information.

### Endpoint
/people/:id

### Parameters
#### Query Parameters
- **embed** (string) - Optional - Allows embedding of additional information (e.g., castcredits).
```

--------------------------------

### Get Season Episodes

Source: https://www.tvmaze.com/api

Retrieves a list of episodes for a specific season. Specials are included, and additional information can be embedded.

```APIDOC
## GET /seasons/:id/episodes

### Description
A list of episodes in this season. Specials are always included in this list. This endpoint allows embedding of additional information.

### Endpoint
/seasons/:id/episodes

### Parameters
#### Query Parameters
- **embed** (string) - Optional - Allows embedding of additional information (e.g., guestcast).

### Request Example
```
https://api.tvmaze.com/seasons/1/episodes
https://api.tvmaze.com/seasons/1/episodes?embed=guestcast
```
```

--------------------------------

### Get Episode Guest Cast

Source: https://www.tvmaze.com/api

Retrieves all guest cast members who appeared in a specific episode.

```APIDOC
## GET /episodes/:id/guestcast

### Description
Retrieve all guest cast starring in an episode.

### Endpoint
/episodes/:id/guestcast
```

--------------------------------

### Get Show AKAs

Source: https://www.tvmaze.com/api

Retrieves a list of aliases (AKAs) for a specific show, including country-specific aliases.

```APIDOC
## GET /shows/:id/akas

### Description
A list of AKA's (aliases) for a show. An AKA with its country set to null indicates an AKA in the show's original country. Otherwise, it's the AKA for that show in the given foreign country.

### Endpoint
/shows/:id/akas
```

--------------------------------

### Show Updates

Source: https://www.tvmaze.com/api

Get a list of all shows and their last update timestamps. This endpoint can be filtered to include only shows updated within a specific timeframe (day, week, month).

```APIDOC
## GET /updates/shows

### Description
Returns a list of all shows in the TVmaze database along with the timestamp of their last update. This endpoint can be filtered to retrieve shows updated within the last day, week, or month.

### Endpoint
/updates/shows

### Parameters
#### Query Parameters
- **since** (string) - Optional - Filters results to shows updated since a specific time ('day', 'week', 'month').
```

--------------------------------

### Get Show Crew

Source: https://www.tvmaze.com/api

Retrieves the main crew members for a specific show, along with their crew type.

```APIDOC
## GET /shows/:id/crew

### Description
A list of main crew for a show. Each crew item is a combination of a person and their crew type.

### Endpoint
/shows/:id/crew
```

--------------------------------

### Get Show Cast

Source: https://www.tvmaze.com/api

Retrieves the main cast for a specific show, ordered by importance based on character appearances.

```APIDOC
## GET /shows/:id/cast

### Description
A list of main cast for a show. Each cast item is a combination of a person and a character. Items are ordered by importance, which is determined by the total number of appearances of the given character in this show.

### Endpoint
/shows/:id/cast
```

--------------------------------

### Get Person Cast Credits

Source: https://www.tvmaze.com/api

Retrieves all cast credits (show and character combinations) for a specific person, with optional embedding of show details.

```APIDOC
## GET /people/:id/castcredits

### Description
Retrieve all (show-level) cast credits for a person. A cast credit is a combination of both a show and a character. By default, only a reference to each show and character will be returned. However, this endpoint supports embedding, which means full information for the shows and characters can be included.

### Endpoint
/people/:id/castcredits

### Parameters
#### Query Parameters
- **embed** (string) - Optional - Allows embedding of full show information.
```

--------------------------------

### Get Person Crew Credits

Source: https://www.tvmaze.com/api

Retrieves all crew credits (show and crew type combinations) for a specific person, with optional embedding of show details.

```APIDOC
## GET /people/:id/crewcredits

### Description
Retrieve all (show-level) crew credits for a person. A crew credit is combination of both a show and a crew type. By default, only a reference to each show will be returned. However, this endpoint supports embedding, which means full information for the shows can be included.

### Endpoint
/people/:id/crewcredits

### Parameters
#### Query Parameters
- **embed** (string) - Optional - Allows embedding of full show information.
```

--------------------------------

### Show Main Information Endpoint

Source: https://www.tvmaze.com/api

Retrieves all primary information for a given show. This endpoint allows embedding of additional information like cast.

```APIDOC
## GET /shows/:id

### Description
Retrieves all primary information for a given show. This endpoint allows embedding of additional information.

### Method
GET

### Endpoint
/shows/:id

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the show.

#### Query Parameters
- **embed** (string) - Optional - Specifies additional information to embed, e.g., 'cast'.

### Request Example
```
https://api.tvmaze.com/shows/1
https://api.tvmaze.com/shows/1?embed=cast
```

### Response
#### Success Response (200)
- **id** (integer) - The unique identifier for the show.
- **url** (string) - The TVmaze URL for the show.
- **name** (string) - The name of the show.
- **type** (string) - The type of the show (e.g., 'Scripted', 'Animation').
- **language** (string) - The language of the show.
- **genres** (array) - An array of genres associated with the show.
- **status** (string) - The current status of the show (e.g., 'Running', 'Ended').
- **runtime** (integer) - The runtime of the show in minutes.
- **premiered** (string) - The premiere date of the show.
- **ended** (string) - The end date of the show.
- **officialSite** (string) - The official website URL for the show.
- **schedule** (object) - Information about the show's schedule.
- **rating** (object) - The rating of the show.
- **summary** (string) - A summary of the show.
- **network** (object) - Information about the network broadcasting the show.
- **webChannel** (object) - Information about the web channel broadcasting the show.
- **externals** (object) - External IDs for the show.
- **image** (object) - Information about the show's image.
- **updated** (integer) - The timestamp of the last update.
- **_links** (object) - Links to related resources.

### Response Example
```json
{
  "id": 1,
  "url": "https://www.tvmaze.com/shows/1/under-the-dome",
  "name": "Under the Dome",
  "type": "Scripted",
  "language": "English",
  "genres": [
    "Drama",
    "Science-fiction",
    "Thriller"
  ],
  "status": "Ended",
  "runtime": 60,
  "premiered": "2013-06-24",
  "ended": "2015-06-25",
  "officialSite": "http://www.cbs.com/shows/under_the_dome/",
  "schedule": {
    "time": "22:00",
    "days": [
      "Thursday"
    ]
  },
  "rating": {
    "average": 6.6
  },
  "summary": "<p><b>Under the Dome</b> is the story of...</p>",
  "network": {
    "id": 2,
    "name": "CBS",
    "country": {
      "name": "United States",
      "code": "US",
      "timezone": "America/New_York"
    }
  },
  "webChannel": null,
  "externals": {
    "tvrage": 25644,
    "thetvdb": 264493,
    "imdb": "tt2193041"
  },
  "image": {
    "medium": "https://static.tvmaze.com/uploads/images/medium_portrait/1/2660.jpg",
    "original": "https://static.tvmaze.com/uploads/images/original_untouched/1/2660.jpg"
  },
  "updated": 1679445011,
  "_links": {
    "self": {
      "href": "https://api.tvmaze.com/shows/1"
    },
    "previousepisode": {
      "href": "https://api.tvmaze.com/episodes/185056"
    }
  }
}
```
```

--------------------------------

### Search Shows

Source: https://www.tvmaze.com/api

Search through all the shows in the database by the show's name. A fuzzy algorithm is used, meaning that shows will be found even if your query contains small typos. Results are returned in order of relevancy.

```APIDOC
## GET /search/shows

### Description
Searches for TV shows by name using a fuzzy matching algorithm.

### Endpoint
/search/shows?q=:query

### Parameters
#### Query Parameters
- **q** (string) - Required - The query string to search for show names.
```

--------------------------------

### Web Schedule Endpoint

Source: https://www.tvmaze.com/api

Retrieves a complete list of episodes airing on web/streaming channels on a given date. It distinguishes between local and global web channels.

```APIDOC
## GET /schedule/web

### Description
Retrieves a complete list of episodes airing on web/streaming channels on a given date. It distinguishes between local and global web channels.

### Method
GET

### Endpoint
/schedule/web

### Parameters
#### Query Parameters
- **country** (string) - Optional - An ISO 3166-1 code of the country. If omitted, queries both local and global channels. If set to an empty string, queries only global channels. If set to a country code, queries only local channels for that country.
- **date** (string) - Optional - An ISO 8601 formatted date; defaults to the current day.

### Request Example
```
https://api.tvmaze.com/schedule/web?date=2020-05-29
https://api.tvmaze.com/schedule/web?date=2020-05-29&country=
https://api.tvmaze.com/schedule/web?date=2020-05-29&country=US
```

### Response
#### Success Response (200)
- **episodes** (array) - A list of episode objects.

### Response Example
```json
[
  {
    "id": 12345,
    "url": "https://www.tvmaze.com/episodes/12345/show-name-season-1-episode-1",
    "name": "Episode Name",
    "season": 1,
    "number": 1,
    "type": "regular",
    "airdate": "2020-05-29",
    "airtime": "00:00",
    "airstamp": "2020-05-29T00:00:00+00:00",
    "runtime": 30,
    "rating": {
      "average": 7.0
    },
    "summary": "<p>Episode summary...</p>",
    "_links": {
      "self": {
        "href": "https://api.tvmaze.com/episodes/12345"
      },
      "show": {
        "href": "https://api.tvmaze.com/shows/1"
      }
    }
  }
]
```
```

--------------------------------

### Show Alternate Lists Endpoint

Source: https://www.tvmaze.com/api

Retrieves alternate episode lists for a show, such as DVD ordering.

```APIDOC
## GET /shows/:id/alternatelists

### Description
Retrieves alternate episode lists for a show, such as DVD ordering.

### Method
GET

### Endpoint
/shows/:id/alternatelists

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the show.

### Response
#### Success Response (200)
- **alternatelists** (array) - A list of alternate episode list objects.

### Response Example
```json
[
  {
    "id": 1,
    "name": "DVD order",
    "episodeOrder": "dvd",
    "episodes": [
      {
        "id": 12345,
        "url": "https://www.tvmaze.com/episodes/12345/show-name-season-1-episode-1",
        "name": "Episode Name",
        "season": 1,
        "number": 1,
        "type": "regular",
        "airdate": "2014-12-01",
        "_links": {
          "self": {
            "href": "https://api.tvmaze.com/episodes/12345"
          }
        }
      }
    ]
  }
]
```
```

--------------------------------

### Person Index

Source: https://www.tvmaze.com/api

Retrieve a paginated list of people. Similar to the show index, this endpoint returns a maximum of 1000 results per page.

```APIDOC
## GET /people?page=:num

### Description
Provides an index of people, similar to the show index. A maximum of 1000 results are returned per page.

### Endpoint
/people?page=:num

### Parameters
#### Query Parameters
- **page** (integer) - Optional - The page number for the results.
```

--------------------------------

### Full Schedule Endpoint

Source: https://www.tvmaze.com/api

Retrieves a list of all future episodes known to TVmaze, regardless of country. Results are cached for 24 hours.

```APIDOC
## GET /schedule/full

### Description
Retrieves a list of all future episodes known to TVmaze, regardless of country. Results are cached for 24 hours.

### Method
GET

### Endpoint
/schedule/full

### Response
#### Success Response (200)
- **episodes** (array) - A list of episode objects.

### Response Example
```json
[
  {
    "id": 12345,
    "url": "https://www.tvmaze.com/episodes/12345/show-name-season-1-episode-1",
    "name": "Episode Name",
    "season": 1,
    "number": 1,
    "type": "regular",
    "airdate": "2025-01-01",
    "airtime": "21:00",
    "airstamp": "2025-01-01T21:00:00+00:00",
    "runtime": 60,
    "rating": {
      "average": 9.0
    },
    "summary": "<p>Episode summary...</p>",
    "_links": {
      "self": {
        "href": "https://api.tvmaze.com/episodes/12345"
      },
      "show": {
        "href": "https://api.tvmaze.com/shows/1"
      }
    }
  }
]
```
```

--------------------------------

### Show Episode List Endpoint

Source: https://www.tvmaze.com/api

Retrieves a complete list of episodes for a given show, ordered by airing sequence. Specials are excluded by default.

```APIDOC
## GET /shows/:id/episodes

### Description
Retrieves a complete list of episodes for a given show, ordered by airing sequence. Specials are excluded by default.

### Method
GET

### Endpoint
/shows/:id/episodes

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the show.

#### Query Parameters
- **specials** (integer) - Optional - Set to 1 to include both significant and insignificant specials in the list.

### Request Example
```
https://api.tvmaze.com/shows/1/episodes
https://api.tvmaze.com/shows/1/episodes?specials=1
```

### Response
#### Success Response (200)
- **episodes** (array) - A list of episode objects.

### Response Example
```json
[
  {
    "id": 185055,
    "url": "https://www.tvmaze.com/episodes/185055/under-the-dome-season-3-episode-1-move-on",
    "name": "Move On",
    "season": 3,
    "number": 1,
    "type": "regular",
    "airdate": "2015-06-25",
    "airtime": "22:00",
    "airstamp": "2015-06-25T22:00:00+00:00",
    "runtime": 60,
    "rating": {
      "average": 6.3
    },
    "summary": "<p>The Dome is gone...</p>",
    "_links": {
      "self": {
        "href": "https://api.tvmaze.com/episodes/185055"
      },
      "show": {
        "href": "https://api.tvmaze.com/shows/1"
      }
    }
  }
]
```
```

--------------------------------

### Alternate List Details Endpoint

Source: https://www.tvmaze.com/api

Retrieves details for a specific alternate episode list.

```APIDOC
## GET /alternatelists/:id

### Description
Retrieves details for a specific alternate episode list.

### Method
GET

### Endpoint
/alternatelists/:id

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the alternate list.

#### Query Parameters
- **embed** (string) - Optional - Specifies additional information to embed, e.g., 'alternateepisodes'.

### Response
#### Success Response (200)
- **alternatelist** (object) - Details of the alternate episode list.

### Response Example
```json
{
  "id": 1,
  "name": "DVD order",
  "episodeOrder": "dvd",
  "episodes": [
    {
      "id": 12345,
      "url": "https://www.tvmaze.com/episodes/12345/show-name-season-1-episode-1",
      "name": "Episode Name",
      "season": 1,
      "number": 1,
      "type": "regular",
      "airdate": "2014-12-01",
      "_links": {
        "self": {
          "href": "https://api.tvmaze.com/episodes/12345"
        }
      }
    }
  ],
  "_links": {
    "self": {
      "href": "https://api.tvmaze.com/alternatelists/1"
    },
    "show": {
      "href": "https://api.tvmaze.com/shows/1"
    }
  }
}
```
```

--------------------------------

### Search People

Source: https://www.tvmaze.com/api

Search through all the people in the database using a fuzzy matching algorithm similar to show searches.

```APIDOC
## GET /search/people

### Description
Searches for people by name using a fuzzy matching algorithm.

### Endpoint
/search/people?q=:query

### Parameters
#### Query Parameters
- **q** (string) - Required - The query string to search for people's names.
```

--------------------------------

### Single Show Search

Source: https://www.tvmaze.com/api

Returns exactly one result or no result for a given query. This endpoint is also forgiving of typos, but less so than the regular search.

```APIDOC
## GET /singlesearch/shows

### Description
Performs a single search for a TV show by name, returning at most one result.

### Endpoint
/singlesearch/shows?q=:query

### Parameters
#### Query Parameters
- **q** (string) - Required - The query string to search for a show name.
- **embed** (string) - Optional - Allows embedding additional information in the result (e.g., "episodes").
```

--------------------------------

### Schedule Endpoint

Source: https://www.tvmaze.com/api

Retrieves a complete list of episodes airing in a given country on a specific date. Episodes are ordered by air time and include full show and episode details. It filters episodes tied to specific countries via networks or local web channels.

```APIDOC
## GET /schedule

### Description
Retrieves a complete list of episodes airing in a given country on a specific date. Episodes are ordered by air time and include full show and episode details. It filters episodes tied to specific countries via networks or local web channels.

### Method
GET

### Endpoint
/schedule

### Parameters
#### Query Parameters
- **country** (string) - Optional - An ISO 3166-1 code of the country; defaults to US.
- **date** (string) - Optional - An ISO 8601 formatted date; defaults to the current day.

### Request Example
```
https://api.tvmaze.com/schedule?country=US&date=2014-12-01
```

### Response
#### Success Response (200)
- **episodes** (array) - A list of episode objects.

### Response Example
```json
[
  {
    "id": 12345,
    "url": "https://www.tvmaze.com/episodes/12345/show-name-season-1-episode-1",
    "name": "Episode Name",
    "season": 1,
    "number": 1,
    "type": "regular",
    "airdate": "2014-12-01",
    "airtime": "20:00",
    "airstamp": "2014-12-01T20:00:00+00:00",
    "runtime": 60,
    "rating": {
      "average": 8.5
    },
    "summary": "<p>Episode summary...</p>",
    "_links": {
      "self": {
        "href": "https://api.tvmaze.com/episodes/12345"
      },
      "show": {
        "href": "https://api.tvmaze.com/shows/1"
      }
    }
  }
]
```
```

--------------------------------

### Episodes by Date Endpoint

Source: https://www.tvmaze.com/api

Retrieves all episodes from a show that aired on a specific date. Useful for daily shows.

```APIDOC
## GET /shows/:id/episodesbydate

### Description
Retrieves all episodes from a show that aired on a specific date. Useful for daily shows.

### Method
GET

### Endpoint
/shows/:id/episodesbydate

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the show.

#### Query Parameters
- **date** (string) - Required - An ISO 8601 formatted date.

### Request Example
```
https://api.tvmaze.com/shows/1/episodesbydate?date=2013-07-01
```

### Response
#### Success Response (200)
- **episodes** (array) - An array of full episode info objects.

### Response Example
```json
[
  {
    "id": 12345,
    "url": "https://www.tvmaze.com/episodes/12345/show-name-season-1-episode-1",
    "name": "Episode Name",
    "season": 1,
    "number": 1,
    "type": "regular",
    "airdate": "2013-07-01",
    "airtime": "10:00",
    "airstamp": "2013-07-01T10:00:00+00:00",
    "runtime": 30,
    "rating": {
      "average": 7.0
    },
    "summary": "<p>Episode summary...</p>",
    "_links": {
      "self": {
        "href": "https://api.tvmaze.com/episodes/12345"
      },
      "show": {
        "href": "https://api.tvmaze.com/shows/1"
      }
    }
  }
]
```
```

--------------------------------

### Show Seasons Endpoint

Source: https://www.tvmaze.com/api

Retrieves a complete list of seasons for a given show.

```APIDOC
## GET /shows/:id/seasons

### Description
Retrieves a complete list of seasons for a given show.

### Method
GET

### Endpoint
/shows/:id/seasons

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the show.

### Response
#### Success Response (200)
- **seasons** (array) - A list of season objects.

### Response Example
```json
[
  {
    "id": 123,
    "url": "https://www.tvmaze.com/seasons/123/season-1",
    "network": {
      "id": 2,
      "name": "CBS",
      "country": {
        "name": "United States",
        "code": "US",
        "timezone": "America/New_York"
      }
    },
    "webChannel": null,
    "ந்தது": "2013-06-24",
    "endDate": "2013-09-16",
    "previousEpisode": {
      "id": 185056,
      "url": "https://www.tvmaze.com/episodes/185056/under-the-dome-season-2-episode-13-gods-angry-men",
      "name": "God's Angry Men",
      "season": 2,
      "number": 13,
      "type": "regular",
      "airdate": "2014-09-16",
      "airtime": "22:00",
      "airstamp": "2014-09-16T22:00:00+00:00",
      "runtime": 60,
      "rating": {
        "average": 7.1
      },
      "summary": "<p>The final episode...</p>",
      "_links": {
        "self": {
          "href": "https://api.tvmaze.com/episodes/185056"
        },
        "show": {
          "href": "https://api.tvmaze.com/shows/1"
        }
      }
    },
    "nextEpisode": null,
    "_links": {
      "self": {
        "href": "https://api.tvmaze.com/seasons/123"
      },
      "show": {
        "href": "https://api.tvmaze.com/shows/1"
      }
    }
  }
]
```
```

--------------------------------

### Alternate List Episodes Endpoint

Source: https://www.tvmaze.com/api

Retrieves the alternate episodes for a specific alternate list.

```APIDOC
## GET /alternatelists/:id/alternateepisodes

### Description
Retrieves the alternate episodes for a specific alternate list.

### Method
GET

### Endpoint
/alternatelists/:id/alternateepisodes

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the alternate list.

#### Query Parameters
- **embed** (string) - Optional - Specifies additional information to embed, e.g., 'episodes'.

### Response
#### Success Response (200)
- **alternateepisodes** (array) - A list of alternate episode objects.

### Response Example
```json
[
  {
    "id": 12345,
    "url": "https://www.tvmaze.com/episodes/12345/show-name-season-1-episode-1",
    "name": "Episode Name",
    "season": 1,
    "number": 1,
    "type": "regular",
    "airdate": "2014-12-01",
    "_links": {
      "self": {
        "href": "https://api.tvmaze.com/episodes/12345"
      },
      "show": {
        "href": "https://api.tvmaze.com/shows/1"
      }
    }
  }
]
```
```

--------------------------------

### Person Updates

Source: https://www.tvmaze.com/api

Retrieve updates for people in the TVmaze database. This endpoint mirrors the show updates functionality but for people, reflecting changes in attributes or associated credits.

```APIDOC
## GET /updates/people

### Description
Provides a list of people and their last update timestamps, similar to the show updates endpoint. A person is considered updated if their attributes change or if any associated cast or crew credits are created or deleted. This endpoint can be filtered by time.

### Endpoint
/updates/people

### Parameters
#### Query Parameters
- **since** (string) - Optional - Filters results to people updated since a specific time ('day', 'week', 'month').
```

--------------------------------

### Person Guest Cast Credits

Source: https://www.tvmaze.com/api

Retrieve all episode-level guest cast credits for a specific person. This endpoint supports embedding full episode and character information.

```APIDOC
## GET /people/:id/guestcastcredits

### Description
Retrieve all (episode-level) guest cast credits for a person. A guest cast credit is a combination of both an episode and a character. By default, only a reference to each episode and character will be returned. However, this endpoint supports embedding, which means full information for the episodes and characters can be included.

### Endpoint
/people/:id/guestcastcredits

### Parameters
#### Query Parameters
- **embed** (string) - Optional - Allows embedding of related resources like 'episode'.
```

--------------------------------

### Lookup Show by ID

Source: https://www.tvmaze.com/api

Finds a specific show on TVmaze using its thetvdb or IMDB ID. Returns a redirect to the show's URL if found, otherwise a 404.

```APIDOC
## GET /lookup/shows

### Description
Looks up a TV show using its thetvdb or IMDB ID.

### Endpoint
/lookup/shows?tvrage=:id or /lookup/shows?thetvdb=:id

### Parameters
#### Query Parameters
- **tvrage** (string) - Required - The TVRage ID of the show.
- **thetvdb** (string) - Required - The TheTVDB ID of the show.
- **imdb** (string) - Required - The IMDB ID of the show.
```

--------------------------------

### Episode by Number Endpoint

Source: https://www.tvmaze.com/api

Retrieves a specific episode from a show using its season and episode number.

```APIDOC
## GET /shows/:id/episodebynumber

### Description
Retrieves a specific episode from a show using its season and episode number.

### Method
GET

### Endpoint
/shows/:id/episodebynumber

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the show.

#### Query Parameters
- **season** (integer) - Required - The season number.
- **number** (integer) - Required - The episode number.

### Request Example
```
https://api.tvmaze.com/shows/1/episodebynumber?season=1&number=1
```

### Response
#### Success Response (200)
- **episode** (object) - Full information about the episode.

### Response Example
```json
{
  "id": 12345,
  "url": "https://www.tvmaze.com/episodes/12345/show-name-season-1-episode-1",
  "name": "Episode Name",
  "season": 1,
  "number": 1,
  "type": "regular",
  "airdate": "2014-12-01",
  "airtime": "20:00",
  "airstamp": "2014-12-01T20:00:00+00:00",
  "runtime": 60,
  "rating": {
    "average": 8.5
  },
  "summary": "<p>Episode summary...</p>",
  "_links": {
    "self": {
      "href": "https://api.tvmaze.com/episodes/12345"
    },
    "show": {
      "href": "https://api.tvmaze.com/shows/1"
    }
  }
}
```
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.