Open Source Snapshots

Every week we publish a complete data release as Apache Parquet files. This includes everything needed to run the Popcorn Time desktop app fully offline.

Release 2026-W12 Latest Mar 20, 2026

Countries

50

Files

323

Dataset

955.1 MB

Per Country

19.1 MB

AEARATAUBEBRCACHCLCOCZDEDKEGESFIFRGBGRHKHRHUIDIEILINITJPKRMXMYNLNONZPEPHPLPTRORUSASESGSKTHTRTWUAUSZA

Tip

New releases are published every Saturday at 06:00 UTC, capturing all Friday releases from Netflix, Apple TV+, and other major providers.

What’s included

Per country

Each country has its own directory with:

File	Description	~Size
links.parquet	Streaming availability (which titles are on which providers, including supported platforms)	5-15 MB
rankings.parquet	Popularity rankings	~120 KB

Global metadata

Core metadata files (included in metadata.tar.gz):

• media_details.parquet — Movies & TV shows (title, year, overview, poster, ratings)
• movies.parquet / tv_shows.parquet — Type-specific details
• seasons.parquet / episodes.parquet — TV season & episode data
• media_genres.parquet / genres.parquet — Genre associations
• media_ids.parquet — External IDs (IMDB, TMDB, TVDB)
• media_ratings.parquet — Ratings from multiple sources
• media_talents.parquet / peoples.parquet — Cast & crew
• media_videos.parquet — Trailers
• providers.parquet / provider_weights.parquet — Provider registry
• collections.parquet / featured.parquet — Curated collections

Translations

Base metadata is in English. Additional language overlays are available as individual downloads:

metadata/translations/lang_fr.parquet  — French
metadata/translations/lang_de.parquet  — German
metadata/translations/lang_es.parquet  — Spanish
metadata/translations/lang_ja.parquet  — Japanese
... and many more

How to download

All downloads require an API key.

1. List available releases

   curl https://api.popcorntime.app/v1/snapshots

   This endpoint is public (no auth required) and returns the latest release info, country list, and file manifest.

2. Download metadata bundle

   # Get download URL
   curl -H "Authorization: Bearer YOUR_KEY" \
     "https://api.popcorntime.app/v1/snapshots/download?path=metadata.tar.gz" \
     | jq -r .download_url
   
   # Download the file
   curl -H "Authorization: Bearer YOUR_KEY" \
     "https://api.popcorntime.app/v1/snapshots/file/2026-W12/metadata.tar.gz" \
     -o metadata.tar.gz
   
   tar xzf metadata.tar.gz

3. Download country data

   for file in links.parquet rankings.parquet; do
     curl -H "Authorization: Bearer YOUR_KEY" \
       "https://api.popcorntime.app/v1/snapshots/download?path=country%3DUS/$file" \
       | jq -r .download_url \
       | xargs -I{} curl -H "Authorization: Bearer YOUR_KEY" {} -o "US_$file"
   done

4. Add translations (optional)

   curl -H "Authorization: Bearer YOUR_KEY" \
     "https://api.popcorntime.app/v1/snapshots/download?path=metadata/translations/lang_fr.parquet" \
     | jq -r .download_url \
     | xargs -I{} curl -H "Authorization: Bearer YOUR_KEY" {} -o lang_fr.parquet

API vs Snapshots

Feature	API	Snapshots
Data freshness	Real-time (daily crawls)	Weekly releases
Search	Full-text with typo tolerance	Local query (DuckDB, Polars)
Trending	Live daily positions	Snapshot of weekly rankings
Use case	Apps, websites, bots	Research, offline apps, self-hosting
Rate limit	60 req/min	Unlimited (local files)

License

Open-source snapshots are released under the Popcorn Time Open Data License. Free for personal projects, research, and non-commercial use. Commercial use requires a separate license — contact us.