# Chiave API TMDB: una chiave compatibile in circa 1 minuto

> Per ottenere una chiave API TMDB per un progetto commerciale, accedi ad amodb con email e un codice monouso, paga un piano e crea la chiave. Servono circa un minuto. La chiave ha la forma di TMDB v3, quindi cambi l'URL di base e tieni il tuo codice. Non esiste un piano gratuito.

## Ottieni una chiave compatibile con TMDB in quattro passaggi

amodb vende chiavi per la propria API, che mantiene i percorsi e il JSON di TMDB v3. Non è una chiave di TMDB e non funziona su api.themoviedb.org. Quello che ricevi è una chiave con la stessa forma, 32 caratteri esadecimali minuscoli, che il tuo client TMDB accetta dopo un solo cambio di URL di base.

1. Apri [prezzi](https://amodb.dev/it/pricing/) e scegli un piano: 20, 40 o 120 richieste al minuto. Ogni piano restituisce tutti i dati.
2. Accedi con la tua email. amodb invia un codice di 6 cifre valido per 10 minuti. Non c'è nessuna password.
3. Paga con carta, Apple Pay o Google Pay per un periodo da 1 a 24 mesi. Nulla si rinnova automaticamente.
4. Apri **Account**, poi **Chiavi API**, e crea una chiave. Copiala subito, perché la chiave completa viene mostrata una sola volta.

I passaggi richiedono circa un minuto, e la chiave funziona appena il pagamento è confermato.

## Usa la chiave: cambia l'URL di base

Mantieni il tuo codice TMDB e cambia due valori, l'URL di base e la chiave. Funzionano entrambi i modi di inviare la chiave, `api_key` nella query e un header `Authorization: Bearer`.

```bash
# TMDB
curl "https://api.themoviedb.org/3/movie/550?api_key=$TMDB_KEY"

# amodb
curl "https://api.amodb.dev/3/movie/550?api_key=$AMODB_KEY"
```

La stessa chiamata con un header Bearer, in tre linguaggi:

```bash
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
```

```js
const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
if (!res.ok) throw new Error(`amodb ${res.status}`);
const movie = await res.json();
console.log(movie.title, movie.release_date);
```

```python
import os
import requests

res = requests.get(
    "https://api.amodb.dev/3/movie/550",
    params={"language": "en-US"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
res.raise_for_status()
movie = res.json()
print(movie["title"], movie["release_date"])
```

La risposta ha la forma di TMDB v3:

```json
{
  "id": 550,
  "imdb_id": "tt0137523",
  "title": "Fight Club",
  "release_date": "1999-10-15",
  "runtime": 139,
  "genres": [{ "id": 18, "name": "Drama" }],
  "vote_average": 8.4,
  "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
}
```

Leggi `images.secure_base_url` da `/3/configuration` così i link delle locandine puntano a `img.amodb.dev`. Le immagini non richiedono chiave. Altri dettagli sull'invio della chiave sono in [autenticazione](https://amodb.dev/it/authentication/), e una guida più lunga è nell'[avvio rapido](https://amodb.dev/it/quickstart/).

## Una chiave TMDB gratuita e una chiave amodb a confronto

La scelta giusta dipende dal tuo progetto e dalle tue condizioni, non da un elenco di funzioni. La colonna TMDB ripete soltanto ciò che TMDB pubblica in generale. Leggi i termini e la documentazione di TMDB per le regole attuali.

|                      | Chiave TMDB gratuita                                          | Chiave amodb                                                                                                |
| -------------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Prezzo               | Gratis per usi idonei secondo i termini di TMDB               | A pagamento, prepagata da 1 a 24 mesi, senza prova                                                          |
| Come si ottiene      | Un account TMDB e una richiesta di chiave sul sito di TMDB    | Email, codice di 6 cifre, pagamento, poi crei la chiave nel tuo account                                     |
| Uso commerciale      | Controlla i termini di TMDB su uso commerciale e attribuzione | Consentito dai termini di amodb                                                                             |
| Limite di richieste  | Stabilito da TMDB, controlla la loro documentazione           | 20, 40 o 120 richieste al minuto in base al piano                                                           |
| Dati                 | Dati TMDB                                                     | Forma TMDB v3, più `ratings`, `moods`, `soundtracks`, `wikidata` e `showtimes` tramite `append_to_response` |
| Formato della chiave | Chiave v3, 32 caratteri esadecimali                           | 32 caratteri esadecimali minuscoli                                                                          |
| URL di base          | `https://api.themoviedb.org/3`                                | `https://api.amodb.dev/3`                                                                                   |
| Metodi di scrittura  | Metodi per account, liste e valutazioni                       | Non offerti, rispondono 405                                                                                 |

## Quando basta una chiave TMDB gratuita

Resta su una chiave TMDB gratuita per un progetto personale o di studio che rientra nei termini di TMDB. Se il tuo uso è idoneo, TMDB non costa nulla e amodb non può competere.

Usa una chiave amodb quando il progetto è commerciale e vuoi un accordo a pagamento, quando ti serve un limite fisso al minuto su cui pianificare, o quando la pagina di un titolo deve ricevere le valutazioni di cinque fonti in una sola chiamata. Controlla prima le lacune: metodi di scrittura, feed delle modifiche e alcuni altri percorsi non sono offerti. Sono elencati in [alternativa all'API TMDB](https://amodb.dev/it/tmdb-api-alternative/) e in [amodb vs TMDB](https://amodb.dev/it/amodb-vs-tmdb/).

## Uso commerciale e limiti

L'uso commerciale è consentito dai [termini](https://amodb.dev/it/terms/) di amodb. Puoi mostrare i dati nelle tue app, nei siti, nei bot e negli strumenti interni, e mettere in cache le risposte per risparmiare richieste. Non puoi rivendere l'accesso grezzo all'API, pubblicare dump in blocco, condividere le chiavi né aprire account extra per alzare la tua frequenza. L'elenco completo è nella [politica di utilizzo accettabile](https://amodb.dev/it/acceptable-use/).

Il piano stabilisce la frequenza. Ogni risposta include `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset`, e un 429 aggiunge `Retry-After`. I dettagli sono nei [limiti di richieste](https://amodb.dev/it/rate-limits/).

## Domande e risposte

### Questa è una chiave API TMDB?

No. È una chiave amodb. Ha la stessa forma di una chiave TMDB v3, 32 caratteri esadecimali minuscoli, e funziona sui percorsi di amodb compatibili con TMDB v3 su https://api.amodb.dev/3. Non funziona su api.themoviedb.org, e amodb è un servizio indipendente.

### Posso ottenere gratis una chiave API TMDB?

TMDB offre una chiave gratuita per usi idonei secondo i propri termini, e la richiedi sul sito di TMDB. amodb non ha un piano gratuito né una prova, quindi una chiave amodb arriva sempre con un piano a pagamento. Leggi i termini di TMDB prima di decidere quale ti serve.

### Posso ottenere una chiave API TMDB senza registrazione?

Non su amodb. Accedi con un'email e un codice di 6 cifre, senza password e senza modulo di richiesta, poi paghi e crei la chiave. Una chiave TMDB richiede un account TMDB, quindi controlla il sito di TMDB per i passaggi attuali.

### Posso usare la chiave in un progetto commerciale?

Sì. L'uso commerciale è consentito dai termini di amodb. Usa i dati nelle tue app e nei tuoi siti, ma non rivendere l'accesso grezzo all'API, non condividere la chiave e non metterla nel codice lato client.

### Quante richieste può fare una chiave?

Il piano stabilisce la frequenza: 20, 40 o 120 richieste al minuto per chiave, contate in una finestra scorrevole di 60 secondi. Ogni piano restituisce tutti i dati e non c'è un limite giornaliero.

## Pagine correlate

- [Alternativa all'API TMDB](https://amodb.dev/it/tmdb-api-alternative/): Cerchi un'alternativa all'API TMDB? Confronta condizioni, limiti e lingue, poi passa a un'API a pagamento che mantiene i percorsi di lettura TMDB v3.
- [Avvio rapido](https://amodb.dev/it/quickstart/): Fai la prima chiamata ad amodb: ottieni una chiave, richiedi i dettagli di un film in curl, JavaScript, Python, PHP o Go, carica la locandina. Meno di 2 minuti.
- [Prezzi](https://amodb.dev/it/pricing/): I piani amodb differiscono solo per le richieste al minuto: 20, 40 o 120. Ogni piano include tutti i dati TMDB v3 e OMDb. Prepagato, senza rinnovo né prova.
- [Autenticazione](https://amodb.dev/it/authentication/): Come inviare la chiave amodb: api_key nella query, un header Authorization Bearer o apikey per le chiamate OMDb. Formato, conservazione, rotazione, errori 401.
- [amodb vs TMDB](https://amodb.dev/it/amodb-vs-tmdb/): Confronto diretto tra amodb e TMDB: parità degli endpoint, percorsi non offerti, condizioni gratuite o a pagamento, 14 lingue, estensioni e limiti di richieste.
- [Limiti di richieste](https://amodb.dev/it/rate-limits/): amodb limita ogni chiave per richieste al minuto in una finestra scorrevole di 60 secondi: 20, 40 o 120 in base al piano. Leggi gli header, gestisci il 429.

Aggiornato: 2026-10-19. Source: https://amodb.dev/it/tmdb-api-key/