Common

Notice

This document is a machine-translated draft and is currently undergoing review. Some content may be inaccurate or differ from the original Korean version. For the most precise information, refer to the Korean documentation.

Go to Common API v3 Reference→

Feature scope by version

• Retrieve country and time zone lists: This is a newly added feature in v3 and is not supported in v1 or v2.
• Retrieve language list: All versions support retrieving the language list.
• Common authentication: APIs in all versions use the common authentication method via a query string parameter (?access_token=). For the common specification on error determination criteria, refer to the Core Changes section of the API v3 migration guide.

---

Retrieve country list

• Previous (v1/v2): Not supported
• Changed (v3): GET /countries

Request and response structure details

Request body and parameters

This is a simple lookup endpoint with no additional parameters (Path/Query/Body) to pass.

Response field specifications

Field	Data type	Description
id	Integer	Unique country ID
english_name	String	Country name (English notation)
native_name	String	Country name (native language notation)
code_2char	String	ISO standard 2-letter country code (e.g., kr)
code_3char	String	ISO standard 3-letter country code (e.g., kor)
short_name	String	Short country name

Response structure specification

{
  "data": [
    {
      "id": 115,
      "english_name": "Korea, Republic of",
      "native_name": "대한민국",
      "code_2char": "kr",
      "code_3char": "kor",
      "short_name": "South Korea"
    }
  ]
}

---

Retrieve language list

• Previous (v1): GET /media/subtitle/languages
• Previous (v2): GET /vod/languages
• Changed (v3): GET /languages

---

Retrieve time zone list

• Previous (v1/v2): Not supported
• Changed (v3): GET /timezones

Request and response structure details

Request body and parameters

This is a simple lookup endpoint with no additional parameters (Path/Query/Body) to pass.

Response structure specification

Returns data in a two-level nested JSON object structure grouped by continent.

{
  "data": [
    {
      "name": "Asia",
      "timezones": [
        {
          "key": "Asia/Seoul",
          "value": "Seoul, UTC+09:00"
        }
      ]
    }
  ]
}