Quick Start

1. Get an API key at community.popcorntime.app/api-keys

2. Search for a movie

   curl

   curl -H "Authorization: Bearer YOUR_KEY" \
     "https://api.popcorntime.app/v1/search?q=breaking+bad&country=US"

   JavaScript

   const res = await fetch(
     "https://api.popcorntime.app/v1/search?q=breaking+bad&country=US",
     { headers: { Authorization: "Bearer YOUR_KEY" } }
   );
   const data = await res.json();
   console.log(data.results);

   Python

   import requests
   
   res = requests.get(
       "https://api.popcorntime.app/v1/search",
       params={"q": "breaking bad", "country": "US"},
       headers={"Authorization": "Bearer YOUR_KEY"},
   )
   print(res.json()["results"])

3. Get streaming links for a title

   Use the id from the search results:

   curl -H "Authorization: Bearer YOUR_KEY" \
     "https://api.popcorntime.app/v1/media/jR9Lk5mP/links?country=US"

4. Explore the full API

   Check out the API Reference for all available endpoints.

Common endpoints

Endpoint	Description
GET /v1/search	Search movies and TV shows
GET /v1/rankings	Top ranked media by country
GET /v1/trending	What’s trending right now
GET /v1/media/{id}	Full media details
GET /v1/media/{id}/links	Streaming availability
GET /v1/providers	Available streaming providers
GET /v1/snapshots	Open source data releases