# \[ANN\] TheMovieDB.jl: Julia wrappers for TheMovieDB API v3

**URL:** https://discourse.julialang.org/t/ann-themoviedb-jl-julia-wrappers-for-themoviedb-api-v3/114114
**Category:** Package Announcements
**Tags:** package
**Created:** [May 10, 2024, 3:27pm UTC](https://discourse.julialang.org/t/ann-themoviedb-jl-julia-wrappers-for-themoviedb-api-v3/114114 "2024-05-10T15:27:24Z")
**Posts on this page:** 2
**Page:** 1

<div class="post-metadata">

### Author: ![NeroBlackstone](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/neroblackstone/32/208679_2.png) [@NeroBlackstone](https://discourse.julialang.org/u/NeroBlackstone)
#### Post date: [May 10, 2024, 3:27pm UTC](https://discourse.julialang.org/t/ann-themoviedb-jl-julia-wrappers-for-themoviedb-api-v3/114114/1 "2024-05-10T15:27:24Z")

</div>

Want to use Julia to crawl some movies for machine learning, data analysis, or complex networks? Try [TheMovieDB.jl](https://github.com/NeroBlackstone/TheMovieDB.jl)! This is a Julia wrapper for [The Movie DB](https://www.themoviedb.org/) API v3 out of the box.

## Easy Start

Please apply for your [themoviedb API Read Access Token](https://www.themoviedb.org/settings/api) first. Then paste your api key at `$HOME/.config/TMDB_KEY.txt`. Or save api key to `TMDB_KEY` environment variable.

It’s been a long time since I went to the cinema. What movies are showing recently?

```julia-repl
julia> using TheMovieDB
julia> api = init_api()
julia> first(movie_now_playing_list(api))
{
  "dates": {
    "maximum": "2024-05-08",
    "minimum": "2024-03-27"
  },
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/qrGtVFxaD8c7et0jUtaYhyTzzPg.jpg",
      "genre_ids": [
        28,
        878,
        12
      ],
      "id": 823464,
      "original_language": "en",
      "original_title": "Godzilla x Kong: The New Empire",
      "overview": "Following their explosive showdown, Godzilla and Kong must reunite against a colossal undiscovered threat hidden within our world, challenging their very existence – and our own.",
      "popularity": 1773.662,
      "poster_path": "/1DTP1Ph4uzNO6ofRUm7eAimWoKD.jpg",
      "release_date": "2024-03-27",
      "title": "Godzilla x Kong: The New Empire",
      "video": false,
      "vote_average": 6.462,
      "vote_count": 956
    }...
  ]
}

```

Godzilla x Kong… Please add Ultraman next time, I am very curious who is more powerful among the three of them.

---

<div class="post-metadata">

### Author: ![jd-foster](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/jd-foster/32/35824_2.png) [@jd-foster](https://discourse.julialang.org/u/jd-foster)
#### Post date: [May 11, 2024, 11:41am UTC](https://discourse.julialang.org/t/ann-themoviedb-jl-julia-wrappers-for-themoviedb-api-v3/114114/2 "2024-05-11T11:41:34Z")

</div>

@dmbates has wanted this since at least 2022!

> [@Wrapping the API for themoviedb.org](https://discourse.julialang.org/t/wrapping-the-api-for-themoviedb-org/84281):
>
> While looking at the [movielens.org](http://movielens.org) ml-25m data set (see [ml-25m - Downloading and examining the MovieLens 25m data](https://dmbates.github.io/ml-25mjl)) I encountered an online movie/tv-show database called [themoviedb.org](http://themoviedb.org) that provides a public API, [API Overview — The Movie Database (TMDB)](https://www.themoviedb.org/documentation/api) There are implementations of wrappers around this API for several languages, [API Wrappers & Libraries — The Movie Database (TMDB)](https://www.themoviedb.org/documentation/api/wrappers-libraries). See, for example, the Python wrapper [GitHub - celiao/tmdbsimple: A wrapper for The Movie Database API v3.](https://github.com/celiao/tmdbsimple). I thou…