YouTube API v2.0 – Complaints

Note: The YouTube Data API (v2) has been officially deprecated as of March 4, 2014. Please refer to our deprecation policy for more information. Please use the YouTube Data API (v3) for new integrations and migrate applications still using the v2 API to the v3 API as well.

A user can add a complaint about a video to flag the video for containing inappropriate content. Complaints can be inserted but cannot be updated or deleted. Typically, a user would file a complaint about a video after watching that video.

In an API response, each entry includes a <link> tag that identifies the URL to which you would post an API request to add a complaint about the video. Since each entry includes several link tags, you must use the URL for the tag for which the rel attribute value is

To add a complaint, you send a POST request that identifies the target of the complaint, the user who is making the complaint, and the text of the complaint itself. (The user is identified by the authentication token in the request headers.) The request can also specify the reason for the complaint by using a <category> tag that has a scheme attribute value of The tag's term attribute value must be one of the following terms:

  • CHILDABUSE - The video contains acts of child abuse.
  • DANGEROUS - The video contains harmful or dangerous acts.
  • HATE - The video contains hateful or abusive content.
  • PORN - The video contains sexual content.
  • RIGHTS - The video infringes on the complainant's rights or copyright.
  • SPAM
  • VIOLENCE - The video contains violent or repulsive content.

The following XML demonstrates how to add a complaint about a video.

POST /feeds/api/videos/VIDEO_ID/complaints HTTP/1.1
Content-Type: application/atom+xml
Content-Length: CONTENT_LENGTH
Authorization: Bearer ACCESS_TOKEN
GData-Version: 2

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns=""
    Please ignore this complaint. I'm testing a YouTube API and 
    needed to issue a complaint to test the add complaint function.
    Per the value of the category tag, pretend I am complaining
    about a video that contains violent or repulsive acts.
  <category scheme=""

If YouTube successfully handles your request, the API will return a 201 HTTP response code.

pagination links

« Previous
Next »
Favorite Videos