User connections

🚀
API v2 now available
Visit the API v2 documentation or follow the migration guide to upgrade.

Some objects can only be accessed and/or created through connections since they have no point in existing on their own.

Here is the list of connections available through the user object.

Filters	Description
`children`	List of this user’s children. This connection joins an object of type user with a list of user objects.
`features`	List of videos featured by this user. This connection joins an object of type user with a list of video objects.
`followers`	List of this user’s followers. This connection joins an object of type user with a list of user objects.
`following`	List of users followed by this user. This connection joins an object of type user with a list of user objects.
`likes`	List of videos liked by the user. This connection joins an object of type user with a list of video objects.
`parents`	List of this user’s parents. This connection joins an object of type user with a list of user objects.
`players`	List of players created by this user This connection joins an object of type user with a list of player objects.
`relations`	List of user accounts related to this user through their parents. This connection joins an object of type user with a list of user objects.
`subscriptions`	List of videos from the channels the user follow. This connection joins an object of type user with a list of video objects.
`videos`	List of videos uploaded by this user. This connection joins an object of type user with a list of video objects.
`watchlater`	List of watch later videos. This connection joins an object of type user with a list of video objects.

children

List of this user’s children.
This connection joins an object of type user with a list of user objects.

Action Description

Read the user's children connection

Action	Description
Read the user's children connection	You can retrieve the list of children connected to a user object by issuing a GET request to `/me/children`. You can specify the list of fields from the user objects to be returned using the fields parameter. You can also see if any user is connected to an existing user object by issuing a GET request to `/me/children/<USER_ID>`. This will return a list containing only the connected user object or an empty list if it is not connected.
Create a user's children connection	You can connect children to an existing user object one by one by issuing multiple POST requests to `/me/children/<USER_ID>`.
Delete a user's children connection	You can disconnect children from a user object by issuing DELETE requests to `/me/children/<USER_ID>`. You can also disconnect all children at once by issuing a POST request to /`me/children` with an empty ids query-string parameter.

You can retrieve the list of children connected to a user object by issuing a GET request to /me/children. You can specify the list of fields from the user objects to be returned using the fields parameter.

You can also see if any user is connected to an existing user object by issuing a GET request to /me/children/<USER_ID>. This will return a list containing only the connected user object or an empty list if it is not connected.

Create a user's children connection You can connect children to an existing user object one by one by issuing multiple POST requests to /me/children/<USER_ID>.

Delete a user's children connection

You can disconnect children from a user object by issuing DELETE requests to /me/children/<USER_ID>.

You can also disconnect all children at once by issuing a POST request to /me/children with an empty ids query-string parameter.

features

List of videos featured by this user.
This connection joins an object of type user with a list of video objects.

Action Description

Read the user's features connection

Action	Description
Read the user's features connection	You can retrieve the list of features connected to a user object by issuing a GET request to `/me/features`. You can specify the list of fields from the video objects to be returned using the fields parameter. You can also see if any video is connected to an existing user object by issuing a GET request to `/me/features/<VIDEO_ID>`. This will return a list containing only the connected video object or an empty list if it is not connected.
Create a user's features connection	You can connect features to an existing user object one by one by issuing multiple POST requests to `/me/features/<VIDEO_ID>`.
Delete a user's features connection	You can disconnect features from a user object by issuing DELETE requests to `/me/features/<VIDEO_ID>`. You can also disconnect all features at once by issuing a POST request to `/me/features` with an empty ids query-string parameter.Read the user's children connection

You can retrieve the list of features connected to a user object by issuing a GET request to /me/features. You can specify the list of fields from the video objects to be returned using the fields parameter.

You can also see if any video is connected to an existing user object by issuing a GET request to /me/features/<VIDEO_ID>.

This will return a list containing only the connected video object or an empty list if it is not connected.

Create a user's features connection You can connect features to an existing user object one by one by issuing multiple POST requests to /me/features/<VIDEO_ID>.

Delete a user's features connection

You can disconnect features from a user object by issuing DELETE requests to /me/features/<VIDEO_ID>.

You can also disconnect all features at once by issuing a POST request to /me/features with an empty ids query-string parameter.Read the user's children connection

followers

List of this user’s followers.
This connection joins an object of type user with a list of user objects.

Action Description

Read the user's followers connection

Action	Description
Read the user's followers connection	You can retrieve the list of followers connected to a user object by issuing a GET request to `/me/followers`. You can specify the list of fields from the user objects to be returned using the fields parameter.

