Import Movie Database (TMDb) Data to Google Sheets
In this guide, we’ll walk through how to pull movie and tv data from the community-driven site known as The Movie Database (TMDb) directly into Google Sheets, using the API Connector add-on for Sheets. We’ll first get an API key from TMDb, and then set up a request to pull in movie data to your spreadsheet.
- Before You Begin
- Part 1: Get your TMDb API Key
- Part 2: Create your API Request URL
- Part 3: Pull TMDb API Data into Sheets
- Part 4: More Example API URLs
- Part 5: Handle Pagination
- Part 6: API Documentation
Before You Begin
Click here to install the API Connector add-on from the Google Marketplace.
Part 1: Get Your TMDb API Key
- If you haven’t already, sign up for an account at https://www.themoviedb.org/account/signup
- While logged in, navigate to your account settings page and then click API. Alternately, you can click this link to go there directly: https://www.themoviedb.org/settings/api
- Generate a new API key by clicking the link in the “Request a new API key” section:
- You’ll be prompted to select the appropriate type of API key for your project:
- You will be asked to describe how you will use the API data you retrieve. While we aren’t exactly making an app, fill out all required fields as best as possible and click Submit.
- A new screen will appear showing your API keys. Congrats, you now have access to the TMDb API! Note that you can use either the API Key (v3 auth) or API Read Access Token (v4 auth) key for making requests to the API. However, since the v4 authentication method is newer and can be used across both API versions, this tutorial will use the v4 auth key.
Part 2: Create Your TMDb API Request URL
We’ll first get a ranked list of the top rated movies on TMDb.
- API root: https://api.themoviedb.org
- Endpoint: /3/movie/top_rated
Putting it all together, we get the full API Request URL:
Part 3: Pull TMDb API Data into Sheets
Now let’s paste that URL into API Connector and import TMDb data into Google Sheets.
- Open up Google Sheets and click Extensions > API Connector > Open.
- In the Create screen, enter the Request URL we just created
- Under Headers, enter two sets of key-value pairs like this:
Authorization Bearer YOUR_API_READ_ACCESS_TOKEN Content-Type application/json;charset=utf-8
Replace YOUR_API_READ_ACCESS_TOKEN with the read access token you got above in part 1, step 7.
- Create a new tab and click Set current to use that tab as your data destination.
- Name your request and click Run. A moment later you’ll see a list of top rated movies populate your Google Sheets.
Part 4: More Example API URLs
You can check the documentation for the full list of available API requests, but if you just want to jump in, you can play around with the URLs you enter in the API URL path field. Try the following (one at a time):
Part 5: Handle Pagination
- The TMDb API limits the number of records returned in each request. By default, only the first page of records will be returned unless you use the ‘page’ parameter, and each page contains 20 records.
- With API Connector you can either run these paginated request URLs manually or loop through them automatically with pagination handling (paid feature), like this:
- API URL: enter your regular request URL
- Pagination type:
- Page parameter:
- Number of pages: enter the number of pages you’d like to fetch
Part 5: API Documentation
v3 API documentation: https://developers.themoviedb.org/3/getting-started/introduction
v4 API documentation: https://developers.themoviedb.org/4/getting-started