# OMDb API

**Provider:** OMDb
**Category:** entertainment
**Base URL:** `https://www.omdbapi.com`
**Auth:** api-key — `GET /?apikey=YOUR_KEY&t=Inception`
**Rate Limit:** 1,000 requests/day (free tier)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://www.omdbapi.com/

## Description

The Open Movie Database API — a free web service to obtain movie, series, and episode information including ratings, plot, cast, and poster images.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://www.omdbapi.com/?t={title}` | Search movie by title |
| GET | `https://www.omdbapi.com/?i={imdbID}` | Search by IMDb ID |
| GET | `https://www.omdbapi.com/?s={search}` | Search movies by keyword |
| GET | `https://www.omdbapi.com/?t={title}&type=series` | Search TV series by title |
| GET | `https://www.omdbapi.com/?i={imdbID}&Season=1` | Get season episodes |

## Authentication

API key as a query parameter (apikey)

```
GET /?apikey=YOUR_KEY&t=Inception
```

## Sample Request

```bash
curl 'https://www.omdbapi.com/?t=Inception&apikey=YOUR_KEY'
```

## Sample Response

```json
{"Title":"Inception","Year":"2010","imdbRating":"8.8","Genre":"Action, Adventure, Sci-Fi","Director":"Christopher Nolan"}
```

## Pricing Details

Free tier with daily limit; Patron plans at $1–$5/month for higher quotas.

---

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