Collections

Curated lists and discovery categories.

Search movie collections

GET

https://whatsafterthemovie-main-0565fcb.zuplo.app

/v1/collections

Discover curated movie lists and themed categories by title or tag. Use type to choose lists or categories, and source to filter lists by their source. Keep both type and id when selecting a collection: IDs are unique within each type.

Search movie collections › query Parameters

limit

integer · min: 1 · max: 100

Maximum items in the returned page.

Default: 20

cursor

string · minLength: 1 · maxLength: 4096

The next_cursor from a previous response. Keep the same endpoint and filters. Valid for 24 hours.

q

string · minLength: 1 · maxLength: 120

Match part of a collection title, ignoring case.

type

string · enum

Choose curated lists or themed categories. Omit to search both.

Enum values:

list

Search movie collections › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Search movie collections › Responses

The requested data. Examples use illustrative values.

ListCollectionsResponse

object[] · required

object · required

Get a collection’s movies

GET

https://whatsafterthemovie-main-0565fcb.zuplo.app

/v1/collections/{type}/{collection}

Retrieve a curated list or themed category and its paginated movies in data.movies. Supply the collection’s type and its ID or slug. Movies follow the collection’s own ranking or editorial order.

Get a collection’s movies › path Parameters

type

string · enum · required

Collection type.

Enum values:

list

Get a collection’s movies › query Parameters

limit

integer · min: 1 · max: 100

Maximum items in the returned page.

Default: 20

cursor

string · minLength: 1 · maxLength: 4096

The next_cursor from a previous response. Keep the same endpoint and filters. Valid for 24 hours.

Get a collection’s movies › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get a collection’s movies › Responses

The requested data. Examples use illustrative values.

GetCollectionResponse

object · required

GET/v1/collections/{type}/{collection}

curl https://whatsafterthemovie-main-0565fcb.zuplo.app/v1/collections/:type/:collection \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": {
    "id": 101,
    "slug": "the-last-screening",
    "type": "list",
    "title": "The Last Screening",
    "tags": [
      "family",
      "memory"
    ],
    "image_url": "https://example.com/image.jpg",
    "source": "Example",
    "movies": {
      "data": [
        {
          "id": 101,
          "slug": "the-last-screening",
          "title": "The Last Screening",
          "year": 2025,
          "release_date": "2025-09-12",
          "language": "en",
          "genres": [
            "Drama"
          ],
          "image_url": "https://example.com/image.jpg",
          "imdb_id": "tt0000101",
          "tmdb_id": "101"
        }
      ],
      "pagination": {
        "limit": 20,
        "has_more": false,
        "next_cursor": null
      }
    }
  }
}

json

application/json

Cars Movie content