# Imdb Listing

## Overview

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

## Description

Unlock comprehensive IMDb data including titles, years, and images with the IMDb Listing API for detailed media insights.

## 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/listing' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "results": [
    {
      "id": "tt0434409",
      "type": "feature",
      "year": "2005",
      "image": "https://m.media-amazon.com/images/M/MV5BMjA3MjUzNjM5OV5BMl5BanBnXkFtZTcwMzY4MTEzMw@@._V1_SX300.jpg",
      "title": "V for Vendetta"
    },
    {
      "id": "tt0802508",
      "type": "short",
      "year": "2006",
      "image": "https://m.media-amazon.com/images/M/MV5BMjA3MjUzNjM5OV5BMl5BanBnXkFtZTcwMzY4MTEzMw@@._V1_SX300.jpg",
      "title": "V for Vendetta: At the IMAX"
    },
    {
      "id": "tt0797054",
      "type": "video",
      "year": "2006",
      "image": "https://m.media-amazon.com/images/M/MV5BMTQ2MTA3Mjg4NF5BMl5BanBnXkFtZTcwOTc0ODkzMQ@@._V1_SX300.jpg",
      "title": "Looking Back at 'V for Vendetta'"
    },
    {
      "id": "tt1399612",
      "type": "short",
      "year": "2008",
      "image": "",
      "title": "V For Vendetta"
    },
    {
      "id": "tt1070305",
      "type": "video",
      "year": "2006",
      "image": "https://m.media-amazon.com/images/M/MV5BMWNhOTY2NTctMGI0ZS00OGE1LWI0MzgtOTIxYmI5Y2U3ZTlhXkEyXkFqcGdeQXVyNjAwMzI1NA@@._V1_SX300.jpg",
      "title": "Behind 'V For Vendetta'"
    },
    {
      "id": "tt7849572",
      "type": "video",
      "year": "2011",
      "image": "",
      "title": "V for Vendetta"
    },
    {
      "id": "tt0843697",
      "type": "short",
      "year": "2006",
      "image": "https://m.media-amazon.com/images/M/MV5BMTY2MzkxODg0M15BMl5BanBnXkFtZTcwOTU0ODkzMQ@@._V1_SX300.jpg",
      "title": "Remember, Remember: 5 Days of V for Vendetta"
    }
  ]
}
```

## Documentation

## Overview
Unlock comprehensive IMDb data including titles, years, and images with the IMDb Listing API for detailed media insights.

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

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

## Main use cases
- Integrate Imdb Listing 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