Get an API key

API reference

This index lists every amodb endpoint. Each page shows the TMDB v3 or OMDb compatible path, the query parameters, request samples in curl, JavaScript, Python, PHP and Go, and a real JSON response. Use one key for all of them, with api_key, a Bearer header or apikey.

  • GET Movie details API

    /3/movie/{movie_id}

    Movie details API with the same paths and JSON as TMDB v3. Get one movie by id, add credits, ratings and moods with append_to_response, in 14 languages.

  • GET TV series API

    /3/tv/{series_id}

    TV series API with the same paths and JSON as TMDB v3. Get a show by id with seasons, networks and the next episode, plus content ratings and watch providers.

  • GET TV seasons and episodes API

    /3/tv/{series_id}/season/{season_number}

    TV seasons and episodes API with the same paths and JSON as TMDB v3. Read a season with all its episodes, or one episode with air date, runtime and still.

  • GET Person details API

    /3/person/{person_id}

    Person details API with the same paths and JSON as TMDB v3. Get an actor or crew member by id, with biography, filmography, external ids and the popular list.

  • GET Credits API

    /3/movie/{movie_id}/credits

    Credits API with the same paths and JSON as TMDB v3. Get cast and crew for movies, series, seasons and episodes, with order, department and job fields.

  • GET Search API

    /3/search/movie

    Search API with the same paths and JSON as TMDB v3. Find movies, TV shows, people, collections, companies and keywords by text, with year filters and paging.

  • GET Discover API

    /3/discover/movie

    Discover API with the same filters as TMDB v3. List movies and TV shows by genre, cast, company, keyword, year, rating, runtime and provider, with sorting.

  • GET Trending and list endpoints

    /3/trending/{media_type}/{time_window}

    Trending movies API with TMDB v3 paths: day and week charts, plus now playing, popular, top rated and upcoming lists for movies and TV, cached for 30 minutes.

  • GET Genres and lookup lists

    /3/genre/movie/list

    Genre list API with TMDB v3 paths: movie and TV genre ids with translated names, plus countries, languages, jobs, certifications and watch provider lists.

  • GET Images API and image host

    /3/movie/{movie_id}/images

    Movie images API with TMDB v3 paths: list posters, backdrops, logos and stills per title, then load them from img.amodb.dev in 10 sizes with no key.

  • GET Videos and trailers API

    /3/movie/{movie_id}/videos

    Movie videos API with TMDB v3 paths: list trailers, teasers, clips and featurettes for a movie or series, then filter by type and language in your code.

  • GET Translations API

    /3/movie/{movie_id}/translations

    Movie translations API with TMDB v3 paths: read every stored title, overview and tagline of a movie, series or episode in all its languages at once.

  • GET Keywords API

    /3/movie/{movie_id}/keywords

    Movie keywords API with TMDB v3 paths: list plot tags for a movie or series, look up a keyword, list its movies and combine ids with discover with_keywords.

  • GET Collections API

    /3/collection/{collection_id}

    Movie collections API with TMDB v3 paths: fetch a franchise by id with all its parts, read belongs_to_collection on a movie, and search collections by name.

  • GET Companies and networks

    /3/company/{company_id}

    Look up production companies and TV networks with TMDB v3 paths. Read name, country and logo by id, then filter discover by company or network id.

  • GET Movie and TV ratings

    /3/movie/{movie_id}/ratings

    Movie ratings API that returns IMDb, Kinopoisk, Metacritic, Rotten Tomatoes and TMDB scores for a title in one call, with null for any source not known.

  • GET Find by external id

    /3/find/{external_id}

    Look up a movie, series or person by IMDb, TVDB, Wikidata or Kinopoisk id with the TMDB find endpoint, and read external ids and Wikidata facts for a title.

  • GET OMDb compatible endpoint

    /omdb/

    OMDb API compatible endpoint at api.amodb.dev/omdb/. Look up by i or t, search with s, read the Ratings array and keep your client by changing the base URL.

  • GET Mood meters

    /3/movie/{movie_id}/moods

    Movie mood API with 0 to 10 mood meters per title. Read moods for a movie or series, merge them with append_to_response=moods and build badges or filters.

  • GET Soundtracks

    /3/movie/{movie_id}/soundtracks

    Movie soundtrack API that returns the soundtrack album of a movie or TV series with its track list. Call the endpoint or add append_to_response=soundtracks.

  • GET Cinema showtimes

    /3/movie/{movie_id}/showtimes

    Movie showtimes API that returns venues and screening times for a movie in one country, or a country summary. Merge it into details or pair it with now_playing.