Record

record - Everything about your Records

Note: This resource links can be expanded using the expand option.

The record resource represents an Abstracted Version of a given feature or episode of a series (i.e. the production release version with no edits.), and that Abstracted Version can be then held in multiple compliance versions (with/without violence, cultural themes etc.) and video/audio renditions below that (different bit rates, different video formats, etc..)

This is how a record looks through the API:

{
  "ids": {
    "meta_id": "string",
    "house_id": "string",
    "eidr_id": "string"
  },
  "origination": {
    "type": "string",
    "locale": "string",
    "first_release_year": 0,
    "producers": [
      {
        "text": "string",
        "ranking": "integer"
      }
    ]
  },
  "descriptions": {
    "synopsis60": {
      "synopsis": "string",
      "locale": "string",
      "comment": "string",
      "status": "string",
      "api_name": "string"
    },
    "synopsis250": {
      "synopsis": "string",
      "locale": "string",
      "comment": "string",
      "status": "string",
      "api_name": "string"
    },
    "synopsis1000": {
      "synopsis": "string",
      "locale": "string",
      "comment": "string",
      "status": "string",
      "api_name": "string"
    }
  },
  "titles": {
    "original": [
      {
        "title": "string",
        "comment": "string",
        "locale": "string"
      }
    ],
    "alternative": [
      {
        "title": "string",
        "comment": "string",
        "locale": "string"
      }
    ]
  },
  "descriptors": {
    "moods": [
      {
        "text": "string",
        "ranking": 0
      }
    ],
    "genres": [
      {
        "text": "string",
        "ranking": 0
      }
    ],
    "subgenres": [
      {
        "text": "string",
        "ranking": 0
      }
    ]
  },
  "classification": {
    "minimum_age": 0,
    "maximum_age": 0
  },
  "rights": [
    {
      "type": "string",
      "licensor": "string",
      "license_start": "string",
      "license_end": "string",
      "business_model_name": "string",
      "business_model_code": "string",
      "country_iso": "string"
    }
  ],
  "certifications": [
    {
      "certification_type": "string",
      "region": "string",
      "system": "string",
      "type": "string",
      "environment": "string",
      "official_rating": "string"
    }
  ],
  "links": [
    {
      "name": "string",
      "url": "string"
    }
  ],
  "images": [
    {
      "poster": true,
      "name": "string",
      "image_type": "string",
      "locale": "string",
      "asset_bank_id": "string",
      "comment": "string",
      "countries": [
        {
          "text": "string",
          "value": "string"
        }
      ]
    }
  ],
  "contributors": [
    {
      "name": "string",
      "role": "string",
      "role_name": "string",
      "character_name": "string",
      "ranking": 0
    }
  ],
  "linkage": {
    "children": [
      {
        "meta_id": "string",
        "original_title": "string",
        "first_release_year": 0,
        "category_name": "string",
        "type": "string"
      }
    ],
    "parents": [
      {
        "meta_id": "string",
        "original_title": "string",
        "first_release_year": 0,
        "category_name": "string",
        "type": "string"
      }
    ]
  }
}
 

Valid attributes

  • meta_id (required): Meta internal identifier of the asset. It mustn’t be supplied in the creation of the asset, because Meta will set this attribute.

  • house_id  (required): Client’s unique identifier of the asset. Required to be supplied with creation of the asset for de-duplication purposes.

  • original_title (required): the Original Title of the asset. It should be the Original English Title if available for EIDR matching purposes.

  • first_release_year (required): the year of first release of the Original Record.

  • release_duration (optional): the duration of the deliverable asset. Format is total seconds. This field is optional on record create but required for EIDR matching purposes.

Create a record

POST /record/create

Curl:

curl -X POST "https://meta.live/api/v1/record/create" -H "accept: application/json" -H "Content-Type: application/json" -d "{ \"ids\": { \"house_id\": \"FFVOXLUX2018KILNP\", }, \"origination\": { \"type\": \"Live Action\", \"locale\": \"USA\", \"first_release_year\": \"2018\",} \"titles\": { \"original\": [ { \"title\": \"Vox Lux\", \"locale\": \"ENG\" } ], },}"

Fetch a record

GET /record/{metaId}

Curl:

curl -X GET "https://meta.live/api/v1/record/FE0000001" -H "accept: application/json"

Request URL

https://meta.live/api/v1/record/FE0000001

Delete a Record

DELETE /record/{metaId}

Upload Image for a Record

POST /record/{metaId}/image

Curl:

curl -X POST "https://meta.live/api/v1/record/FE0000001/image" -H "accept: application/json" -H "Content-Type: multipart/form-data" -F "additionalMetadata=Poster" -F "file=@Meta-Black-on-White-TALL.png;type=image/png"