Movies

Server

Movie records and core metadata.

List movie age ratings

GET

https://api.cineamo.com

/movies/{movieId}/age-ratings

Returns a list of MovieAgeRating objects for the movie with this id.

List movie age ratings › path Parameters

movieId

integer · required

List movie age ratings › query Parameters

page

integer

perPage

integer

sort

string

order

string

query

string

List movie age ratings › Responses

MovieAgeRating list

MovieAgeRating

id

integer · readOnly · required

iso31662

string · readOnly · required

cineamoMovieId

string | null · readOnly

ageRatingId

integer | null · readOnly

Set movie age rating

PUT

https://api.cineamo.com

/movies/{movieId}/age-ratings

Sets the age rating of the movie with this id for one ISO 3166-2 region. Returns the created or updated MovieAgeRating.

Set movie age rating › path Parameters

movieId

integer · required

Set movie age rating › Request Body

MovieAgeRating

id

integer · readOnly · required

iso31662

string · readOnly · required

cineamoMovieId

string | null · readOnly

ageRatingId

integer | null · readOnly

Set movie age rating › Responses

Movie ageRating has been updated

MovieAgeRating

id

integer · readOnly · required

iso31662

string · readOnly · required

cineamoMovieId

string | null · readOnly

ageRatingId

integer | null · readOnly

deprecated

List movie age ratings

GET

https://api.cineamo.com

/movies/{cineamoId:\d+(?:m|s)}/age-ratings

Returns a list of MovieAgeRating objects.

List movie age ratings › query Parameters

page

integer

perPage

integer

sort

string

order

string

query

string

List movie age ratings › Responses

MovieAgeRating list

MovieAgeRating

id

integer · readOnly · required

iso31662

string · readOnly · required

cineamoMovieId

string | null · readOnly

ageRatingId

integer | null · readOnly

deprecated

Set movie age rating

PUT

https://api.cineamo.com

/movies/{cineamoId}/age-ratings

Updates a Movie Shape. It returns the updated Movie Shape object.

Set movie age rating › path Parameters

cineamoId

string · required

Set movie age rating › Request Body

MovieAgeRating

id

integer · readOnly · required

iso31662

string · readOnly · required

cineamoMovieId

string | null · readOnly

ageRatingId

integer | null · readOnly

Set movie age rating › Responses

Movie ageRating has been updated

MovieAgeRating

id

integer · readOnly · required

iso31662

string · readOnly · required

cineamoMovieId

string | null · readOnly

ageRatingId

integer | null · readOnly

Get a movie content

GET

https://api.cineamo.com

/movies/{movieId}/content

Returns a Content object for a specific movie.

Get a movie content › path Parameters

movieId

integer · required

Get a movie content › Responses

Movie content details

Content

id

integer · readOnly

name

string · readOnly

slug

string | null · readOnly

category

string · readOnly

description

string · readOnly

descriptionEn

string | null · readOnly

isOwnContent

boolean | null · readOnly

duration

integer | null · readOnly

creatorCinemaId

integer | null · readOnly

posterImageRef

string | null · readOnly

posterImageUrl

string | null · readOnly

backdropImageRef

string | null · readOnly

backdropImageUrl

string | null · readOnly

ageRating

string | null · readOnly

trailerUrl

string | null · readOnly

hasMarketingAssistantBooked

boolean · readOnly

futureShowingsCount

integer | null · readOnly

premiereDate

string | null · readOnly

movieId

integer | null · readOnly

GET/movies/{movieId}/content

curl https://api.cineamo.com/movies/:movieId/content

Example Responses

{
  "id": 1,
  "name": "some content name",
  "slug": "some-content-name",
  "category": "movie_series",
  "description": "description",
  "descriptionEn": "English description",
  "isOwnContent": true,
  "duration": 160,
  "creatorCinemaId": 1,
  "posterImageRef": "00000000-0000-0000-0000-000000000000",
  "posterImageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/content-profile",
  "backdropImageRef": "00000000-0000-0000-0000-000000000000",
  "backdropImageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/content-backdrop",
  "ageRating": "18",
  "trailerUrl": "https://example.com/trailer.mp4",
  "isRegularEvent": true,
  "hasMarketingAssistantBooked": true,
  "futureShowingsCount": 5,
  "premiereDate": "2022-04-11T04:11:22Z",
  "movie": {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "155m",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "isTmdbSyncSkipped": true,
    "series": true,
    "selectedByCinema": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "homepage": "homepage",
    "imdbId": "imdbId",
    "originalLanguage": "originalLanguage",
    "originalTitle": "Some Original Title",
    "overview": "Some movie overview...",
    "popularity": 0,
    "posterPath": "posterPath",
    "productionCompanies": [
      {
        "name": "name",
        "id": 0,
        "logoPath": "logoPath",
        "originCountry": "originCountry"
      }
    ],
    "productionCountries": [
      {}
    ],
    "releaseDate": "releaseDate",
    "revenue": 0,
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "video": true,
    "voteAverage": 0,
    "voteCount": 0,
    "alternativeTitles": {},
    "credits": {},
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "noRightsAvailable": true,
    "noRightsTimestamp": 0,
    "thirdParties": {
      "moviePilot": {
        "voteAverage": 0,
        "link": "link",
        "voteCount": 0
      }
    },
    "slug": "some-slug",
    "rentrakTitle": 0,
    "movieAccessibility": {
      "id": 1,
      "movieId": 1,
      "iso31661": "DE",
      "gretaMovieId": "abc123",
      "hasClosedCaption": false,
      "hasAudioDescription": false,
      "hasSoundAmplification": false
    }
  },
  "movieId": 123,
  "metrics": {
    "messagesCount": 0,
    "clickedMessagesCount": 0,
    "ticketPurchaseIntentsCount": 0
  }
}

json

application/json

Get a movie configuration by movie ID

GET

https://api.cineamo.com

/movies/{movieId:\d+}/configuration

Returns the requested movie configuration by movie ID.

