YouTube Video Trainability

The youtube_video_trainability source is designed to retrieve information about whether a particular YouTube video is eligible for AI training purposes. This service enables verification of training permissions for YouTube content.

Request samples

The following examples demonstrate how to check AI training permissions for a specific YouTube video.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
"source": "youtube_video_trainability",
"video_id": "rFNDylrjn_w"
}'

We use synchronous Realtime integration method in our examples. If you would like to use Push-Pull integration, refer to the Integration Methods section.

Request parameter values

Parameter
Description
Default value

source

Sets the scraper.

youtube_video_trainability

video_id

YouTube video ID.

-

callback_url

URL to your callback endpoint. More info.

-

- mandatory parameter

Response format

The API returns a structured JSON response with the following fields:

{
  "videoId": "<YOUTUBE_VIDEO_ID>",
  "kind": "youtube#videoTrainability",
  "etag": "<ETAG_VALUE>",
  "permitted": ["<PERMISSION_LEVEL>"]
}

The permitted field indicates the level of training permission available for the video, with these possible values:

Value
Description

["all"]

Training permitted for all parties

["none"]

No training permitted for any party

["party1", "party2", ...]

Training permitted only for specific listed parties

The etag value serves as a version identifier for the training status.

Example response

{
  "videoId": "rFNDylrjn_w",
  "kind": "youtube#videoTrainability",
  "etag": "oXToFpOwrHWvoiN1YbOa0tkzOn0",
  "permitted": ["None"]
}

Last updated

Was this helpful?