# Popcorn Time

> Popcorn Time is an open data platform for streaming availability. We publish weekly Parquet snapshots covering 50+ countries and 300+ streaming providers -- free to download, query with DuckDB, and build on. A REST API is also available for real-time access.

## Open Source Data

Weekly Parquet snapshots of streaming availability data are released under an open license. No API key required -- download and query directly with DuckDB, Python, or any Parquet-compatible tool.

- [Open Source Snapshots](https://docs.popcorntime.app/developers/snapshots/): Download the full streaming availability dataset as Apache Parquet files.
- [Parquet Schema Reference](https://docs.popcorntime.app/developers/parquet-schema/): Complete schema documentation for all Parquet files in the open-source snapshots.
- [DuckDB Examples](https://docs.popcorntime.app/developers/duckdb/): Query Popcorn Time snapshots with DuckDB.

## API Docs

- [Authentication](https://docs.popcorntime.app/developers/authentication/): How to get and use your API key.
- [Images](https://docs.popcorntime.app/developers/images/): How to resolve poster and backdrop image URLs from the API.
- [Introduction](https://docs.popcorntime.app/developers/introduction/): Overview of the Popcorn Time API and what you can build with it.
- [Link Tokens](https://docs.popcorntime.app/developers/link-tokens/): How streaming links work and how to redirect users to the right provider.
- [Pagination](https://docs.popcorntime.app/developers/pagination/): How pagination works across the API.
- [Quick Start](https://docs.popcorntime.app/developers/quickstart/): Make your first API request in 30 seconds.

## API Endpoints

Base URL: `https://api.popcorntime.app`

Each endpoint below has a `.txt` version with full parameter and response schema details for LLM consumption.

- [Search](https://docs.popcorntime.app/developers/api/v1/search.txt): `GET /v1/search` -- Full-text search across movies and TV shows with optional genre and provider filters. Results are ranked by relevance within the specified country.
- [Rankings](https://docs.popcorntime.app/developers/api/v1/rankings.txt): `GET /v1/rankings` -- Returns the overall popularity ranking of media in a country, combining availability across providers, ratings, and recency.
- [Trending](https://docs.popcorntime.app/developers/api/v1/trending.txt): `GET /v1/trending` -- Daily trending titles based on position changes in the catalog. Shows what's gaining popularity right now.
- [Featured](https://docs.popcorntime.app/developers/api/v1/featured.txt): `GET /v1/featured` -- Hand-picked featured media, refreshed daily and weekly.
- [Media detail](https://docs.popcorntime.app/developers/api/v1/media/media-detail.txt): `GET /v1/media/{id}` -- Media detail
- [Streaming links](https://docs.popcorntime.app/developers/api/v1/media/links/media-links.txt): `GET /v1/media/{id}/links` -- Streaming links
- [Seasons](https://docs.popcorntime.app/developers/api/v1/media/seasons.txt): `GET /v1/media/{id}/seasons` -- Returns all seasons for a TV show, including episode counts per season.
- [Episodes](https://docs.popcorntime.app/developers/api/v1/media/seasons/episodes.txt): `GET /v1/media/{id}/seasons/{season}/episodes` -- Returns all episodes for a specific season of a TV show.
- [List collections](https://docs.popcorntime.app/developers/api/v1/collections.txt): `GET /v1/collections` -- Returns all public collections available for the given country.
- [Collection detail](https://docs.popcorntime.app/developers/api/v1/collections/collection-detail.txt): `GET /v1/collections/{slug}` -- Returns a collection with its media items. Supports pagination for large collections.
- [Providers](https://docs.popcorntime.app/developers/api/v1/providers.txt): `GET /v1/providers` -- Returns all streaming providers available in a country, sorted by weight (popularity). Use provider IDs with search and media endpoints.
- [Languages](https://docs.popcorntime.app/developers/api/v1/locales.txt): `GET /v1/locales` -- Returns the list of language codes that have a MeiliSearch index. Only these languages are valid for the `lang` parameter on other endpoints.
- [List releases](https://docs.popcorntime.app/developers/api/v1/snapshots.txt): `GET /v1/snapshots` -- Returns the latest weekly open-source release with a full file manifest. Includes per-country links, metadata, and provider data -- everything needed for offline use.
- [Schemas](https://docs.popcorntime.app/developers/api/v1/schemas.txt): `GET /v1/schemas` -- Returns the schema definitions for all Parquet files in the open-source snapshots. Useful for building tools that validate or introspect the data.
- [Download URL](https://docs.popcorntime.app/developers/api/v1/snapshots/download.txt): `GET /v1/snapshots/download` -- Returns a download URL for any file in an open-source release. The URL requires your API key and is valid for 1 hour.

## Optional

- [OpenAPI spec](https://api.popcorntime.app/v1/openapi): Machine-readable OpenAPI 3.0 JSON
- [Get API Key](https://community.popcorntime.app/api-keys): Create an API key
- [Full Content](https://docs.popcorntime.app/llms-full.txt): All documentation in a single file