Get a movie configuration by movie ID › path Parameters

movieId

string · required

Get a movie configuration by movie ID › Responses

MovieConfiguration details

MovieConfiguration

id

integer · readOnly · required

movieId

integer · readOnly

landingPageConfiguration

object | null

domain

string | null

Create a replace movie configuration

PUT

https://api.cineamo.com

/movies/{movieId:\d+}/configuration

Creates a replace movie configuration. Returns the created replace movie configuration.

Create a replace movie configuration › path Parameters

movieId

string · required

Create a replace movie configuration › Request Body

MovieConfiguration

id

integer · readOnly · required

movieId

integer · readOnly

landingPageConfiguration

object | null

domain

string | null

Create a replace movie configuration › Responses

MovieConfiguration was replaced

MovieConfiguration

id

integer · readOnly · required

movieId

integer · readOnly

landingPageConfiguration

object | null

domain

string | null

Delete a movie configuration

DELETE

https://api.cineamo.com

/movies/{movieId:\d+}/configuration

Delete a movie configuration

Delete a movie configuration › path Parameters

movieId

string · required

Delete a movie configuration › Responses

MovieConfiguration was deleted

No data returned

Get a movie

GET

https://api.cineamo.com

/movies/{movieId}

Returns a Movie object by its Id.

Get a movie › path Parameters

movieId

integer · required

Get a movie › Responses

Movie details

Movie

id

integer · readOnly · required

originalTitle

string · readOnly · required

tmdbId

integer | null · readOnly

title

string | null · readOnly

lastUpdated

integer | null · readOnly

isTmdbSyncSkipped

boolean | null · readOnly

series

boolean · readOnly

selectedByCinema

boolean · readOnly

adult

boolean · readOnly

backdropPath

string | null · readOnly

array | null · readOnly

homepage

string | null · readOnly

imdbId

string | null · readOnly

originalLanguage

string | null · readOnly

overview

string | null · readOnly

popularity

number · float · readOnly

posterPath

string | null · readOnly

array | null · readOnly

productionCountries

array | null · readOnly

releaseDate

string | null · readOnly

revenue

integer | null · readOnly

runtime

integer | null · readOnly

firstAirDate

string | null · readOnly

status

string | null · readOnly

tagline

string | null · readOnly

video

boolean | null · readOnly

voteAverage

number · float · readOnly

voteCount

integer · readOnly

readOnly

noRightsAvailable

boolean · readOnly

noRightsTimestamp

integer | null · readOnly

readOnly

slug

string | null · readOnly

rentrakTitle

integer | null · readOnly

readOnly

GET/movies/{movieId}

curl https://api.cineamo.com/movies/:movieId

Example Responses

{
  "id": 1,
  "tmdbId": 1,
  "cineamoId": "155m",
  "title": "Some Movie Title",
  "lastUpdated": 0,
  "isTmdbSyncSkipped": true,
  "series": true,
  "selectedByCinema": true,
  "adult": true,
  "backdropPath": "backdropPath",
  "genres": [
    {
      "id": 0,
      "name": "name"
    }
  ],
  "homepage": "homepage",
  "imdbId": "imdbId",
  "originalLanguage": "originalLanguage",
  "originalTitle": "Some Original Title",
  "overview": "Some movie overview...",
  "popularity": 0,
  "posterPath": "posterPath",
  "productionCompanies": [
    {
      "name": "name",
      "id": 0,
      "logoPath": "logoPath",
      "originCountry": "originCountry"
    }
  ],
  "productionCountries": [
    {}
  ],
  "releaseDate": "releaseDate",
  "revenue": 0,
  "runtime": 0,
  "firstAirDate": "firstAirDate",
  "status": "status",
  "tagline": "tagline",
  "video": true,
  "voteAverage": 0,
  "voteCount": 0,
  "alternativeTitles": {},
  "credits": {},
  "images": {},
  "videos": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "translations": {
    "id": 0,
    "translations": 0
  },
  "releaseDates": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "noRightsAvailable": true,
  "noRightsTimestamp": 0,
  "thirdParties": {
    "moviePilot": {
      "voteAverage": 0,
      "link": "link",
      "voteCount": 0
    }
  },
  "slug": "some-slug",
  "rentrakTitle": 0,
  "movieAccessibility": {
    "id": 1,
    "movieId": 1,
    "iso31661": "DE",
    "gretaMovieId": "abc123",
    "hasClosedCaption": false,
    "hasAudioDescription": false,
    "hasSoundAmplification": false
  }
}

json

application/json

Delete a movie

DELETE

https://api.cineamo.com

/movies/{movieId}

Soft-deletes the movie with this id. It returns an empty response.

Delete a movie › path Parameters

movieId

integer · required

Delete a movie › Responses

Movie was deleted

No data returned

Update a movie

PATCH

https://api.cineamo.com

/movies/{movieId}

Updates the movie with this id. Returns the updated movie.

Update a movie › path Parameters

movieId

integer · required

Update a movie › Responses

Movie details

Movie

id

integer · readOnly · required

originalTitle

string · readOnly · required

tmdbId

integer | null · readOnly

title

string | null · readOnly

lastUpdated

integer | null · readOnly

isTmdbSyncSkipped

boolean | null · readOnly

series

boolean · readOnly

selectedByCinema

boolean · readOnly

adult

boolean · readOnly

backdropPath

string | null · readOnly

array | null · readOnly

homepage

string | null · readOnly

imdbId

string | null · readOnly

originalLanguage

string | null · readOnly

overview

string | null · readOnly

popularity

number · float · readOnly

posterPath

string | null · readOnly

array | null · readOnly

productionCountries

array | null · readOnly

releaseDate

string | null · readOnly

revenue

integer | null · readOnly

runtime

integer | null · readOnly

firstAirDate

string | null · readOnly

status

string | null · readOnly

tagline

string | null · readOnly

video

boolean | null · readOnly

voteAverage

number · float · readOnly

voteCount

integer · readOnly

readOnly

noRightsAvailable