You can retrieve the list of followers connected to a user object by issuing a GET request to /me/followers.

You can specify the list of fields from the user objects to be returned using the fields parameter.

following

List of users followed by this user.
This connection joins an object of type user with a list of user objects.

Action Description

Read the user's following connection

Action	Description
Read the user's following connection	You can retrieve the list of following connected to a user object by issuing a GET request to `/me/following`. You can specify the list of fields from the user objects to be returned using the fields parameter. You can also see if any user is connected to an existing user object by issuing a GET request to `/me/following/<USER_ID>`. This will return a list containing only the connected user object or an empty list if it is not connected.
Create a user's following connection	You can connect following to an existing user object one by one by issuing multiple POST requests to `/me/following/<USER_ID>`.
Delete a user's following connection	You can disconnect following from a user object by issuing DELETE requests to `/me/following/<USER_ID>`. You can also disconnect all following at once by issuing a POST request to /me/following with an empty ids query-string parameter.

You can retrieve the list of following connected to a user object by issuing a GET request to /me/following. You can specify the list of fields from the user objects to be returned using the fields parameter.

You can also see if any user is connected to an existing user object by issuing a GET request to /me/following/<USER_ID>. This will return a list containing only the connected user object or an empty list if it is not connected.

Create a user's following connection You can connect following to an existing user object one by one by issuing multiple POST requests to /me/following/<USER_ID>.

Delete a user's following connection You can disconnect following from a user object by issuing DELETE requests to /me/following/<USER_ID>. You can also disconnect all following at once by issuing a POST request to /me/following with an empty ids query-string parameter.

likes

List of videos liked by the user.
This connection joins an object of type user with a list of video objects.

Action Description

Read the user's likes connection

Action	Description
Read the user's likes connection	You can retrieve the list of likes connected to a user object by issuing a GET request to `/me/likes`. You can specify the list of fields from the video objects to be returned using the fields parameter. You can also see if any video is connected to an existing user object by issuing a GET request to `/me/likes/<VIDEO_ID>`. This will return a list containing only the connected video object or an empty list if it is not connected.
Create a user's likes connection	You can connect likes to an existing user object one by one by issuing multiple POST requests to `/me/likes/<VIDEO_ID>`.
Delete a user's likes connection	You can disconnect likes from a user object by issuing DELETE requests to `/me/likes/<VIDEO_ID>`. You can also disconnect all likes at once by issuing a POST request to `/me/likes` with an empty ids query-string parameter.

You can retrieve the list of likes connected to a user object by issuing a GET request to /me/likes. You can specify the list of fields from the video objects to be returned using the fields parameter.

You can also see if any video is connected to an existing user object by issuing a GET request to /me/likes/<VIDEO_ID>. This will return a list containing only the connected video object or an empty list if it is not connected.

Create a user's likes connection You can connect likes to an existing user object one by one by issuing multiple POST requests to /me/likes/<VIDEO_ID>.

Delete a user's likes connection

You can disconnect likes from a user object by issuing DELETE requests to /me/likes/<VIDEO_ID>.

You can also disconnect all likes at once by issuing a POST request to /me/likes with an empty ids query-string parameter.

parents

List of this user’s parents.
This connection joins an object of type user with a list of user objects.

Action Description

Read the user's children connection

Action	Description
Read the user's children connection	You can retrieve the list of children connected to a user object by issuing a GET request to `/me/children`. You can specify the list of fields from the user objects to be returned using the fields parameter. You can also see if any user is connected to an existing user object by issuing a GET request to `/me/children/<USER_ID>`. This will return a list containing only the connected user object or an empty list if it is not connected.
Create a user's children connection	You can connect children to an existing user object one by one by issuing multiple POST requests to `/me/children/<USER_ID>`.
Delete a user's children connection	You can disconnect children from a user object by issuing DELETE requests to `/me/children/<USER_ID>`. You can also disconnect all children at once by issuing a POST request to /`me/children` with an empty ids query-string parameter.

Create a user's children connection You can connect children to an existing user object one by one by issuing multiple POST requests to /me/children/<USER_ID>.

Delete a user's children connection

You can disconnect children from a user object by issuing DELETE requests to /me/children/<USER_ID>.

You can also disconnect all children at once by issuing a POST request to /me/children with an empty ids query-string parameter.

players

List of players created by this user
This connection joins an object of type user with a list of player objects.

Action Description

