# Imdb Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/imdb/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/imdb-product |

## Description

Unlock extensive film details from IMDb. Enhance databases, recommend systems, and analytics with our Imdb Product API.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/imdb/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "plot": "In a future British tyranny, a shadowy freedom fighter, known only by the alias of 'V', plots to overthrow it with the help of a young woman.",
  "type": "movie",
  "year": "2005",
  "genre": [
    "Action",
    "Drama",
    "Sci-Fi"
  ],
  "rated": "R",
  "title": "V for Vendetta",
  "actors": [
    "Hugo Weaving",
    "Natalie Portman",
    "Rupert Graves",
    "Stephen Rea"
  ],
  "awards": "Nominee for 1 BAFTA Award, 6 wins & 26 nominations total",
  "imdbID": "tt0434409",
  "poster": "https://m.media-amazon.com/images/M/MV5BMTM4OGQ1OTAtNDIxYy00MDA3LWJkYTctNDY4NmMyNGMxYjVkXkEyXkFqcGdeQXVyNjU0OTQ0OTY@._V1_UX182_CR0,0,182,268_AL_.jpg",
  "writer": [
    "Lilly Wachowski (screenplay)",
    "Lana Wachowski (screenplay)",
    "David Lloyd (graphic novel illustrator)",
    "Alan Moore (graphic novel)"
  ],
  "country": [
    "United Kingdom",
    " United States",
    "Germany"
  ],
  "ratings": [
    {
      "value": "8.2/10",
      "source": "Internet Movie Database"
    },
    {
      "value": "73%",
      "source": "Rotten Tomatoes"
    },
    {
      "value": "62/100",
      "source": "Metacritic"
    }
  ],
  "runtime": "132 min",
  "website": "N/A",
  "director": "James McTeigue",
  "language": [
    "English"
  ],
  "released": "17 Mar 2006",
  "boxOffice": "$70,511,035",
  "imdbVotes": "1,092,758",
  "metascore": "62",
  "imdbRating": "8.2",
  "production": "Warner Bros., Virtual Studios, Silver Pictures"
}
```

## Documentation

## Overview
Unlock extensive film details from IMDb. Enhance databases, recommend systems, and analytics with our Imdb Product API.

## Quickstart
```
GET https://api.piloterr.com/v2/imdb/product?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Imdb Product data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Imdb without maintaining scrapers
- Power internal dashboards and workflow automations with live Imdb data