boolean · readOnly

noRightsTimestamp

integer | null · readOnly

readOnly

slug

string | null · readOnly

rentrakTitle

integer | null · readOnly

readOnly

PATCH/movies/{movieId}

curl https://api.cineamo.com/movies/:movieId \
  --request PATCH

Example Responses

{
  "id": 1,
  "tmdbId": 1,
  "cineamoId": "155m",
  "title": "Some Movie Title",
  "lastUpdated": 0,
  "isTmdbSyncSkipped": true,
  "series": true,
  "selectedByCinema": true,
  "adult": true,
  "backdropPath": "backdropPath",
  "genres": [
    {
      "id": 0,
      "name": "name"
    }
  ],
  "homepage": "homepage",
  "imdbId": "imdbId",
  "originalLanguage": "originalLanguage",
  "originalTitle": "Some Original Title",
  "overview": "Some movie overview...",
  "popularity": 0,
  "posterPath": "posterPath",
  "productionCompanies": [
    {
      "name": "name",
      "id": 0,
      "logoPath": "logoPath",
      "originCountry": "originCountry"
    }
  ],
  "productionCountries": [
    {}
  ],
  "releaseDate": "releaseDate",
  "revenue": 0,
  "runtime": 0,
  "firstAirDate": "firstAirDate",
  "status": "status",
  "tagline": "tagline",
  "video": true,
  "voteAverage": 0,
  "voteCount": 0,
  "alternativeTitles": {},
  "credits": {},
  "images": {},
  "videos": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "translations": {
    "id": 0,
    "translations": 0
  },
  "releaseDates": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "noRightsAvailable": true,
  "noRightsTimestamp": 0,
  "thirdParties": {
    "moviePilot": {
      "voteAverage": 0,
      "link": "link",
      "voteCount": 0
    }
  },
  "slug": "some-slug",
  "rentrakTitle": 0,
  "movieAccessibility": {
    "id": 1,
    "movieId": 1,
    "iso31661": "DE",
    "gretaMovieId": "abc123",
    "hasClosedCaption": false,
    "hasAudioDescription": false,
    "hasSoundAmplification": false
  }
}

json

application/json

deprecated

Get a movie by cineamo ID

GET

https://api.cineamo.com

/movies/{cineamoId}

Returns the requested movie by cineamo ID.

Get a movie by cineamo ID › path Parameters

cineamoId

string · required

Get a movie by cineamo ID › Responses

Movie details

Movie

id

integer · readOnly · required

originalTitle

string · readOnly · required

tmdbId

integer | null · readOnly

title

string | null · readOnly

lastUpdated

integer | null · readOnly

isTmdbSyncSkipped

boolean | null · readOnly

series

boolean · readOnly

selectedByCinema

boolean · readOnly

adult

boolean · readOnly

backdropPath

string | null · readOnly

array | null · readOnly

homepage

string | null · readOnly

imdbId

string | null · readOnly

originalLanguage

string | null · readOnly

overview

string | null · readOnly

popularity

number · float · readOnly

posterPath

string | null · readOnly

array | null · readOnly

productionCountries

array | null · readOnly

releaseDate

string | null · readOnly

revenue

integer | null · readOnly

runtime

integer | null · readOnly

firstAirDate

string | null · readOnly

status

string | null · readOnly

tagline

string | null · readOnly

video

boolean | null · readOnly

voteAverage

number · float · readOnly

voteCount

integer · readOnly

readOnly

noRightsAvailable

boolean · readOnly

noRightsTimestamp

integer | null · readOnly

readOnly

slug

string | null · readOnly

rentrakTitle

integer | null · readOnly

readOnly

GET/movies/{cineamoId}

curl https://api.cineamo.com/movies/:cineamoId

Example Responses

{
  "id": 1,
  "tmdbId": 1,
  "cineamoId": "155m",
  "title": "Some Movie Title",
  "lastUpdated": 0,
  "isTmdbSyncSkipped": true,
  "series": true,
  "selectedByCinema": true,
  "adult": true,
  "backdropPath": "backdropPath",
  "genres": [
    {
      "id": 0,
      "name": "name"
    }
  ],
  "homepage": "homepage",
  "imdbId": "imdbId",
  "originalLanguage": "originalLanguage",
  "originalTitle": "Some Original Title",
  "overview": "Some movie overview...",
  "popularity": 0,
  "posterPath": "posterPath",
  "productionCompanies": [
    {
      "name": "name",
      "id": 0,
      "logoPath": "logoPath",
      "originCountry": "originCountry"
    }
  ],
  "productionCountries": [
    {}
  ],
  "releaseDate": "releaseDate",
  "revenue": 0,
  "runtime": 0,
  "firstAirDate": "firstAirDate",
  "status": "status",
  "tagline": "tagline",
  "video": true,
  "voteAverage": 0,
  "voteCount": 0,
  "alternativeTitles": {},
  "credits": {},
  "images": {},
  "videos": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "translations": {
    "id": 0,
    "translations": 0
  },
  "releaseDates": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "noRightsAvailable": true,
  "noRightsTimestamp": 0,
  "thirdParties": {
    "moviePilot": {
      "voteAverage": 0,
      "link": "link",
      "voteCount": 0
    }
  },
  "slug": "some-slug",
  "rentrakTitle": 0,
  "movieAccessibility": {
    "id": 1,
    "movieId": 1,
    "iso31661": "DE",
    "gretaMovieId": "abc123",
    "hasClosedCaption": false,
    "hasAudioDescription": false,
    "hasSoundAmplification": false
  }
}

json

application/json

deprecated

Delete a movie by cineamo ID

DELETE

https://api.cineamo.com

/movies/{cineamoId}

Deletes a Movie. It returns an empty response.

Delete a movie by cineamo ID › path Parameters

cineamoId

string · required

Delete a movie by cineamo ID › Responses

Movie was deleted

No data returned

deprecated

Update a movie

PATCH

https://api.cineamo.com

/movies/{cineamoId}

