Start building

YouTube Related Videos (Web V2)

https://api.sandbase.ai/v1/api/youtube/web-v2/related-videos

Returns a list of related videos for a given YouTube video by ID or URL. Includes an option to format the returned output structure.

Try this APIGet API key
Price
$0.0015USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
0 required · 3 optional
Production route

Try the model

Playground

Open playground
Input
Whether to format data (default true)
Video ID (recommended)
Full video URL (optional, ignored if video_id is provided)
OutputExample
Responseoutputs · 21.5 KB · 490 lines
[
  {
    "data": {
      "related_videos": [
        {
          "author": "Legends 80s Music",
          "author_id": "UCLYghx74Jmn2hQ62qhm6FkQ",
          "author_url": "https://www.youtube.com/channel/UCLYghx74Jmn2hQ62qhm6FkQ",
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "Streamed 2 months ago",
          "thumbnails": [
            {
              "height": 94,
              "url": "https://i.ytimg.com/vi/SdWBgeFxb2M/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLDuCFK2Y-iq4HR9h-3ZFnZwYX8Ziw",
              "width": 168
            },
            {
              "height": 188,
              "url": "https://i.ytimg.com/vi/SdWBgeFxb2M/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDXpvWlpIlQyY7PrSZOOUUkBkfqtQ",
              "width": 336
            }
          ],
          "title": "Best of 80s Music Legends - Tears For Fears, Madonna, Cyndi Lauper, Modern Talking, Michael Jackson",
          "video_id": "SdWBgeFxb2M",
          "video_url": "https://www.youtube.com/watch?v=SdWBgeFxb2M",
          "view_count_text": "2.3M views"
        },
        {
          "author": "Jaime Bayly",
          "author_id": "UCXpBQR0HEcj56-spwHvDSIg",
          "author_url": "https://www.youtube.com/channel/UCXpBQR0HEcj56-spwHvDSIg",
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "9 hours ago",
          "thumbnails": [
            {
              "height": 94,
              "url": "https://i.ytimg.com/vi/BlfSjG7hcwI/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLCm93umqC1RT_jni5sg-CymweH8fA",
              "width": 168
            },
            {
              "height": 188,
              "url": "https://i.ytimg.com/vi/BlfSjG7hcwI/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBGD26OMJkvjf61MQh6ZFugvXaesw",
              "width": 336
            }
          ],
          "title": "Solo el 33% lo aprueba",
          "video_id": "BlfSjG7hcwI",
          "video_url": "https://www.youtube.com/watch?v=BlfSjG7hcwI",
          "view_count_text": "52K views"
        },
        {
          "author": "Highway Roots Music",
          "author_id": "UC1Y72Gde1MOEV-TgFywDlDA",
          "author_url": "https://www.youtube.com/channel/UC1Y72Gde1MOEV-TgFywDlDA",
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "4 months ago",
          "thumbnails": [
            {
              "height": 94,
              "url": "https://i.ytimg.com/vi/uzaVxDQ6Dk4/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLClqh_mFhls0R52Y5SRD-oiKTPQMQ",
              "width": 168
            },
            {
              "height": 188,
              "url": "https://i.ytimg.com/vi/uzaVxDQ6Dk4/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCm2FOgMCD8P5g0Xs6acJzQ6RXwlQ",
              "width": 336
            }
          ],
          "title": "Whiskey Blues Playlist 20 Best Slow Blues Songs  Late Night Blues Mix",
          "video_id": "uzaVxDQ6Dk4",
          "video_url": "https://www.youtube.com/watch?v=uzaVxDQ6Dk4",
          "view_count_text": "1.2M views"
        },
        {
          "author": "Nickromantix ",
          "author_id": "UCBcIWBMGYVlwGQw5T3Tj-Cw",
          "author_url": "https://www.youtube.com/channel/UCBcIWBMGYVlwGQw5T3Tj-Cw",
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "2 years ago",
          "thumbnails": [
            {
              "height": 94,
              "url": "https://i.ytimg.com/vi/1E30uKYHiEk/hqdefault.jpg?sqp=-oaymwE1CKgBEF5IVfKriqkDKAgBFQAAiEIYAXABwAEG8AEB-AG-B4AC0AWKAgwIABABGF4gZShAMA8=&rs=AOn4CLCtOPEOquxhwXOHGfOH5DTCrpD3_g",
              "width": 168
            },
            {
              "height": 188,
              "url": "https://i.ytimg.com/vi/1E30uKYHiEk/hqdefault.jpg?sqp=-oaymwE2CNACELwBSFXyq4qpAygIARUAAIhCGAFwAcABBvABAfgBvgeAAtAFigIMCAAQARheIGUoQDAP&rs=AOn4CLAigaUlGD9y858hh7TTYP-3XE8kfA",
              "width": 336
            }
          ],
          "title": "Never Gonna Mix You Up (Part 2) - Rick Astley",
          "video_id": "1E30uKYHiEk",
          "video_url": "https://www.youtube.com/watch?v=1E30uKYHiEk",
          "view_count_text": "1.4M views"
        },
        {
          "author": "LA LA DISCO",
          "author_id": "UCWfsY5Czam2cR-rZR-Uq-Bg",
          "author_url": "https://www.youtube.com/channel/UCWfsY5Czam2cR-rZR-Uq-Bg",
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "1 month ago",
          "thumbnails": [
            {
              "height": 94,
              "url": "https://i.ytimg.com/vi/y6Z5zTlz6-k/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLCc9pxnzQl1peEMW9E6cAcBaXfcVQ",
              "width": 168
            },
            {
              "height": 188,
              "url": "https://i.ytimg.com/vi/y6Z5zTlz6-k/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCq_dC1XFK9EoaYJvvUra3hOueDYg",
              "width": 336
            }
          ],
          "title": "80s Flashback Hits | Michael Jackson, ABBA, Toto, Bee Gees",
          "video_id": "y6Z5zTlz6-k",
          "video_url": "https://www.youtube.com/watch?v=y6Z5zTlz6-k",
          "view_count_text": "542K views"
        },
        {
          "author": "Retro Soft Rock Hits and Dawnlume Worship",
          "author_id": null,
          "author_url": null,
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "1 month ago",
          "thumbnails": [
            {
              "height": 94,
              "url": "https://i.ytimg.com/vi/ktXltB5QX8Q/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLCncELwuZekYQRVFPEF1VczHvbXGg",
              "width": 168
            },
            {
              "height": 188,
              "url": "https://i.ytimg.com/vi/ktXltB5QX8Q/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDxUPQBMJQO5oQMEr3vqIzqBsyT1g",
              "width": 336
            }
          ],
          "title": "Soft Rock Love Songs 70s 80s 90s 🎧 Bryan Adams, Aerosmith, George Michael, Bee Gees, Phil Collins",
          "video_id": "ktXltB5QX8Q",
          "video_url": "https://www.youtube.com/watch?v=ktXltB5QX8Q",
          "view_count_text": "3.7M views"
        },
        {
          "author": "Zenith Bossa Flux",
          "author_id": "UCu6QWa9Z94FfZjWt4Bxdhyw",
          "author_url": "https://www.youtube.com/channel/UCu6QWa9Z94FfZjWt4Bxdhyw",
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "2 days ago",
          "thumbnails": [
            {
              "height": 94,
              "url": "https://i.ytimg.com/vi/yzou01wSuew/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLBXOxQmSzoWsl8fNW22APTndcI3Zg",
              "width": 168
            },
            {
              "height": 188,
              "url": "https://i.ytimg.com/vi/yzou01wSuew/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBIbHsdd5EOoKPjqKwBEFdxRZUMsw",
              "width": 336
            }
          ],
          "title": "Bossa Nova Covers of Popular Songs 2026 🌴 Smooth & Relaxing Jazz Playlist for Coffee Time",
          "video_id": "yzou01wSuew",
          "video_url": "https://www.youtube.com/watch?v=yzou01wSuew",
          "view_count_text": "287 views"
        },
        {
          "author": "Jazz Music",
          "author_id": "UCsYoYa-ulCHwOURDIqA2BCg",
          "author_url": "https://www.youtube.com/channel/UCsYoYa-ulCHwOURDIqA2BCg",
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "2 years ago",
          "thumbnails": [
            {
              "height": 94,
              "url": "https://i.ytimg.com/vi/CebtTGlCVQA/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLDtT1_7fvNT6gI_SD3Y-0la_o1fVw",
              "width": 168
            },
            {
              "height": 188,
              "url": "https://i.ytimg.com/vi/CebtTGlCVQA/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCB-bLXvSdyFPMpzsu3td2YsT96aQ",
              "width": 336
            }
          ],
          "title": "The Very Best Of F.r.a.n.k S.i.n.a.t.r.a | F.r.a.n.k S.i.n.a.t.r.a Greatest Hits Collection 2023",
          "video_id": "CebtTGlCVQA",
          "video_url": "https://www.youtube.com/watch?v=CebtTGlCVQA",
          "view_count_text": "109K views"
        },
        {
          "author": "Wizz Music",
          "author_id": "UCT2l1lLLER9JaDyhyAV75NA",
          "author_url": "https://www.youtube.com/channel/UCT2l1lLLER9JaDyhyAV75NA",
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "1 year ago",
          "thumbnails": [
            {
              "height": 94,
              "url": "https://i.ytimg.com/vi/0k61x-mHORw/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLAOroxr-jrnOp9SNxqyFLHuvsO0eg",
              "width": 168
            },
            {
              "height": 188,
              "url": "https://i.ytimg.com/vi/0k61x-mHORw/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLByuGeD5z3KXUS9I1cUsB97NQwVHw",
              "width": 336
            }
          ],
          "title": "Smooth Soul Jazz for Deep Focus & Flow | Soul Vol.01 (Ride the Flow)",
          "video_id": "0k61x-mHORw",
          "video_url": "https://www.youtube.com/watch?v=0k61x-mHORw",
          "view_count_text": "1.9M views"
        },
        {
          "author": "Timeless Rock Classics",
          "author_id": "UC8BP-W5aHQih7peTzUy9I3g",
          "author_url": "https://www.youtube.com/channel/UC8BP-W5aHQih7peTzUy9I3g",
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "7 days ago",
          "thumbnails": [
            {
              "height": 94,
              "url": "https://i.ytimg.com/vi/Sa0ySiBTZqw/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLCw5z6cexMBGj0svKPXkaE5IxK1TA",
              "width": 168
            },
            {
              "height": 188,
              "url": "https://i.ytimg.com/vi/Sa0ySiBTZqw/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDJmiOOcpsmXdyjJ8kVvTpL2TGjNA",
              "width": 336
            }
          ],
          "title": "Top 100 Classic Rock Songs 70s 80s 90s ⚡ Bon Jovi, Queen, Guns N' Roses, Metallica, ACDC, Aerosmith",
          "video_id": "Sa0ySiBTZqw",
          "video_url": "https://www.youtube.com/watch?v=Sa0ySiBTZqw",
          "view_count_text": "23K views"
        },
        {
          "author": "every song is a scar",
          "author_id": "UCkUSPjRL8md2hlE8bNXAT-A",
          "author_url": "https://www.youtube.com/channel/UCkUSPjRL8md2hlE8bNXAT-A",
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "2 months ago",
          "thumbnails": [
            {
              "height": 94,
              "url": "https://i.ytimg.com/vi/NWItxGY5NNk/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLCmChKHt_FKJAnWixfl0i9i_VX4Vw",
              "width": 168
            },
            {
              "height": 188,
              "url": "https://i.ytimg.com/vi/NWItxGY5NNk/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCK0jmSkcfg4_FfPeLcindpSd1THA",
              "width": 336
            }
          ],
          "title": "80'S MUSIC ON THE ROAD | 2 Hours of Classic '80s Hits",
          "video_id": "NWItxGY5NNk",
          "video_url": "https://www.youtube.com/watch?v=NWItxGY5NNk",
          "view_count_text": "2.4M views"
        },
        {
          "author": "80s90s Soft Rock",
          "author_id": "UCrc_UcCNzHg6GF06p8W2ltQ",
          "author_url": "https://www.youtube.com/channel/UCrc_UcCNzHg6GF06p8W2ltQ",
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "1 month ago",
          "thumbnails": [
            {
              "height": 94,
              "url": "https://i.ytimg.com/vi/lQDPe8r2AVA/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLA9BPuzehDM4Uwg0YvdKpSx1sq8Gg",
              "width": 168
            },
            {
              "height": 188,
              "url": "https://i.ytimg.com/vi/lQDPe8r2AVA/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCAoitcIT1IvTjIUz93ZTe990vHNg",
              "width": 336
            }
          ],
          "title": "Soft Rock 70s 80s 90s Greatest Hits 💔 Best Classic Rock Ballads & Love Songs Ever Playlist",
          "video_id": "lQDPe8r2AVA",
          "video_url": "https://www.youtube.com/watch?v=lQDPe8r2AVA",
          "view_count_text": "291K views"
        },
        {
          "author": "every song is a scar",
          "author_id": "UCkUSPjRL8md2hlE8bNXAT-A",
          "author_url": "https://www.youtube.com/channel/UCkUSPjRL8md2hlE8bNXAT-A",
          "length_seconds": null,
          "length_text": null,
          "published_time_text": "3 weeks ago",
          "thumbnails": [

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.0015 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

need_format
boolean · optional
video_id
string · optional
video_url
string · optional

Access

Provider
YouTube
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/youtube/web-v2/related-videos
Authentication
Bearer API key

API README

YouTube Related Videos (Web V2) API

Retrieve related video recommendations by supplying a video_id or full video_url. You can also configure need_format to format the response data.

Use cases

  • Discover content recommendations related to a target video.
  • Build recommendation carousels in external media apps.
  • Analyze video association networks for research.

Request

curl -X POST "https://api.sandbase.ai/v1/api/youtube/web-v2/related-videos" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Parameters

NameTypeRequiredDescription
video_idstringNoVideo ID (recommended)
video_urlstringNoFull video URL (optional, ignored if video_id is provided)
need_formatbooleanNoWhether to format data (default true)

Notes

  • If video_id is provided, video_url is ignored.
  • need_format defaults to true.

Related APIs

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/youtube/web-v2/related-videos
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/youtube/web-v2/related-videos" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "video_id": "dQw4w9WgXcQ",
  "need_format": true
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
YouTube Related Videos (Web V2)This API
YouTube		$0.0015 per callJSONJul 31, 2026
YouTube Channel Community Posts
YouTube		$0.0015 per callJSONJul 31, 2026
YouTube Channel Description
YouTube		$0.0015 per callJSONJul 31, 2026
YouTube Channel ID from URL
YouTube		$0.0015 per callJSONJul 31, 2026
YouTube Channel Shorts
YouTube		$0.0015 per callJSONJul 31, 2026
YouTube Channel URL by ID
YouTube		$0.0015 per callJSONJul 31, 2026

Questions

FAQ

How do I use the YouTube Related Videos (Web V2) API?

Send a POST request to https://api.sandbase.ai/v1/api/youtube/web-v2/related-videos with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the YouTube Related Videos (Web V2) API cost?

$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the YouTube Related Videos (Web V2) API accept?

No parameters are required. Optional: need_format (boolean), video_id (string) and video_url (string). The Parameters table and the Playground on this page list every field.

What does the YouTube Related Videos (Web V2) API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a YouTube developer account or API key?

No. YouTube Related Videos (Web V2) runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for YouTube API access separately.