# IMDb Search

## Overview

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

## Description

Integrate IMDb movie data seamlessly to enhance user experience and SEO performance. Try our IMDb Search API now!

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

## Example Response

### Example

```json
{
  "cast": [
    {
      "name": "Tim Robbins",
      "character": "Andy Dufresne"
    },
    {
      "name": "Morgan Freeman",
      "character": "Ellis Boyd 'Red' Redding"
    },
    {
      "name": "Bob Gunton",
      "character": "Warden Norton"
    },
    {
      "name": "William Sadler",
      "character": "Heywood"
    }
  ],
  "plot": "Two imprisoned men bond over a number of years, finding solace and eventual redemption through acts of common decency.",
  "year": 1994,
  "title": "The Shawshank Redemption",
  "genres": [
    "Drama"
  ],
  "rating": "R",
  "writers": [
    "Stephen King (based on the short novel 'Rita Hayworth and the Shawshank Redemption' by)",
    "Frank Darabont (screenplay)"
  ],
  "director": "Frank Darabont",
  "duration": "142 min",
  "keywords": [
    "prison",
    "escape",
    "friendship",
    "hope"
  ],
  "ratingDetails": {
    "IMDb": 9.3
  }
}
```

## Documentation

## Overview
Integrate IMDb movie data seamlessly to enhance user experience and SEO performance. Try our IMDb Search API now!

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

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

## Main use cases
- Integrate IMDb Search 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