Updates a movie. Returns the updated movie.

Update a movie › path Parameters

cineamoId

string · required

Update a movie › Responses

Movie details

Movie

id

integer · readOnly · required

originalTitle

string · readOnly · required

tmdbId

integer | null · readOnly

title

string | null · readOnly

lastUpdated

integer | null · readOnly

isTmdbSyncSkipped

boolean | null · readOnly

series

boolean · readOnly

selectedByCinema

boolean · readOnly

adult

boolean · readOnly

backdropPath

string | null · readOnly

array | null · readOnly

homepage

string | null · readOnly

imdbId

string | null · readOnly

originalLanguage

string | null · readOnly

overview

string | null · readOnly

popularity

number · float · readOnly

posterPath

string | null · readOnly

array | null · readOnly

productionCountries

array | null · readOnly

releaseDate

string | null · readOnly

revenue

integer | null · readOnly

runtime

integer | null · readOnly

firstAirDate

string | null · readOnly

status

string | null · readOnly

tagline

string | null · readOnly

video

boolean | null · readOnly

voteAverage

number · float · readOnly

voteCount

integer · readOnly

readOnly

noRightsAvailable

boolean · readOnly

noRightsTimestamp

integer | null · readOnly

readOnly

slug

string | null · readOnly

rentrakTitle

integer | null · readOnly

readOnly

PATCH/movies/{cineamoId}

curl https://api.cineamo.com/movies/:cineamoId \
  --request PATCH

Example Responses

{
  "id": 1,
  "tmdbId": 1,
  "cineamoId": "155m",
  "title": "Some Movie Title",
  "lastUpdated": 0,
  "isTmdbSyncSkipped": true,
  "series": true,
  "selectedByCinema": true,
  "adult": true,
  "backdropPath": "backdropPath",
  "genres": [
    {
      "id": 0,
      "name": "name"
    }
  ],
  "homepage": "homepage",
  "imdbId": "imdbId",
  "originalLanguage": "originalLanguage",
  "originalTitle": "Some Original Title",
  "overview": "Some movie overview...",
  "popularity": 0,
  "posterPath": "posterPath",
  "productionCompanies": [
    {
      "name": "name",
      "id": 0,
      "logoPath": "logoPath",
      "originCountry": "originCountry"
    }
  ],
  "productionCountries": [
    {}
  ],
  "releaseDate": "releaseDate",
  "revenue": 0,
  "runtime": 0,
  "firstAirDate": "firstAirDate",
  "status": "status",
  "tagline": "tagline",
  "video": true,
  "voteAverage": 0,
  "voteCount": 0,
  "alternativeTitles": {},
  "credits": {},
  "images": {},
  "videos": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "translations": {
    "id": 0,
    "translations": 0
  },
  "releaseDates": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "noRightsAvailable": true,
  "noRightsTimestamp": 0,
  "thirdParties": {
    "moviePilot": {
      "voteAverage": 0,
      "link": "link",
      "voteCount": 0
    }
  },
  "slug": "some-slug",
  "rentrakTitle": 0,
  "movieAccessibility": {
    "id": 1,
    "movieId": 1,
    "iso31661": "DE",
    "gretaMovieId": "abc123",
    "hasClosedCaption": false,
    "hasAudioDescription": false,
    "hasSoundAmplification": false
  }
}

json

application/json

Sync movie with tmdb

POST

https://api.cineamo.com

/movies/{movieId}/fetch-tmdb

Syncs Movie with TMDB. It returns empty response.

Sync movie with tmdb › path Parameters

movieId

integer · required

Sync movie with tmdb › Responses

Movie was synced with TMDB.

No data returned

List movies

GET

https://api.cineamo.com

/movies

Returns a list of Movie objects.

List movies › query Parameters

page

integer

perPage

integer

sort

string

order

string

query

string

cineamoMovieId

string

Deprecated: use movieId instead (filters by the legacy Cineamo movie id).

movieId

integer

Filter movies by the numeric movie id (Movie.id).

releaseDateStart

string

releaseDateEnd

string

region

string

distributorId

integer

isShowingNow

boolean

cinemaCountryCode

string

type

string

List movies › Responses

200

A list of Movie objects

Movie[]

Movie

id

integer · readOnly · required

originalTitle

string · readOnly · required

tmdbId

integer | null · readOnly

title

string | null · readOnly

lastUpdated

integer | null · readOnly

isTmdbSyncSkipped

boolean | null · readOnly

series

boolean · readOnly

selectedByCinema

boolean · readOnly

adult

boolean · readOnly

backdropPath

string | null · readOnly

array | null · readOnly

homepage

string | null · readOnly

imdbId

string | null · readOnly

originalLanguage

string | null · readOnly

overview

string | null · readOnly

popularity

number · float · readOnly

posterPath

string | null · readOnly

array | null · readOnly

productionCountries

array | null · readOnly

releaseDate

string | null · readOnly

revenue

integer | null · readOnly

runtime

integer | null · readOnly

firstAirDate

string | null · readOnly

status

string | null · readOnly

tagline

string | null · readOnly

video

boolean | null · readOnly

voteAverage

number · float · readOnly

voteCount

integer · readOnly

readOnly

noRightsAvailable

boolean · readOnly

noRightsTimestamp

integer | null · readOnly

readOnly

slug

string | null · readOnly

rentrakTitle

integer | null · readOnly

readOnly

GET/movies

curl https://api.cineamo.com/movies

Example Responses

