Country restrictions

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 allows 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 can not 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 can not 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"
          ]
        }
      }
    }
  }
}