Languages

International language codes for content localization and regional distribution

Resource Overview

Languages provide standardized ISO language codes for content localization and regional distribution. This reference data enables proper content categorization for international music distribution platforms and helps with regional content discovery. Languages are read-only reference data.

Base Endpoint
/languages
Resource Type
languages
Access Level
Read-only reference data

Schema

Read-only Attributes

Field Type Description
id string Unique identifier
name string English name of the language (e.g., "Spanish", "French")
code string ISO 639-1 language code (e.g., "es", "fr", "en")

Usage in Other Resources

Related Resources

  • • Albums: Primary language of album content
  • • Tracks: Language of lyrics and vocal content
  • • Users: Interface language preference
  • • Translations: Localized content for different markets
  • • ISO Standards: Compliant with ISO 639-1 language codes

List Languages

GET /languages Read Only 
GET /languages
Authorization: Bearer {token}
Accept: application/vnd.api+json

Query Parameters

Filtering

  • • filter[lang-name] - Filter by language name
  • • filter[lang-code] - Filter by language code

Other Parameters

  • • sort - Sort by name or code
  • • page[number] - Page number
  • • page[size] - Results per page

Example Request

GET /languages?sort=name&page[size]=20

Success Response

200 OK 
{
  "data": [
    {
      "type": "languages",
      "id": "1",
      "attributes": {
        "name": "English",
        "code": "en"
      }
    },
    {
      "type": "languages",
      "id": "2",
      "attributes": {
        "name": "Spanish",
        "code": "es"
      }
    },
    {
      "type": "languages",
      "id": "3",
      "attributes": {
        "name": "French",
        "code": "fr"
      }
    },
    {
      "type": "languages",
      "id": "4",
      "attributes": {
        "name": "German",
        "code": "de"
      }
    },
    {
      "type": "languages",
      "id": "5",
      "attributes": {
        "name": "Portuguese",
        "code": "pt"
      }
    }
  ],
  "meta": {
    "page": {
      "current-page": 1,
      "per-page": 20,
      "total": 45,
      "last-page": 3
    }
  }
}

Get Single Language

GET /languages/{id} 
GET /languages/2
Authorization: Bearer {token}
Accept: application/vnd.api+json

Success Response

200 OK 
{
  "data": {
    "type": "languages",
    "id": "2",
    "attributes": {
      "name": "Spanish",
      "code": "es"
    }
  }
}

Popular Languages

Western Languages

  • • English (en)
  • • Spanish (es)
  • • French (fr)
  • • German (de)
  • • Portuguese (pt)
  • • Italian (it)

Asian Languages

  • • Japanese (ja)
  • • Korean (ko)
  • • Mandarin Chinese (zh)
  • • Hindi (hi)
  • • Thai (th)
  • • Vietnamese (vi)

Regional & Other

  • • Russian (ru)
  • • Arabic (ar)
  • • Dutch (nl)
  • • Swedish (sv)
  • • Polish (pl)
  • • Turkish (tr)

Music Industry

  • • Portuguese (Brazil)
  • • Spanish (Latin America)
  • • English (International)
  • • French (Canada)
  • • German (Austria/Switzerland)
  • • Instrumental (no lyrics)

DSP Requirements

  • • Spotify: ISO 639-1 codes
  • • Apple Music: Language metadata
  • • YouTube Music: Localization
  • • Amazon Music: Regional content
  • • Deezer: Multi-language support
  • • Tidal: International markets

Special Categories

  • • Multiple Languages
  • • Unknown Language
  • • Constructed Languages
  • • Regional Dialects
  • • Sign Language
  • • Ancient Languages

Integration Guidelines

Best Practices

  • • Cache language list for optimal performance
  • • Use ISO 639-1 codes for consistency
  • • Consider regional variants when applicable
  • • Validate language IDs before content creation
  • • Support multiple languages for international content

DSP Distribution

  • • Spotify requires language metadata
  • • Apple Music uses language for discovery
  • • YouTube Music needs localization data
  • • Amazon Music regional requirements
  • • International DSP compliance standards

Important Notes

  • • Languages are read-only reference data
  • • New languages require system admin approval
  • • Language codes follow ISO 639-1 standard
  • • Consider instrumental content separately
  • • Multi-language content needs special handling

Localization Benefits

  • • Improved regional content discovery
  • • Better recommendation algorithms
  • • Enhanced user experience by language
  • • Compliance with local market requirements
  • • Support for international distribution