criterion.com APIcriterion.com ↗
Access the Criterion Collection catalog, Current magazine posts, Top 10 lists, and Closet Picks via 8 structured endpoints returning titles, synopses, and more.
curl -X GET 'https://api.parse.bot/scraper/c4a7e815-f1b8-4725-b565-87cb4f23aa80/get_all_films?sort=spine_number&country=France' \ -H 'X-API-Key: $PARSE_API_KEY'
Browse the Criterion Collection catalog with various filters. Returns a list of films with spine number, title, director, country, and year.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort order for results. Accepted values: spine_number, title, year, director. |
| genre | string | Filter by genre slug. |
| query | string | Search query within catalog. |
| decade | string | Filter by decade (e.g., 1960s). |
| format | string | Filter by format. |
| country | string | Filter by country (e.g., Japan, France). |
| director | string | Filter by director slug. |
{
"type": "object",
"fields": {
"count": "integer total number of films returned",
"films": "array of film objects with spine, title, director, country, year, and url"
},
"sample": {
"data": {
"count": 1839,
"films": [
{
"url": "https://www.criterion.com/films/351-grand-illusion",
"year": "1937",
"spine": "1",
"title": "Grand Illusion",
"country": "France",
"director": "Jean Renoir"
}
]
},
"status": "success"
}
}About the criterion.com API
The Criterion Collection API provides 8 endpoints covering the full film catalog, editorial content from Current magazine, Top 10 lists, and Closet Picks. Use get_film_detail to retrieve a film's synopsis, director, special features, runtime, aspect ratio, and spine number, or use get_all_films with filters like country, decade, director slug, and genre to paginate the catalog programmatically.
Film Catalog
get_all_films returns an array of film objects — each with spine, title, director, country, year, and url — and accepts optional parameters for sort (spine_number, title, year, director), genre, decade, country, director, format, and a free-text query. get_film_detail takes a full film URL and returns the complete record including synopsis, features (a list of special features on the release), and a details array covering country, year, runtime, format, aspect ratio, language, and spine number. search_films accepts a query string and returns matching films and box sets with title, director, and URL.
Editorial Content
get_current_posts retrieves posts from the Current magazine landing page or from a specific category slug such as 1-essays, 2-interviews, 3-features, or 8-top-10-lists. Each post object includes title, author, category, date, and url. get_current_post_detail fetches the full text content of an individual post given its URL.
Top 10 Lists and Closet Picks
get_top10_lists returns a paginated collection of Top 10 list objects with title, author, url, and id. Pass a specific list URL to get_top10_list_detail to get the picks array (film titles), the list title, and the author name. get_closet_picks takes no parameters and returns the full set of Closet Picks entries, each with a title and url.
- Build a searchable Criterion spine-number index filtered by country or decade using
get_all_films - Populate a film detail page with synopsis, runtime, aspect ratio, and special features via
get_film_detail - Aggregate all film essays and interviews from Current magazine using
get_current_postswith category slugs - Extract curated film picks from critic Top 10 lists using
get_top10_list_detail - Monitor new Closet Picks video additions by polling
get_closet_picks - Build a recommendation tool that cross-references director or country filters from
get_all_filmswith editorial posts fromget_current_posts - Index the full text of Current magazine essays for search or NLP using
get_current_post_detail
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Criterion have an official developer API?+
What does `get_all_films` return, and how granular are the filters?+
get_all_films returns a films array where each entry includes spine (the Criterion spine number), title, director, country, year, and url. You can filter by genre slug, country (e.g., Japan, France), decade (e.g., 1960s), director slug, and format, and sort by spine_number, title, year, or director. The count field indicates how many results matched.Does `get_film_detail` include streaming availability or purchase pricing?+
get_film_detail covers synopsis, features, and a details array with runtime, aspect ratio, format, language, and spine number, but does not include streaming availability, retail pricing, or in-stock status. You can fork this API on Parse and revise it to add an endpoint targeting that data.Can I retrieve user reviews or ratings for Criterion films?+
Are there pagination controls on `get_current_posts` and `get_top10_lists`?+
limit integer parameter that caps how many items are returned. There is no explicit page or offset parameter in the current spec, so limit is the primary control over result set size.