Skip to main content
POST
YouTube Playlist Videos API

YouTube Playlist Videos

Collect normalized video records from one or more public playlists.

Use with MCP

Playlist IDs may be passed directly in urls. Results include playlist context under extra. results_limit defaults to 100, accepts values from 10 through 2,000, and applies to each playlist.

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.

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
urls
string[]
required

Public profile or content URLs.

Minimum array length: 1
Minimum string length: 1
results_limit
integer
Required range: 10 <= x <= 2000

Response

Task accepted

code
integer
data
object