/autoplay

Given a YouTube video ID, returns the next related tracks to queue up automatically. Every track is under 10 minutes, and the same source video won't hand two different callers the same next song while its related pool still has fresh picks.

GET/autoplay

Parameters are sent in the query string.

Parameter	Type	Required	Description
video_id	string	required	A YouTube video ID, or a full youtube.com/youtu.be URL — the currently playing track.
api_key	string	required	Your API key. See authentication. Autoplay calls do not count against your daily quota.

curl

curl "https://yt-dow.co08.art/autoplay?video_id=dQw4w9WgXcQ&api_key=YOUR_API_KEY"

Response

On success (200), the response is JSON with up to 10 tracks, ordered by relevance:

200 OK

{
  "video_id": "dQw4w9WgXcQ",
  "count": 10,
  "total_autoplay_requests": 4821,
  "tracks": [
    {
      "video_id": "XXXXXXXXXXX",
      "title": "Track title",
      "duration": 214,
      "artist": "Channel name",
      "thumbnail": "https://i.ytimg.com/vi/XXXXXXXXXXX/hqdefault.jpg"
    }
  ]
}

Field	Description
video_id	The resolved source video ID that was queried.
count	Number of tracks in this response, up to 10.
total_autoplay_requests	Running total of autoplay requests made with this key.
tracks[].duration	Length in seconds. Always 600 or less.

Calling /autoplay again for the same video_id won't repeat a track that was already handed out for that source video, as long as fresh related tracks are still available — so two people autoplaying the same song at the same time don't end up hearing the same next song.

Errors

Status	detail	Cause
400	video_id is required	No video_id sent
400	Invalid video URL or ID	video_id couldn't be resolved to a video
401	API key required	No api_key sent
401	Invalid API key	Key doesn't exist
403	API key is inactive or expired	Key has been deactivated
403	API key has expired	Past its expiry date
403	API key is temporarily blocked	Key is under a temporary block
403	Access denied	Account restricted
502	Could not fetch related videos, try again	The source video's related list couldn't be read

Unlike /download, /autoplay has no daily quota and is not IP rate-limited — see errors & rate limits for how that differs from the rest of the API.