API docs by Redocly

Shift72 Discovery API (1.0.0)

Download OpenAPI specification:Download

APIs and integrations for discovering content on your site.

Get films

Gets availability information about the published films on the site.

This API currently requires a valid authtoken or API key to use.

Authorizations:
AuthTokenApiKey

Responses

Response Schema: application/json
Array
slug
string

The slug of the film

title
string

Title of the film

release_year
string or null

Release year of the film, if known. This is provided to help matching.

director
string or null

Director of the film if known. This is provided to help matching.

available_from
string or null <date-time>

The earliest time the film can be watched. A film may be purchasable before this time (i.e. in presale). If null, the film is watchable immediately.

available_to
string or null <date-time>

The end time of the film's availability. This is a hard cut off, and playbacks past this point may error out due to license expiry.

country_codes
Array of strings

The countries where this film is available to watch.

object or null

Additional ids from the film metadata

letterboxd_id
string

The Letterboxd LID. This can be set from a film's Integrations tab in admin. This value may be missing or an empty string.

property name*
additional property
any
Array of objects

The classifications that for this media

Array
geo_region
string

ISO 3166-1 (alpha 2) or ISO 3166-2 code to represent location, converted to lowercase. Most of the time, this will be a country code, e.g. "ca", but may be a subdivision, e.g. "ca-qc"

code
string

The rating code, e.g. "PG" or "R"

advisory_text
string

The type of material the media contains

Response samples

Content type
application/json
[
  • {
    • "slug": "/film/281",
    • "title": "Citizen Kane",
    • "director": "Orson Welles",
    • "release_year": "1941",
    • "available_from": "2023-08-18T00:00:00.000Z",
    • "available_to": null,
    • "country_codes": [
      • "nz",
      • "au"
      ],
    • "refs": {
      • "letterboxd_id": "71O"
      },
    • "classifications": [
      • {
        },
      • {
        }
      ]
    }
]

MRSS feed for Google Ad Manager

An Atom XML feed for syncing content into Google Ad Manager to allow targeted client-side ads based on video content.

This contains information about the published media on your platform, with keyvalues such as genre, classification, etc. that can be used by advertisers to target certain content.

This feed is paginated and ordered by most recently updated as required by the Google Ad Manager platform. The XML contains self and next tags for pagination.

This may be compatible with other supply side platforms that accept the same schema.

query Parameters
page
number

Allows you to page through the content.

size
number

How many items in each page? (default: 100)

Responses

Response samples

Content type
text/xml
<rss xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dfpvideo="http://api.google.com/dfpvideo" xmlns:tms="http://data.tmsapi.com/v1.1" version="2.0">
  <channel>
    <title>My site</title>
    <link>https://vod.shift72.com</link>

    <item>
      <dfpvideo:contentId>/film/281</dfpvideo:contentId>
      <title>Citizen Kane</title>
      <dfpvideo:lastModifiedDate>2024-09-01T22:24:45.876Z</dfpvideo:lastModifiedDate>
      <!-- etc -->
    </item>
  </channel>
</rss>

JustWatch feed

Provides information about published media on your platform suitable for integration with JustWatch.

https://apis.justwatch.com/docs/streaming_service/

Responses

Response Schema: application/json
object

Response samples

Content type
application/json
{
  • "streaming_service": {},
  • "content": [
    • {
      • "id": "/film/281",
      • "object_type": "movie",
      • "original_title": "Citizen Kane",
      • "release_year": 1941,
      • "offers": [
        ]
      }
    ]
}