Music Search

Query Parameters

string

required

Search keywords.

string

default:"US"

Content region (ISO 3166-1 alpha-2). Examples: US, GB, DE, JP.

string

default:"en"

UI / interface language (BCP-47). Examples: en, de, fr, ja.

string

Continuation token from a previous response to fetch the next page.

Response

string

The search query that was executed.

array

Array of YouTube Music results (polymorphic SearchResult shape, keyed by type).

Show SearchResult object

string

Result type, e.g. video, channel (artist), or playlist (album).

string

Track / video id (nullable).

string

Track or item title (nullable).

string

Full URL to the item (nullable).

string

Best thumbnail / cover art URL (nullable).

string

Human-readable duration (nullable).

integer

Duration in seconds (nullable).

string

Play / view count as displayed (nullable).

string

Artist channel id (nullable).

string

Artist / uploader name (nullable).

boolean

Whether the artist channel is verified (nullable).

string

Album / playlist id (playlist results, nullable).

integer

Track count (album / playlist results, nullable).

string

Token to fetch the next page (nullable when no more pages).

Example Response

{
  "query": "never gonna give you up",
  "results": [
    {
      "type": "video",
      "video_id": "dQw4w9WgXcQ",
      "title": "Never Gonna Give You Up",
      "url": "https://music.youtube.com/watch?v=dQw4w9WgXcQ",
      "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
      "duration": "3:33",
      "length_seconds": 213,
      "view_count_text": "1.6B plays",
      "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
      "channel_name": "Rick Astley",
      "channel_is_verified": true
    }
  ],
  "continuation": "EpcDEgxuZXZlciBnb25uYS..."
}

Each music-search request costs 5 credits. Failed requests are not charged.

Overview

Search & Discovery

Videos & Shorts

Channels

Playlists & Community

Query Parameters

Response

Example Response

​Query Parameters

​Response

​Example Response

Query Parameters

Response

Example Response