Content Restrictions (Enterprise plan)

How territory-based content restrictions are delivered in API responses.

This page covers content restrictions for the Enterprise plan. For self-serve plan restrictions, see Content Restrictions for self-serve plans.

Restrictions on content are applied for a number of reasons; however, it all comes down to preserving copyright owners and preventing legal queries.

Within every API response that includes lyrics or subtitles we’re going to provide a territory-based restriction data which will allow you to identify the countries you are allowed to display that content in.

It is imperative that you apply the updates of the country-restriction data as soon as possible.

We expect these updates to happen ideally on the day the update is made available to you as they may, for example, include a restriction included as a result of a takedown notice.

This restriction block contains two sets, the allowed and the blocked countries:

• Countries are identified with the ISO 3166-1 alpha-2 standard
• XW Identifies every country

There are two different types of possible configurations:

1. All the world allowed with the exception of a specific set of countries (that is usually empty)

• region_restriction: { allowed: [XW], blocked: [] }
  This means you can display the lyrics in every country.
• region_restriction: { allowed: [XW], blocked: [US,CA] }
  This means you cannot display the lyrics in the USA and in Canada.

2. All the world is NOT allowed, with the exclusion of zero or few countries

• region_restriction: { allowed: [], blocked: [XW] }
  This means you cannot display the lyrics in any country.
• region_restriction: { allowed: [IT], blocked: [XW] }
  This means you can only display the lyrics in Italy.

Examples

Worldwide restriction

Feed for track Serpentskirt by Cocteau Twins is restricted worldwide (XW):

{
  "message": {
    "header": {
      "status_code": 200,
      "execute_time": 0.010541915893555
    },
    "body": {
      "lyrics": {
        "lyrics_id": 29476108,
        "explicit": 0,
        "lyrics_body": "",
        "lyrics_language": "en",
        "script_tracking_url": "...",
        "pixel_tracking_url": "...",
        "lyrics_copyright": "...",
        "updated_time": "2024-02-08T16:59:28Z",
        "region_restriction": {
          "allowed": [
            
          ],
          "blocked": [
            "XW"
          ]
        }
      }
    }
  }
}

Country based restriction

Feed for track Ciao amore by Adriano Celentano is restricted in Italy (IT):

{
  "message": {
    "header": {
      "status_code": 200,
      "execute_time": 0.0080831050872803
    },
    "body": {
      "lyrics": {
        "lyrics_id": 23204457,
        "explicit": 0,
        "lyrics_body": "...",
        "lyrics_language": "it",
        "script_tracking_url": "...",
        "pixel_tracking_url": "...",
        "lyrics_copyright": "...",
        "updated_time": "2023-08-29T13:48:46Z",
        "region_restriction": {
          "allowed": [
            "XW"
          ],
          "blocked": [
            "IT"
          ]
        }
      }
    }
  }
}