# The Movie Database (TMDB)

Track new movies and TV shows across your favorite streaming services - all in one place with AI-powered discovery.

Connect Weavestream to The Movie Database (TMDB) to monitor:

• 🎬 New releases on Netflix, Amazon Prime, Hulu, Disney+, and more
• 📺 TV shows premiering on your streaming services
• ⭐ Trending content across platforms
• 🔍 Search & discovery using AI to find what to watch

Estimated Setup Time: 5 minutes

• Free TMDB account (we'll create one together)
• Weavestream installed on your Mac

1. Go to https://www.themoviedb.org/signup
2. Fill in:
   • Username
   • Email
   • Password
3. Click "Sign Up"
4. Check your email and verify your account

1. Sign into TMDB at https://www.themoviedb.org
2. Click on your profile icon (top right)
3. Select "Settings"
4. In the left sidebar, click "API"
5. Click "Request an API Key" or "Create"

1. Select "Developer" (for personal/non-commercial use)
2. Accept the terms of use
3. Click "Submit"

You'll be asked some questions. Here's what to enter:

Application Name:

Weavestream Personal Monitor

Application URL:

https://weavestream.io

(or just put your personal website/blog if you have one)

Application Summary:

Personal media monitoring dashboard to track new releases on streaming services.

Click "Submit"

After approval (usually instant), you'll see:

📋 API Key (v3 auth) - This is what you need!

• Example: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
• Copy this entire string

Also visible:

• API Read Access Token (v4 auth) - We'll use this for Bearer authentication
• Example: eyJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJh... (much longer)

📋 Copy the "API Read Access Token (v4)" - This is your Bearer token

1. Open Weavestream
2. Click the "+" button in the sidebar
3. Select "Add Source"
4. Fill in the source details:
   • Name: TMDB
   • Base URL: https://api.themoviedb.org/3
   • Auth Type: Bearer
   • Bearer Token: Paste your API Read Access Token (v4)
   • Icon: Select video.fill or film or tv
   • Color: Choose your preference (suggested: #01B4E4 - TMDB blue, or #A0A0A0 - gray)
   • Refresh Interval: 1440 (daily - TMDB data doesn't change hourly)
5. Click "Add" or "Save"

Now we'll add endpoints for each streaming service you want to monitor.

Configuration:

• Name: Netflix
• Path: /discover/movie
• Method: GET

Query Parameters:

• with_watch_providers: 8 (Netflix's provider ID)
• watch_region: US (or your region: GB, CA, etc.)
• sort_by: primary_release_date.desc (newest first)

Optional - Filter by date:

• primary_release_date.gte: 2024-01-01 (movies released after this date)
• primary_release_date.lte: 2024-12-31 (movies released before this date)

Field Mapping:

• ID Field: id
• Title Field: title
• Date Field: release_date
• Summary Fields: overview
• Status Field: (leave empty or use vote_average for ratings)

Pagination:

• Type: Page-based
• Page Size: 20 (TMDB default)
• Max Items: 100 (or adjust based on how many you want)

Same as Netflix, but change:

• Name: Amazon Prime
• Query Parameters:
  • with_watch_providers: 9 (Amazon Prime's provider ID)
  • watch_region: US
  • sort_by: primary_release_date.desc

All other settings same as Netflix.

• Name: Hulu
• Query Parameters:
  • with_watch_providers: 15
  • watch_region: US
  • sort_by: primary_release_date.desc

• Name: Disney+
• Query Parameters:
  • with_watch_providers: 337
  • watch_region: US
  • sort_by: primary_release_date.desc

• Name: Apple TV+
• Query Parameters:
  • with_watch_providers: 350
  • watch_region: US
  • sort_by: primary_release_date.desc

• Name: HBO Max
• Query Parameters:
  • with_watch_providers: 384
  • watch_region: US
  • sort_by: primary_release_date.desc

• Name: Paramount+
• Query Parameters:
  • with_watch_providers: 531
  • watch_region: US
  • sort_by: primary_release_date.desc

If you want to add other services:

Change watch_region based on your location:

For TV shows, change the path to /discover/tv and adjust fields:

Configuration:

• Path: /discover/tv
• Query Parameters: Same as movies
• Field Mapping:
  • Title Field: name (instead of title)
  • Date Field: first_air_date (instead of release_date)
  • Everything else same

Get what's trending right now:

Configuration:

• Name: Trending Movies - Week
• Path: /trending/movie/week
• Method: GET
• Query Parameters: (none needed)
• Field Mapping: Same as other movie endpoints

Configuration:

• Name: Top Rated Movies
• Path: /movie/top_rated
• Method: GET
• Query Parameters:
  • language: en-US
  • page: 1
• Field Mapping: Same as other movie endpoints

Configuration:

• Name: Upcoming Releases
• Path: /movie/upcoming
• Method: GET
• Query Parameters:
  • language: en-US
  • region: US
• Field Mapping: Same as other movie endpoints

Want only action movies on Netflix?

Configuration:

• Name: Netflix Action Movies
• Path: /discover/movie
• Query Parameters:
  • with_watch_providers: 8
  • watch_region: US
  • with_genres: 28 (Action genre ID)
  • sort_by: popularity.desc

Popular Genre IDs: | Genre | ID | |-------|-----| | Action | 28 | | Comedy | 35 | | Drama | 18 | | Horror | 27 | | Sci-Fi | 878 | | Thriller | 53 | | Romance | 10749 | | Animation | 16 | | Documentary | 99 | | Family | 10751 |

1. Under TMDB source, click "+" → "New Filter"
2. Name: New This Month
3. Select Endpoints: All streaming service endpoints
4. Add Condition:
   • Field: release_date
   • Operator: in last
   • Value: 30 days
5. Save

1. Create new filter
2. Name: Highly Rated (8+ Stars)
3. Select Endpoints: All endpoints
4. Add Condition:
   • Field: vote_average
   • Operator: greater than or equal
   • Value: 8.0
5. Save

1. Create new filter
2. Name: Action Movies
3. Select Endpoints: All movie endpoints
4. Add Condition:
   • Field: genre_ids (might need to use raw JSON filtering)
   • Operator: contains
   • Value: 28
5. Save

Now for the fun part! Ask AI questions about what to watch.

Discovery:

• "What are the best new movies on Netflix this month?"
• "Show me highly rated sci-fi movies across all my streaming services"
• "What documentaries came out recently on Hulu?"
• "Find me comedies that just came to Disney+"

Recommendations:

• "I liked Inception and Interstellar - what should I watch next?"
• "Recommend a movie for date night from my services"
• "What are the top rated thrillers available right now?"
• "Find me something similar to Stranger Things"

Comparisons:

• "Which streaming service has the most new releases this month?"
• "Compare action movies between Netflix and Prime Video"
• "What's the highest rated movie available across all my services?"

Planning:

• "What should I watch this weekend?"
• "Build me a watch list for the next month"
• "What movies are leaving Netflix soon?" (if you track this)

TMDB data doesn't change frequently:

• New releases: Refresh daily (1440 minutes)
• Trending: Refresh every 6 hours (360 minutes)
• Top rated: Refresh weekly (10080 minutes)

To avoid syncing thousands of old movies, add date filters:

Query Parameters:

primary_release_date.gte: 2024-01-01

This only gets movies from 2024 onward.

Want action comedies?

with_genres: 28,35

(Action=28, Comedy=35)

Change sort_by parameter:

• popularity.desc - Most popular first
• vote_average.desc - Highest rated first
• primary_release_date.desc - Newest first
• revenue.desc - Highest grossing first

By default, adult content is filtered. To include:

include_adult: true

Get movies in specific languages:

with_original_language: en  (English)
with_original_language: es  (Spanish)
with_original_language: ja  (Japanese)

Solution:

1. Make sure you copied the API Read Access Token (v4), not the API Key (v3)
2. The token should be very long (starts with eyJ...)
3. Verify you're using Bearer auth type in Weavestream
4. Check the token hasn't expired (TMDB tokens don't expire unless revoked)

Solution:

1. Check your watch_region - some content isn't available in all regions
2. Try removing date filters (primary_release_date.gte)
3. Verify the provider ID is correct for your region
4. Test without filters first, then add them back

Solution:

1. Verify the path starts with / (e.g., /discover/movie)
2. Check for typos in the path
3. Make sure base URL is https://api.themoviedb.org/3 (includes /3)

Solution: Add language query parameter:

language: en-US

Available languages:

• en-US - English (US)
• en-GB - English (UK)
• es-ES - Spanish (Spain)
• fr-FR - French
• de-DE - German
• ja-JP - Japanese

Solution:

1. Add date range filters to limit results
2. Reduce page size in pagination settings
3. Set max items per sync lower (e.g., 50 instead of 100)
4. Increase refresh interval (daily instead of hourly)

TMDB API limits:

• Free tier: 40 requests per 10 seconds
• Sufficient for: Most personal use cases

Weavestream automatically respects rate limits. If you have many endpoints, consider:

• Staggering sync times
• Reducing refresh frequency
• Limiting max items per sync

• API Documentation: https://developers.themoviedb.org/3
• Discover Movies: https://developers.themoviedb.org/3/discover/movie-discover
• Discover TV Shows: https://developers.themoviedb.org/3/discover/tv-discover
• Provider IDs: https://api.themoviedb.org/3/watch/providers/movie
• Genre IDs: https://api.themoviedb.org/3/genre/movie/list

• Get poster images: Use poster_path field + https://image.tmdb.org/t/p/w500/
• Get trailers: /movie/{movie_id}/videos
• Get cast/crew: /movie/{movie_id}/credits
• Get recommendations: /movie/{movie_id}/recommendations

What TMDB Knows:

• Your API requests (what you search/browse)
• Your watch region
• When you make requests

What TMDB Doesn't Know:

• What you actually watch
• Your streaming service credentials
• Personal information (beyond your TMDB account)

Data Storage:

• Weavestream stores movie data locally on your Mac
• No data is sent to Weavestream servers
• TMDB API calls are direct from your Mac to TMDB

Want to skip manual setup? Import this template:

1. In Weavestream, click "Import Source"
2. Paste the JSON from your message
3. Update the Bearer token with your API Read Access Token
4. Sync!

All endpoints (Netflix, Prime, Hulu, Disney+) will be pre-configured.

Before you finish, verify:

• ✅ TMDB account created and verified
• ✅ API Read Access Token (v4) obtained
• ✅ TMDB source added to Weavestream with Bearer auth
• ✅ At least one streaming service endpoint configured
• ✅ Field mappings working (titles and release dates visible)
• ✅ Sync completed successfully
• ✅ Smart filters created for easy discovery
• ✅ Tested AI questions about your content

You're all set! Start discovering what to watch tonight! 🍿

Last updated: February 2026 TMDB API version: v3