[
  {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "155m",
    "title": "Some Movie Title",
    "lastUpdated": 0,
    "isTmdbSyncSkipped": true,
    "series": true,
    "selectedByCinema": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "homepage": "homepage",
    "imdbId": "imdbId",
    "originalLanguage": "originalLanguage",
    "originalTitle": "Some Original Title",
    "overview": "Some movie overview...",
    "popularity": 0,
    "posterPath": "posterPath",
    "productionCompanies": [
      {
        "name": "name",
        "id": 0,
        "logoPath": "logoPath",
        "originCountry": "originCountry"
      }
    ],
    "productionCountries": [
      {}
    ],
    "releaseDate": "releaseDate",
    "revenue": 0,
    "runtime": 0,
    "firstAirDate": "firstAirDate",
    "status": "status",
    "tagline": "tagline",
    "video": true,
    "voteAverage": 0,
    "voteCount": 0,
    "alternativeTitles": {},
    "credits": {},
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "noRightsAvailable": true,
    "noRightsTimestamp": 0,
    "thirdParties": {
      "moviePilot": {
        "voteAverage": 0,
        "link": "link",
        "voteCount": 0
      }
    },
    "slug": "some-slug",
    "rentrakTitle": 0,
    "movieAccessibility": {
      "id": 1,
      "movieId": 1,
      "iso31661": "DE",
      "gretaMovieId": "abc123",
      "hasClosedCaption": false,
      "hasAudioDescription": false,
      "hasSoundAmplification": false
    }
  }
]

json

application/json

Get a movie

GET

https://api.cineamo.com

/movies/{imdbId}

Returns the requested movie.

Get a movie › path Parameters

imdbId

string · required

Get a movie › Responses

Movie details

Movie

id

integer · readOnly · required

originalTitle

string · readOnly · required

tmdbId

integer | null · readOnly

title

string | null · readOnly

lastUpdated

integer | null · readOnly

isTmdbSyncSkipped

boolean | null · readOnly

series

boolean · readOnly

selectedByCinema

boolean · readOnly

adult

boolean · readOnly

backdropPath

string | null · readOnly

array | null · readOnly

homepage

string | null · readOnly

imdbId

string | null · readOnly

originalLanguage

string | null · readOnly

overview

string | null · readOnly

popularity

number · float · readOnly

posterPath

string | null · readOnly

array | null · readOnly

productionCountries

array | null · readOnly

releaseDate

string | null · readOnly

revenue

integer | null · readOnly

runtime

integer | null · readOnly

firstAirDate

string | null · readOnly

status

string | null · readOnly

tagline

string | null · readOnly

video

boolean | null · readOnly

voteAverage

number · float · readOnly

voteCount

integer · readOnly

readOnly

noRightsAvailable

boolean · readOnly

noRightsTimestamp

integer | null · readOnly

readOnly

slug

string | null · readOnly

rentrakTitle

integer | null · readOnly

readOnly

GET/movies/{imdbId}

curl https://api.cineamo.com/movies/:imdbId

Example Responses

{
  "id": 1,
  "tmdbId": 1,
  "cineamoId": "155m",
  "title": "Some Movie Title",
  "lastUpdated": 0,
  "isTmdbSyncSkipped": true,
  "series": true,
  "selectedByCinema": true,
  "adult": true,
  "backdropPath": "backdropPath",
  "genres": [
    {
      "id": 0,
      "name": "name"
    }
  ],
  "homepage": "homepage",
  "imdbId": "imdbId",
  "originalLanguage": "originalLanguage",
  "originalTitle": "Some Original Title",
  "overview": "Some movie overview...",
  "popularity": 0,
  "posterPath": "posterPath",
  "productionCompanies": [
    {
      "name": "name",
      "id": 0,
      "logoPath": "logoPath",
      "originCountry": "originCountry"
    }
  ],
  "productionCountries": [
    {}
  ],
  "releaseDate": "releaseDate",
  "revenue": 0,
  "runtime": 0,
  "firstAirDate": "firstAirDate",
  "status": "status",
  "tagline": "tagline",
  "video": true,
  "voteAverage": 0,
  "voteCount": 0,
  "alternativeTitles": {},
  "credits": {},
  "images": {},
  "videos": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "translations": {
    "id": 0,
    "translations": 0
  },
  "releaseDates": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "noRightsAvailable": true,
  "noRightsTimestamp": 0,
  "thirdParties": {
    "moviePilot": {
      "voteAverage": 0,
      "link": "link",
      "voteCount": 0
    }
  },
  "slug": "some-slug",
  "rentrakTitle": 0,
  "movieAccessibility": {
    "id": 1,
    "movieId": 1,
    "iso31661": "DE",
    "gretaMovieId": "abc123",
    "hasClosedCaption": false,
    "hasAudioDescription": false,
    "hasSoundAmplification": false
  }
}

json

application/json

Get a movie

GET

https://api.cineamo.com

/movies/{movieSlug}

Returns the requested movie.

Get a movie › path Parameters

movieSlug

string · required

Get a movie › Responses

Movie details

Movie

id

integer · readOnly · required

originalTitle

string · readOnly · required

tmdbId

integer | null · readOnly

title

string | null · readOnly

lastUpdated

integer | null · readOnly

isTmdbSyncSkipped

boolean | null · readOnly

series

boolean · readOnly

selectedByCinema

boolean · readOnly

adult

boolean · readOnly

backdropPath

string | null · readOnly

array | null · readOnly

homepage

string | null · readOnly

imdbId

string | null · readOnly

originalLanguage

string | null · readOnly

overview

string | null · readOnly

popularity

number · float · readOnly

posterPath

string | null · readOnly

array | null · readOnly

productionCountries

array | null · readOnly

releaseDate

string | null · readOnly

revenue

integer | null · readOnly

runtime

integer | null · readOnly

firstAirDate

string | null · readOnly

status

string | null · readOnly

tagline

string | null · readOnly

video

boolean | null · readOnly

voteAverage

number · float · readOnly

voteCount

integer · readOnly

readOnly

noRightsAvailable

boolean · readOnly

noRightsTimestamp

integer | null · readOnly

readOnly

slug

string | null · readOnly

rentrakTitle

integer | null · readOnly

readOnly

GET/movies/{movieSlug}

curl https://api.cineamo.com/movies/:movieSlug

Example Responses

