Music Search

Query Parameters

query

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.

continuation

string

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

Response

query

string

The search query that was executed.

results

array

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

Show SearchResult object

type

string

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

video_id

string

Track / video id (nullable).

title

string

Track or item title (nullable).

url

string

Full URL to the item (nullable).

thumbnail

string

Best thumbnail / cover art URL (nullable).

duration

string

Human-readable duration (nullable).

length_seconds

integer

Duration in seconds (nullable).

view_count_text

string

Play / view count as displayed (nullable).

channel_id

string

Artist channel id (nullable).

channel_name

string

Artist / uploader name (nullable).

channel_is_verified

boolean

Whether the artist channel is verified (nullable).

playlist_id

string

Album / playlist id (playlist results, nullable).

video_count

integer

Track count (album / playlist results, nullable).

continuation

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