# TMDB API

**Provider:** The Movie Database
**Category:** entertainment
**Base URL:** `https://api.themoviedb.org/3`
**Auth:** bearer — `Authorization: Bearer eyJhbGc...`
**Rate Limit:** 50 requests/sec
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://developer.themoviedb.org/docs

## Description

The Movie Database (TMDB) provides a rich community-maintained database of movies, TV shows, people, and networks. Fetch movie and show metadata including cast & crew, genres, ratings, budget, revenue, backdrops, and trailers. Discover trending and top-rated titles, search across the full catalog, and check streaming availability (where to watch) for specific regions. Free for non-commercial use.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.themoviedb.org/3/movie/{movie_id}` | Get full movie details including cast and crew |
| GET | `https://api.themoviedb.org/3/movie/popular` | List currently popular movies |
| GET | `https://api.themoviedb.org/3/tv/{series_id}` | Get TV show details and season list |
| GET | `https://api.themoviedb.org/3/search/multi` | Search movies, TV shows, and people at once |
| GET | `https://api.themoviedb.org/3/trending/{media_type}/{time_window}` | Trending movies or shows (day/week) |
| GET | `https://api.themoviedb.org/3/movie/{movie_id}/watch/providers` | Streaming availability by country |

## Authentication

Pass your API Read Access Token as a Bearer token. Also supports a legacy api_key query parameter.

```
Authorization: Bearer eyJhbGc...
```

## Sample Request

```bash
curl "https://api.themoviedb.org/3/movie/popular?language=en-US&page=1" \
  -H "Authorization: Bearer $TMDB_ACCESS_TOKEN"
```

## Sample Response

```json
{
  "page": 1,
  "results": [{
    "id": 550,
    "title": "Fight Club",
    "vote_average": 8.433,
    "popularity": 73.645,
    "release_date": "1999-10-15",
    "overview": "A ticking-time-bomb insomniac and a slippery soap salesman...",
    "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
  }]
}
```

## Pricing Details

TMDB API is free for non-commercial projects. Commercial use above certain scale requires a custom agreement. Attribution to TMDB is required.

---

*Source: [API Map](https://apimap.dev/apis/tmdb/) — CC BY 4.0*