{
  "id": 1,
  "tmdbId": 1,
  "cineamoId": "155m",
  "title": "Some Movie Title",
  "lastUpdated": 0,
  "isTmdbSyncSkipped": true,
  "series": true,
  "selectedByCinema": true,
  "adult": true,
  "backdropPath": "backdropPath",
  "genres": [
    {
      "id": 0,
      "name": "name"
    }
  ],
  "homepage": "homepage",
  "imdbId": "imdbId",
  "originalLanguage": "originalLanguage",
  "originalTitle": "Some Original Title",
  "overview": "Some movie overview...",
  "popularity": 0,
  "posterPath": "posterPath",
  "productionCompanies": [
    {
      "name": "name",
      "id": 0,
      "logoPath": "logoPath",
      "originCountry": "originCountry"
    }
  ],
  "productionCountries": [
    {}
  ],
  "releaseDate": "releaseDate",
  "revenue": 0,
  "runtime": 0,
  "firstAirDate": "firstAirDate",
  "status": "status",
  "tagline": "tagline",
  "video": true,
  "voteAverage": 0,
  "voteCount": 0,
  "alternativeTitles": {},
  "credits": {},
  "images": {},
  "videos": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "translations": {
    "id": 0,
    "translations": 0
  },
  "releaseDates": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "noRightsAvailable": true,
  "noRightsTimestamp": 0,
  "thirdParties": {
    "moviePilot": {
      "voteAverage": 0,
      "link": "link",
      "voteCount": 0
    }
  },
  "slug": "some-slug",
  "rentrakTitle": 0,
  "movieAccessibility": {
    "id": 1,
    "movieId": 1,
    "iso31661": "DE",
    "gretaMovieId": "abc123",
    "hasClosedCaption": false,
    "hasAudioDescription": false,
    "hasSoundAmplification": false
  }
}

json

application/json

List movie trailers

GET

https://api.cineamo.com

/movies/{movieId}/trailers

Returns a list of MovieTrailer objects for a specific movie.

List movie trailers › path Parameters

movieId

integer · required

List movie trailers › query Parameters

page

integer

perPage

integer

sort

string

order

string

categories[]

string[] · style: form · explode: true

List movie trailers › Responses

MovieTrailer list

MovieTrailer

id

integer · readOnly · required

movieId

integer | null · readOnly

title

string · readOnly

url

string · readOnly

youtubeVideoId

string · readOnly

youtubeChannelId

string | null · readOnly

youtubeThumbnail

string | null · readOnly

thumbnail

string | null · readOnly

language

string | null · readOnly

providerId

string | null · readOnly

published

string | null · date-time · readOnly

views

integer | null · readOnly

imdbId

string | null · readOnly

tmdbId

integer | null · readOnly

categories

array | null · readOnly

List movies v2

GET

https://api.cineamo.com

/v2/movies

Returns a locale-aware paginated list of Movie objects.

List movies v2 › query Parameters

page

integer

perPage

integer

sort

string

order

string

query

string

cineamoMovieId

string

Deprecated: use movieId instead (filters by the legacy Cineamo movie id).

movieId

integer

Filter movies by the numeric movie id (Movie.id).

releaseDateStart

string

releaseDateEnd

string

region

string

distributorId

integer

isShowingNow

boolean

cinemaCountryCode

string

type

string

releaseYear

integer

Exact release year, e.g. ?releaseYear=1994. Unlike the fuzzy search year this matches the year exactly, which is what an archive listing needs.

directors

string[]

Filter by director name. Repeat for several: ?directors[]=Christopher Nolan&directors[]=Denis Villeneuve (OR). Matched against the movie's TMDB crew entries where job = "Director". At most 5 names are considered.

ratingsCountMin

integer · min: 0 · max: 100000

Keep only movies with at least this many Cineamo user ratings. Applies on any sort. Useful with sort=rating, where a movie with a single 10/10 rating otherwise outranks a well-rated movie with many. 0 means no minimum and behaves as if the parameter were omitted.

hasScheduledShowings

boolean

Keep only movies the cinema has a showing scheduled for from now on (true), or only those it has not (false). Requires the X-Cinema-Id header.

hasCustomization

boolean

Keep only movies the cinema has customized (true) or has not (false). Requires the X-Cinema-Id header.

hasRentrakTitle

boolean

Keep only movies that carry a Rentrak title (true) or that do not (false).

include

string

Comma-separated list of related resources to include.

List movies v2 › Responses

200

A paginated list of locale-aware Movie objects

MovieLocalizedList[]

V2 locale-aware movie list item DTO. A trimmed-down version of MovieLocalizedDto used when returning movies in a paginated collection. title, overview, and tagline are resolved from TMDB translation data for the requested locale (Accept-Language).

MovieLocalizedList

id

integer | null · readOnly

tmdbId

integer | null · readOnly

title

string | null · readOnly

originalTitle

string | null · readOnly

originalLanguage

string | null · readOnly

overview

string | null · readOnly

tagline

string | null · readOnly

locale

string · readOnly

series

boolean · readOnly

adult

boolean · readOnly

backdropPath

string | null · readOnly

posterPath

string | null · readOnly

slug

string | null · readOnly

imdbId

string | null · readOnly

popularity

number · float · readOnly

voteAverage

number · float · readOnly

voteCount

integer · readOnly

runtime

integer | null · readOnly

releaseDate

string | null · readOnly

status

string | null · readOnly

array | null · readOnly

lastUpdated

integer | null · readOnly

firstAirDate

string | null · readOnly

readOnly

TMDB release dates with Cineamo-curated age ratings overlaid; a country present in both has its TMDB entries replaced by the custom ones.

readOnly

preferedTrailerUrl

string | null · readOnly

Custom trailer URL from cinema customization

isCustomized

boolean · readOnly

True when an active cinema customization was applied

cinemaId

integer | null · readOnly

Present only when X-Cinema-Id header is provided

ratingAverage

number | null · float · readOnly

Average Cineamo user rating (1–10); null when no ratings exist yet

GET/v2/movies

curl https://api.cineamo.com/v2/movies

Example Responses

