Get available media

Retrieves available videos from YouTube based on query, playlist ID, or video ID. At least one of query, playlistId, or videoId must be provided.

GET /media/available

Get available media

cURL

curl --request GET \
  --url https://api.example.com/media/available

200

{
  "id": "<string>",
  "snippet": {
    "resourceId": {
      "kind": "<string>",
      "videoId": "<string>"
    },
    "title": "<string>",
    "thumbnails": {}
  },
  "contentDetails": {
    "duration": "<string>",
    "regionRestriction": {
      "blocked": [
        "<string>"
      ]
    },
    "contentRating": {}
  },
  "statistics": {
    "viewCount": "<string>"
  }
}

Query Parameters

query · string | null

Search query for YouTube videos

playlistId · string | null

YouTube playlist ID to retrieve videos from

videoId · string | null

Specific YouTube video ID

Response

200

application/json

List of available videos

YouTube video data

id · string | null

Video ID

snippet · object

Video snippet with title, description, thumbnails

Show child attributes

contentDetails · object

Content details like duration

Show child attributes

statistics · object

Video statistics (views, likes, etc.)

Show child attributes