# Documentazione di amodb > Parti dall'avvio rapido per fare la prima chiamata in due minuti. Poi leggi come funzionano chiavi, limiti di richieste, errori, lingue e immagini. amodb mantiene i percorsi e il JSON di TMDB v3 e OMDb, quindi la maggior parte delle pagine spiega cosa è uguale, cosa aggiunge amodb e i pochi punti in cui differisce. ## URL di base | Uso | URL di base | Parametro della chiave | | ------------------ | ----------------------------------------- | ---------------------------------------- | | Stile TMDB v3 | `https://api.amodb.dev/3` | `api_key` oppure `Authorization: Bearer` | | Stile OMDb | `https://api.amodb.dev/omdb/` | `apikey` | | Immagini | `https://img.amodb.dev/t/p/{size}/{file}` | nessuno | | Catalogo dei piani | `https://api.amodb.dev/plans` | nessuno | ### Per iniziare - [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. - [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. ### Concetti - [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. - [Errori](https://amodb.dev/it/errors/): Ogni errore di amodb con stato HTTP, status_code e messaggio TMDB, più la forma dell'errore OMDb. Cosa significa ciascuno e cosa deve fare il tuo client. - [Lingue](https://amodb.dev/it/languages/): amodb serve titoli, trame e nomi in 14 lingue. Passa un tag in stile TMDB come ru-RU o pt-BR in language; qualsiasi altro tag ripiega sull'inglese. - [Immagini](https://amodb.dev/it/images/): Carica locandine, sfondi e foto dei profili da img.amodb.dev con percorsi e dimensioni TMDB da w92 a original. Nessuna chiave, cache di 30 giorni, uno schema. ### Riferimento API - [API dei dettagli del film](https://amodb.dev/it/movies/): API dettagli film con gli stessi percorsi e JSON di TMDB v3. Ottieni un film per ID, aggiungi crediti, valutazioni e mood con append_to_response, in 14 lingue. - [API delle serie TV](https://amodb.dev/it/tv-series/): API serie TV con gli stessi percorsi e JSON di TMDB v3. Ottieni una serie per ID con stagioni, emittenti e prossimo episodio, più classificazioni e piattaforme. - [API di stagioni ed episodi delle serie TV](https://amodb.dev/it/tv-seasons-episodes/): API stagioni ed episodi con gli stessi percorsi e JSON di TMDB v3. Leggi una stagione con tutti gli episodi, o un episodio con data, durata e immagine. - [API dei dettagli della persona](https://amodb.dev/it/people/): API dettagli persona con gli stessi percorsi e JSON di TMDB v3. Ottieni attore o troupe per ID, con biografia, filmografia, ID esterni e lista dei popolari. - [API dei crediti](https://amodb.dev/it/credits/): API crediti con gli stessi percorsi e JSON di TMDB v3. Ottieni cast e troupe di film, serie, stagioni ed episodi, con i campi order, department e job. - [API di ricerca](https://amodb.dev/it/search/): API di ricerca con percorsi e JSON di TMDB v3. Trova film, serie, persone, collezioni, società e parole chiave per testo, con filtri anno e paginazione. - [API Discover](https://amodb.dev/it/discover/): API Discover con gli stessi filtri di TMDB v3. Elenca film e serie TV per genere, cast, società, parola chiave, anno, voto, durata e piattaforma. - [Tendenze e endpoint delle liste](https://amodb.dev/it/trending-lists/): API tendenze con percorsi TMDB v3: classifiche giorno e settimana, più liste di film e serie in sala, popolari, più votati e in arrivo, cache di 30 minuti. - [Generi e liste di riferimento](https://amodb.dev/it/genres/): API generi con percorsi TMDB v3: ID dei generi di film e serie TV con nomi tradotti, più liste di paesi, lingue, mestieri, classificazioni e piattaforme. - [API delle immagini e host delle immagini](https://amodb.dev/it/images-api/): API immagini dei film con percorsi TMDB v3: elenca locandine, sfondi, loghi e fermi immagine di ogni titolo e caricali da img.amodb.dev in 10 dimensioni. - [API dei video e dei trailer](https://amodb.dev/it/videos-trailers/): API video con percorsi TMDB v3: elenca trailer, teaser, clip e featurette di un film o serie TV, poi filtra per tipo e lingua nel tuo codice. - [API delle traduzioni](https://amodb.dev/it/translations/): API traduzioni con percorsi TMDB v3: leggi titoli, trame e slogan di un film, una serie o un episodio in tutte le loro lingue in una volta sola. - [API delle parole chiave](https://amodb.dev/it/keywords/): API parole chiave con percorsi TMDB v3: elenca i tag di trama di un film o serie, cerca una parola chiave, i suoi film e combina with_keywords con discover. - [API delle collezioni](https://amodb.dev/it/collections/): API collezioni di film con percorsi TMDB v3: recupera una saga per ID con tutte le sue parti, leggi belongs_to_collection su un film e cerca per nome. - [Società ed emittenti](https://amodb.dev/it/companies-networks/): Cerca case di produzione ed emittenti TV con i percorsi TMDB v3. Leggi nome, paese e logo per ID, poi filtra discover per ID di società o emittente. - [Valutazioni di film e serie TV](https://amodb.dev/it/ratings/): API valutazioni film: punteggi IMDb, Kinopoisk, Metacritic, Rotten Tomatoes e TMDB di un titolo in una chiamata, con null per le fonti non note. - [Ricerca per ID esterno](https://amodb.dev/it/find-by-external-id/): Cerca un film, una serie o una persona per ID IMDb, TVDB, Wikidata o Kinopoisk con l'endpoint find di TMDB, e leggi ID esterni e dati Wikidata di un titolo. - [Endpoint compatibile OMDb](https://amodb.dev/it/omdb-endpoint/): Endpoint compatibile OMDb su api.amodb.dev/omdb/. Cerca con i o t, ricerca con s, leggi l'array Ratings e tieni il tuo client cambiando solo l'URL di base. - [Indicatori di mood](https://amodb.dev/it/moods/): API mood dei film con indicatori da 0 a 10 per titolo. Leggi i mood di un film o serie, uniscili con append_to_response=moods e costruisci badge o filtri. - [Colonne sonore](https://amodb.dev/it/soundtracks/): API colonne sonore che restituisce l'album di un film o serie TV con la lista dei brani. Chiama l'endpoint o aggiungi append_to_response=soundtracks. - [Orari delle proiezioni al cinema](https://amodb.dev/it/showtimes/): API orari delle proiezioni: restituisce cinema e orari di un film in un paese, o un riepilogo per paese. Uniscila ai dettagli o abbinala a now_playing. ### Risorse - [Registro delle modifiche](https://amodb.dev/it/changelog/): Elenco datato delle modifiche all'API amodb, all'host immagini img.amodb.dev, ai piani e al sito. Le novità vanno in cima, con cosa è cambiato e cosa devi fare. - [Stato](https://amodb.dev/it/status/): Come sapere se amodb è attivo: l'endpoint di salute pubblico, i codici di errore che indicano un incidente e come segnalare un problema con i dettagli giusti. - [Riferimento API](https://amodb.dev/it/reference/): Ogni endpoint amodb con percorso, parametri, esempi di richiesta in cinque linguaggi e una vera risposta JSON. Compatibile con TMDB v3 e OMDb. - [Tutorial](https://amodb.dev/it/tutorials/): Tutorial passo per passo per l'API amodb: ricerca, dettagli, immagini, lingue e chiamate OMDb negli stack più comuni, con codice da copiare ed eseguire. - [Confronta amodb](https://amodb.dev/it/compare/): Confronti diretti tra amodb e altre API di metadati su film e serie TV: compatibilità, lingue, limiti, immagini e prezzi, con numeri che puoi verificare. - [Casi d'uso](https://amodb.dev/it/use-cases/): Come i team usano amodb per dati su film e serie TV: cataloghi, media server, raccomandazioni, bot e ricerca, con gli endpoint e i limiti di ogni caso. ## Pagine correlate - [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. - [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. - [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. Aggiornato: 2026-10-18. Source: https://amodb.dev/it/docs/