youtube.videos.list_by_tag (API Function Reference)

Description

Lists all videos that have the specified tag.

Parameters

method: youtube.videos.list_by_tag (only needed as an explicit parameter for REST calls)
dev_id: Developer ID. Please request one if you don't already have one.
tag: the tag to search for
(optional) page: the "page" of results you want to retrieve (e.g. 1, 2, 3)
(optional) per_page: the number of results you want to retrieve per page (default 20, maximum 100)

Example Response

<video_list>

    <video>

        <author>youtuberocks</author>

        <id>k0gEeue2sLk</id>   <!-- this ID can be used with youtube.videos.get_details -->

        <title>My First Motion Picture</title>

        <length_seconds>16</length_seconds>  <!-- length of video -->

        <rating_avg>3.75</rating_avg>

        <rating_count>10</rating_count>

        <description>This is the video description shown on the YouTube site.</description>

        <view_count>170</view_count>

        <upload_time>1121398533</upload_time>  <!-- UNIX-style time, secs since 1/1/1970 -->

        <comment_count>1</comment_count>  <!-- how many comments does this video have? -->

        <tags>feature film documentary</tags> 

        <url>http://www.youtube.com/watch?v=k04Eeue24Lk</url>

        <thumbnail_url>http://static.youtube.com/get_still?video_id=k04Eeue24Lk</thumbnail_url>

    </video>

    <video>

        ... another video ...

    </video>

</video_list>

Error Codes

Standard error codes