[
  {
    "id": 1,
    "tmdbId": 1,
    "cineamoId": "155m",
    "title": "Some Movie Title",
    "originalTitle": "Some Original Title",
    "originalLanguage": "en",
    "overview": "overview",
    "tagline": "tagline",
    "locale": "de-AT",
    "series": true,
    "adult": true,
    "backdropPath": "backdropPath",
    "posterPath": "posterPath",
    "slug": "some-slug",
    "imdbId": "imdbId",
    "popularity": 0,
    "voteAverage": 0,
    "voteCount": 0,
    "runtime": 0,
    "releaseDate": "releaseDate",
    "status": "status",
    "genres": [
      {
        "id": 0,
        "name": "name"
      }
    ],
    "lastUpdated": 0,
    "firstAirDate": "firstAirDate",
    "releaseDates": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "images": {},
    "videos": {
      "id": 0,
      "results": [
        "string"
      ]
    },
    "translations": {
      "id": 0,
      "translations": 0
    },
    "preferedTrailerUrl": "preferedTrailerUrl",
    "isCustomized": true,
    "cinemaId": 0,
    "ratingAverage": 0
  }
]

json

application/json

Get a movie by ID v2

GET

https://api.cineamo.com

/v2/movies/{movieId}

Returns a locale-aware Movie object by its Id.

Get a movie by ID v2 › path Parameters

movieId

integer · required

Get a movie by ID v2 › query Parameters

include

string

Comma-separated list of related resources to include.

Get a movie by ID v2 › Responses

Locale-aware Movie details

V2 locale-aware movie detail DTO. title, overview, and tagline are resolved from TMDB translation data for the requested locale (Accept-Language). All other fields are identical to V1.

MovieLocalized

id

integer | null · readOnly

tmdbId

integer | null · readOnly

title

string | null · readOnly

originalTitle

string | null · readOnly

originalLanguage

string | null · readOnly

overview

string | null · readOnly

tagline

string | null · readOnly

locale

string · readOnly

series

boolean · readOnly

adult

boolean · readOnly

backdropPath

string | null · readOnly

posterPath

string | null · readOnly

slug

string | null · readOnly

imdbId

string | null · readOnly

popularity

number · float · readOnly

voteAverage

number · float · readOnly

voteCount

integer · readOnly

runtime

integer | null · readOnly

releaseDate

string | null · readOnly

status

string | null · readOnly

array | null · readOnly

productionCountries

array | null · readOnly

lastUpdated

integer | null · readOnly

firstAirDate

string | null · readOnly

budget

integer | null · readOnly

revenue

integer | null · readOnly

homepage

string | null · readOnly

noRightsAvailable

boolean · readOnly

noRightsTimestamp

integer | null · readOnly

rentrakTitle

integer | null · readOnly

isTmdbSyncSkipped

boolean | null · readOnly

readOnly

array | null · readOnly

readOnly

TMDB release dates with Cineamo-curated age ratings overlaid; a country present in both has its TMDB entries replaced by the custom ones.

readOnly

preferedTrailerUrl

string | null · readOnly

Custom trailer URL from cinema customization

isCustomized

boolean · readOnly

True when an active cinema customization was applied

cinemaId

integer | null · readOnly

Present only when X-Cinema-Id header is provided

overridePosterImageRef

string | null · readOnly

Admin global poster-override asset ref (CIN-14124).

overrideBackdropImageRef

string | null · readOnly

Admin global backdrop-override asset ref (CIN-14124).

overrideLogoImageRef

string | null · readOnly

Uploaded custom logo asset ref (CIN-14159).

isPosterHidden

boolean · readOnly

True when the poster is hidden by an admin override (CIN-14124).

isBackdropHidden

boolean · readOnly

True when the backdrop is hidden by an admin override (CIN-14124).

isLogoHidden

boolean · readOnly

True when the logo is hidden by an admin override (CIN-14436).

GET/v2/movies/{movieId}

curl https://api.cineamo.com/v2/movies/:movieId

Example Responses

{
  "id": 1,
  "tmdbId": 1,
  "cineamoId": "155m",
  "title": "Some Movie Title",
  "originalTitle": "Some Original Title",
  "originalLanguage": "originalLanguage",
  "overview": "overview",
  "tagline": "tagline",
  "locale": "de-AT",
  "series": true,
  "adult": true,
  "backdropPath": "backdropPath",
  "posterPath": "posterPath",
  "slug": "some-slug",
  "imdbId": "imdbId",
  "popularity": 0,
  "voteAverage": 0,
  "voteCount": 0,
  "runtime": 0,
  "releaseDate": "releaseDate",
  "status": "status",
  "genres": [
    {
      "id": 0,
      "name": "name"
    }
  ],
  "productionCompanies": [
    {
      "name": "name",
      "id": 0,
      "logoPath": "logoPath",
      "originCountry": "originCountry"
    }
  ],
  "productionCountries": [
    {}
  ],
  "lastUpdated": 0,
  "firstAirDate": "firstAirDate",
  "budget": 0,
  "revenue": 0,
  "homepage": "homepage",
  "noRightsAvailable": true,
  "noRightsTimestamp": 0,
  "rentrakTitle": 0,
  "isTmdbSyncSkipped": true,
  "alternativeTitles": {},
  "credits": {},
  "images": {},
  "logos": [
    {
      "id": 1,
      "path": "path/to/image",
      "imageRef": "00000000-0000-0000-0000-000000000000",
      "imageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/image",
      "position": 1,
      "imageDescription": "Guests enjoying popcorn"
    }
  ],
  "videos": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "translations": {
    "id": 0,
    "translations": 0
  },
  "releaseDates": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "thirdParties": {
    "moviePilot": {
      "voteAverage": 0,
      "link": "link",
      "voteCount": 0
    }
  },
  "movieAccessibility": {
    "id": 1,
    "movieId": 1,
    "iso31661": "DE",
    "gretaMovieId": "abc123",
    "hasClosedCaption": false,
    "hasAudioDescription": false,
    "hasSoundAmplification": false
  },
  "preferedTrailerUrl": "preferedTrailerUrl",
  "isCustomized": true,
  "cinemaId": 0,
  "overridePosterImageRef": "overridePosterImageRef",
  "overrideBackdropImageRef": "overrideBackdropImageRef",
  "overrideLogoImageRef": "overrideLogoImageRef",
  "isPosterHidden": true,
  "isBackdropHidden": true,
  "isLogoHidden": true
}

