video.getVideos

Returns a list of videos according to the specified criteria.

Parameters:

api_key (required) A RockPeaks API key.
recording_mbid (optional) The MusicBrainz id of the track's canonical recording.
artist (optional) The name of the artist.
artist_id (optional) The RockPeaks id of the artist.
artist_mbid (optional) The MusicBrainz id of the artist.
show (optional) The name of the show.
show_id (optional) The RockPeaks id of the show.
date_min (optional) Video date from, in the YYYY-MM-DD format.
date_max (optional) Video date to, in the YYYY-MM-DD format.
productions (optional) Production types to include, comma separated.
types (optional) Video types to include, comma separated.
genres (optional) Video genres to include, comma separated.
sources (optional) Video sources to include, comma separated, e.g. "youtube,dailymotion".
status (optional) Only list live (1) or missing (0) videos.
sort (optional) Sort order: "date", "added", "rp_ranking" or "title". Defaults to "date".
order (optional) Sort order, "asc" or "desc". Defaults to "asc".
page (optional) The page number to fetch. Defaults to 0 (first page).
limit (optional) The number of results to fetch per page. Defaults to 50.

Sample Request:

http://www.rockpeaks.com/services/api?method=video.getVideos&api_key=<key>&artist=Grateful%20Dead&date_min=1976-06-01&date_max=1977-06-01&status=1

Sample Response:

<videos>
  <count>3</count>
  <video>
    <id>5778</id>
    <title>Dancing In The Street</title>
    <artist>Grateful Dead</artist>
    <artist_id>188</artist_id>
    <show>Orpheum Theatre, San Francisco</show>
    <show_id>5779</show_id>
    <added>2009-03-04 14:18:22</added>
    <date>
      <year>1976</year>
      <month>7</month>
      <day>12</day>
    </date>
    <date_string>1976 07-12</date_string>
    <display_date>July 12, 1976</display_date>
    <image_small>http://www.rockpeaks.com/files/imagecache/clip_search_result/eggs/g/Grateful-Dead/005778-Grateful-Dead-Dancing-In-The-Street-Orpheum-Theatre-San-Francisco-1976.jpg</image_small>
    <image>http://www.rockpeaks.com/files/eggs/g/Grateful-Dead/005778-Grateful-Dead-Dancing-In-The-Street-Orpheum-Theatre-San-Francisco-1976.jpg</image>
    <duration>716</duration>
    <rp_ranking>52</rp_ranking>
    <views>10308</views>
    <comments>16</comments>    
    <url>http://www.rockpeaks.com/video/g/Grateful-Dead/Orpheum-Theatre-San-Francisco-1976/Dancing-In-The-Street</url>
    <source>
      <name>youtube</name>
      <url>http://www.youtube.com/watch?v=qh5YZAxQLK0</url>
      <id>qh5YZAxQLK0</id>
      <status>1</status>
    </source>
  </video>
  ...
</videos>

 

Enter your Rock Peaks username.
Enter the password that accompanies your username.
Forgot Password?
 

Not a Member Yet?

Join

It's Free!