Read the user's players connection You can retrieve the list of players connected to a user object by issuing a GET request to /me/players. You can specify the list of fields from the player objects to be returned using the fields parameter.

Create a user's players connection

Action	Description
Read the user's players connection	You can retrieve the list of players connected to a user object by issuing a GET request to `/me/players`. You can specify the list of fields from the player objects to be returned using the fields parameter.
Create a user's players connection	You can create a new player object and automatically connect it to an existing user object by issuing a POST request to `/me/players`. In return, you will receive a dict value containing the newly created object, including its identifier.
Delete a user's players connection	You can delete a player object connected to a user object the same way you would if it wasn't attached, that is by issuing a DELETE request to `/player/<PLAYER_ID>`.

You can create a new player object and automatically connect it to an existing user object by issuing a POST request to /me/players.

In return, you will receive a dict value containing the newly created object, including its identifier.

Delete a user's players connection You can delete a player object connected to a user object the same way you would if it wasn't attached, that is by issuing a DELETE request to /player/<PLAYER_ID>.

relations

List of user accounts related to this user through their parents.
This connection joins an object of type user with a list of user objects.

Action	Description
Read the user's relations connection	You can retrieve the list of relations connected to a user object by issuing a GET request to `/me/relations`. You can specify the list of fields from the user objects to be returned using the fields parameter.

subscriptions

List of videos from the channels the user follow.
This connection joins an object of type user with a list of video objects.

Action	Description
Read the user's subscriptions connection	You can retrieve the list of subscriptions connected to a user object by issuing a GET request to `/me/subscriptions`. You can specify the list of fields from the video objects to be returned using the fields parameter.

videos

List of videos uploaded by this user.
This connection joins an object of type user with a list of video objects.

Action Description

Read the user's videos connection You can retrieve the list of videos connected to a user object by issuing a GET request to /me/videos. You can specify the list of fields from the video objects to be returned using the fields parameter.

Create a user's videos connection

Action	Description
Read the user's videos connection	You can retrieve the list of videos connected to a user object by issuing a GET request to `/me/videos`. You can specify the list of fields from the video objects to be returned using the fields parameter.
Create a user's videos connection	You can create a new video object and automatically connect it to an existing user object by issuing a POST request to `/me/videos` with the following parameters. Type: STRING Parameter: `content_provider` Description: Content provider name.
Delete a user's videos connection	You can delete a video object connected to a user object the same way you would if it wasn't attached, that is by issuing a DELETE request to `/video/<VIDEO_ID>`.

You can create a new video object and automatically connect it to an existing user object by issuing a POST request to /me/videos with the following parameters.

Type: STRING
Parameter: content_provider
Description: Content provider name.

Delete a user's videos connection You can delete a video object connected to a user object the same way you would if it wasn't attached, that is by issuing a DELETE request to /video/<VIDEO_ID>.

watchlater

List of watch later videos.
This connection joins an object of type user with a list of video objects.

Action Description

Read the user's watchlater connection

Action	Description
Read the user's watchlater connection	You can retrieve the list of watchlater connected to a user object by issuing a GET request to `/me/watchlater`. You can specify the list of fields from the video objects to be returned using the fields parameter. You can also see if any video is connected to an existing user object by issuing a GET request to `/me/watchlater/<VIDEO_ID>`. This will return a list containing only the connected video object or an empty list if it is not connected.
Create a user's watchlater connection	You can connect watchlater to an existing user object one by one by issuing multiple POST requests to `/me/watchlater/<VIDEO_ID>`.
Delete a user's watchlater connection	You can disconnect watchlater from a user object by issuing DELETE requests to `/me/watchlater/<VIDEO_ID>`. You can also disconnect all watchlater at once by issuing a POST request to `/me/watchlater` with an empty ids query-string parameter.

You can retrieve the list of watchlater connected to a user object by issuing a GET request to /me/watchlater. You can specify the list of fields from the video objects to be returned using the fields parameter.

You can also see if any video is connected to an existing user object by issuing a GET request to /me/watchlater/<VIDEO_ID>. This will return a list containing only the connected video object or an empty list if it is not connected.

Create a user's watchlater connection You can connect watchlater to an existing user object one by one by issuing multiple POST requests to /me/watchlater/<VIDEO_ID>.

Delete a user's watchlater connection You can disconnect watchlater from a user object by issuing DELETE requests to /me/watchlater/<VIDEO_ID>. You can also disconnect all watchlater at once by issuing a POST request to /me/watchlater with an empty ids query-string parameter.