Skip to main content
POST
YouTube Related Videos API

YouTube Related Videos

Get the list YouTube places beside a video as what to watch next: titles, channels, view counts and thumbnails. Run it on your own uploads or a competitor’s to see which videos and channels YouTube treats as their neighbours — the company a video keeps in recommendations.
url is required: a watch, youtu.be, Shorts or live link. One run returns the whole recommendation list, usually about 20 videos, billed per video.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

url is required. Returns the videos YouTube recommends next to that video, usually about 20.

url
string
required

YouTube video or Shorts URL, such as https://www.youtube.com/watch?v=dQw4w9WgXcQ

Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object