json

application/json

Get a movie by slug v2

GET

https://api.cineamo.com

/v2/movies/{movieSlug}

Returns a locale-aware Movie object by its slug.

Get a movie by slug v2 › path Parameters

movieSlug

string · required

Get a movie by slug v2 › query Parameters

include

string

Comma-separated list of related resources to include.

Get a movie by slug v2 › Responses

Locale-aware Movie details

V2 locale-aware movie detail DTO. title, overview, and tagline are resolved from TMDB translation data for the requested locale (Accept-Language). All other fields are identical to V1.

MovieLocalized

id

integer | null · readOnly

tmdbId

integer | null · readOnly

title

string | null · readOnly

originalTitle

string | null · readOnly

originalLanguage

string | null · readOnly

overview

string | null · readOnly

tagline

string | null · readOnly

locale

string · readOnly

series

boolean · readOnly

adult

boolean · readOnly

backdropPath

string | null · readOnly

posterPath

string | null · readOnly

slug

string | null · readOnly

imdbId

string | null · readOnly

popularity

number · float · readOnly

voteAverage

number · float · readOnly

voteCount

integer · readOnly

runtime

integer | null · readOnly

releaseDate

string | null · readOnly

status

string | null · readOnly

array | null · readOnly

productionCountries

array | null · readOnly

lastUpdated

integer | null · readOnly

firstAirDate

string | null · readOnly

budget

integer | null · readOnly

revenue

integer | null · readOnly

homepage

string | null · readOnly

noRightsAvailable

boolean · readOnly

noRightsTimestamp

integer | null · readOnly

rentrakTitle

integer | null · readOnly

isTmdbSyncSkipped

boolean | null · readOnly

readOnly

array | null · readOnly

readOnly

TMDB release dates with Cineamo-curated age ratings overlaid; a country present in both has its TMDB entries replaced by the custom ones.

readOnly

preferedTrailerUrl

string | null · readOnly

Custom trailer URL from cinema customization

isCustomized

boolean · readOnly

True when an active cinema customization was applied

cinemaId

integer | null · readOnly

Present only when X-Cinema-Id header is provided

overridePosterImageRef

string | null · readOnly

Admin global poster-override asset ref (CIN-14124).

overrideBackdropImageRef

string | null · readOnly

Admin global backdrop-override asset ref (CIN-14124).

overrideLogoImageRef

string | null · readOnly

Uploaded custom logo asset ref (CIN-14159).

isPosterHidden

boolean · readOnly

True when the poster is hidden by an admin override (CIN-14124).

isBackdropHidden

boolean · readOnly

True when the backdrop is hidden by an admin override (CIN-14124).

isLogoHidden

boolean · readOnly

True when the logo is hidden by an admin override (CIN-14436).

GET/v2/movies/{movieSlug}

curl https://api.cineamo.com/v2/movies/:movieSlug

Example Responses

{
  "id": 1,
  "tmdbId": 1,
  "cineamoId": "155m",
  "title": "Some Movie Title",
  "originalTitle": "Some Original Title",
  "originalLanguage": "originalLanguage",
  "overview": "overview",
  "tagline": "tagline",
  "locale": "de-AT",
  "series": true,
  "adult": true,
  "backdropPath": "backdropPath",
  "posterPath": "posterPath",
  "slug": "some-slug",
  "imdbId": "imdbId",
  "popularity": 0,
  "voteAverage": 0,
  "voteCount": 0,
  "runtime": 0,
  "releaseDate": "releaseDate",
  "status": "status",
  "genres": [
    {
      "id": 0,
      "name": "name"
    }
  ],
  "productionCompanies": [
    {
      "name": "name",
      "id": 0,
      "logoPath": "logoPath",
      "originCountry": "originCountry"
    }
  ],
  "productionCountries": [
    {}
  ],
  "lastUpdated": 0,
  "firstAirDate": "firstAirDate",
  "budget": 0,
  "revenue": 0,
  "homepage": "homepage",
  "noRightsAvailable": true,
  "noRightsTimestamp": 0,
  "rentrakTitle": 0,
  "isTmdbSyncSkipped": true,
  "alternativeTitles": {},
  "credits": {},
  "images": {},
  "logos": [
    {
      "id": 1,
      "path": "path/to/image",
      "imageRef": "00000000-0000-0000-0000-000000000000",
      "imageUrl": "https://cdn.example.com/00000000-0000-0000-0000-000000000000/image",
      "position": 1,
      "imageDescription": "Guests enjoying popcorn"
    }
  ],
  "videos": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "translations": {
    "id": 0,
    "translations": 0
  },
  "releaseDates": {
    "id": 0,
    "results": [
      "string"
    ]
  },
  "thirdParties": {
    "moviePilot": {
      "voteAverage": 0,
      "link": "link",
      "voteCount": 0
    }
  },
  "movieAccessibility": {
    "id": 1,
    "movieId": 1,
    "iso31661": "DE",
    "gretaMovieId": "abc123",
    "hasClosedCaption": false,
    "hasAudioDescription": false,
    "hasSoundAmplification": false
  },
  "preferedTrailerUrl": "preferedTrailerUrl",
  "isCustomized": true,
  "cinemaId": 0,
  "overridePosterImageRef": "overridePosterImageRef",
  "overrideBackdropImageRef": "overrideBackdropImageRef",
  "overrideLogoImageRef": "overrideLogoImageRef",
  "isPosterHidden": true,
  "isBackdropHidden": true,
  "isLogoHidden": true
}

json

application/json

Genres Movie Accessibilities