> ## Documentation Index
> Fetch the complete documentation index at: https://docs.powerscraperpro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Keys Setup

> Get your free API keys for TMDB and Fanart.tv

# API Keys Setup

Power Scraper Pro uses external services to fetch metadata and artwork. You'll need at least a TMDB API key to get started.

## TMDB API Key (Required)

TMDB (The Movie Database) provides movie and TV show metadata including titles, plots, cast, crew, ratings, and basic artwork.

<Steps>
  <Step title="Create a TMDB Account">
    Go to [themoviedb.org](https://www.themoviedb.org/) and click **Join TMDB** in the top right.
  </Step>

  <Step title="Verify Your Email">
    Check your inbox and click the verification link.
  </Step>

  <Step title="Go to API Settings">
    Click your profile icon → **Settings** → **API** (in the left sidebar).
  </Step>

  <Step title="Request an API Key">
    Click **Create** under "Request an API Key". Choose **Developer** when asked.
  </Step>

  <Step title="Fill Out the Form">
    * **Type of Use**: Personal
    * **Application Name**: Power Scraper Pro
    * **Application URL**: [https://powerscraperpro.com](https://powerscraperpro.com)
    * **Application Summary**: Personal media library management

    Accept the terms and submit.
  </Step>

  <Step title="Copy Your API Key">
    Your API Key (v3 auth) will be displayed. Copy it.
  </Step>

  <Step title="Add to Power Scraper Pro">
    Open Power Scraper Pro → **Settings** → **API Keys** → Paste your key → Click **Validate**
  </Step>
</Steps>

<Info>
  TMDB API keys are **free** for personal use. There are no limits for typical usage.
</Info>

## Fanart.tv API Key (Optional but Recommended)

Fanart.tv provides high-quality extended artwork including clearlogos, clearart, banners, disc art, and more. These make your Kodi library look stunning.

<Steps>
  <Step title="Create a Fanart.tv Account">
    Go to [fanart.tv](https://fanart.tv/) and click **Login/Signup**.
  </Step>

  <Step title="Get Your API Key">
    Once logged in, go to your profile and find your **Personal API Key**.
  </Step>

  <Step title="Add to Power Scraper Pro">
    Open Power Scraper Pro → **Settings** → **API Keys** → Paste your Fanart.tv key → Click **Validate**
  </Step>
</Steps>

<Tip>
  With Fanart.tv enabled, you'll have access to:

  * **Clearlogo** — Transparent logo for overlays
  * **Clearart** — Character art with transparent background
  * **Banner** — Wide banner images for Kodi skins
  * **Disc Art** — CD/DVD artwork
  * **Landscape** — 16:9 thumbnail images
</Tip>

## Validating Your Keys

After entering each key, click **Validate** to test the connection:

* ✅ **Green checkmark** — Key is valid and working
* ❌ **Red X** — Key is invalid or expired

<Warning>
  Keep your API keys private. Don't share them publicly or commit them to code repositories.
</Warning>

## Where Are Keys Stored?

Power Scraper Pro stores your API keys securely in the **macOS Keychain**, not in plain text files. They're encrypted and protected by your system password.