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.
- Apri prezzi e scegli un piano: 20, 40 o 120 richieste al minuto. Ogni piano restituisce tutti i dati.
- Accedi con la tua email. amodb invia un codice di 6 cifre valido per 10 minuti. Non c'è nessuna password.
- Paga con carta, Apple Pay o Google Pay per un periodo da 1 a 24 mesi. Nulla si rinnova automaticamente.
- 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.
# 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:
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
-H "Authorization: Bearer $AMODB_KEY"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);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:
{
"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, e una guida più lunga è nell'avvio rapido.
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:/ | https:/ |
| 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 e in amodb vs TMDB.
Uso commerciale e limiti
L'uso commerciale è consentito dai termini 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.
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.