Name: IMDb – Movie & TV Data | Free · $5/mo | API.market
Brand: sleeyax
SKU: api-sleeyax-imdb
Availability: InStock
Author: API Market

Sleeyax

# IMDb API

## Overview

The IMDb API provides comprehensive access to a vast collection of movie and TV show data, including titles, actors, ratings, cast and crew details, posters, and much more.  This API offers a reliable and efficient way to integrate IMDb data into your applications, replacing unreliable web scraping methods with a robust and well-documented solution.

## Features

* **Extensive Data Coverage:** Access a wide range of IMDb data points, from basic title information to detailed cast and crew listings.
* **Advanced Search & Filtering:**  Filter search results by genres, keywords, ratings, languages, countries, awards, and more.
* **Reliable Data Source:**  Acts as a robust wrapper around IMDb's own API, ensuring accurate and up-to-date information.
* **OpenAPI Support:**  Integrate seamlessly with your preferred HTTP libraries and tools using the provided OpenAPI specification.
* **Asynchronous Processing:**  Handle large requests efficiently with asynchronous processing and status checking.

## Use Cases

* **Entertainment Websites and Apps:** Power search functionality, display detailed movie information, and provide personalized recommendations.
* **Data Analysis and Research:** Analyze trends in film and television, study the impact of different factors on ratings, and gather data for academic research.
* **Content Recommendation Systems:**  Develop personalized content recommendation engines based on user preferences and viewing history.
* **Media Archiving and Management:** Organize and manage large media libraries with accurate metadata from IMDb.
* **Competitive Analysis:** Track the performance of movies and TV shows, analyze competitor strategies, and identify market trends.


## Pricing

* 1 API unit equals 1 search request.
* GET requests to check prediction status (`GET /api/v1/magicapi/imdb/predictions/{id}`) are free.
* Contact hello[at]api.market for pricing tiers based on usage volume.


## API Documentation

### Base URL

`https://prod.api.market/api/v1/magicapi/imdb`

### Authentication

Include your API key in the request header:

```
x-magicapi-key: YOUR_API_MARKET_KEY
```

### Asynchronous Processing

This API uses asynchronous processing.

1. **Submit Request:** Send a POST request to the relevant endpoint.
2. **Receive ID:**  The response will contain a prediction ID.
3. **Check Status:** Poll the GET endpoint (`/api/v1/magicapi/imdb/predictions/{id}`) with the prediction ID.
4. **Poll Until Complete:** Continue polling until the status is "succeeded" or "failed".  Use a polling interval of 1 second and a maximum timeout of 600 seconds (10 minutes).

### Endpoints


#### Get Title Types

```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/imdb/title-types" -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Response:**

```json
[
  "movie",
  "tvSeries",
  "short",
  // ... other types
]
```

#### Get Genres

```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/imdb/genres" -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Response:**

```json
[
  "Action",
  "Adventure",
  "Animation",
  // ... other genres
]
```

#### Advanced Search

```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/imdb/search/advanced?query=batman&limit=2&types=movie" -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Parameters:** (See OpenAPI schema for full list and details)

* `query`: Search term.
* `sortBy`: Sort field (e.g., POPULARITY, USER_RATING).
* `sortOrder`: Sort order (ASC or DESC).
* `limit`: Number of results (1-100).
* `types`: Array of title types (e.g., movie, tvSeries).
* `imdbRatingMin`: Minimum IMDb rating.
*  `genres`: Array of genres.


**Response:** (Simplified Example)

```json
{
  "titles": [
    {
      "id": "tt0000001",
      "primaryTitle": "Carmencita",
      "primaryImage": {
        "url": "https://example.com/image1.jpg",
        "width": 100,
        "height": 150
      },
      // ... other fields
    },
     {
      "id": "tt0000002",
      "primaryTitle": "Le clown et ses chiens",
      "primaryImage": {
        "url": "https://example.com/image2.jpg",
        "width": 100,
        "height": 150
      },
      // ... other fields
    }
  ],
  "totalResults": 2,
  "pagination": {
    "hasPreviousPage": false,
    "hasNextPage": true,
    "startCursor": null,
    "endCursor": "some_cursor"
  }
}
```

## Status Codes

* 200 OK: Success.
* 201 Created: Resource created.
* 400 Bad Request: Invalid input.
* 401 Unauthorized: Invalid API key.
* 404 Not Found: Resource not found.
* 429 Too Many Requests: Rate limit exceeded.
* 500 Internal Server Error: Server error.
* 503 Service Unavailable: Service unavailable.


## Rate Limits

Contact hello[at]api.market for details on rate limits.

## Error Handling

Error responses are in JSON format:

```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid 'limit' value",
    "status": 400
  }
}
```

## Implementation Guide

### Example Code (See detailed examples with polling and timeout handling in the prompt response above)



### Performance Optimization

* Use appropriate filtering to reduce the number of results.
* Implement efficient polling and caching strategies.

## FAQ

* **Q: How do I get an API key?**  A: Contact hello[at]api.market.
* **Q: What data is available through the API?** A: See the OpenAPI schema and documentation for details.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello[at]api.market.

Get movie & TV data: titles, actors, ratings, cast & crew. Free 100 calls/mo, from $5/mo. Start free on API.market.

IMDb – Movie & TV Data | Free · $5/mo | API.market