Difference between revisions of "YTMND:API:Interfaces"

Revision as of 17:19, October 31, 2007

Sites

Basic

http://api.ytmnd.com/sites/tomarnoldjungle/basic

 
 <?xml version="1.0" encoding="UTF-8"?>
 <ytmnd_response timestamp="2007-10-14T00:57:48-05:00" request_type="site" extended_request="basic" returned_results="1">
  <sites>
   <site site_id="801024" domain="tomarnoldjungle" created="2007-08-15T01:47:04-05:00" modified="2007-08-15T14:28:41-05:00" classic_ytmnd="false">
    <user user_id="111682" user_name="BTape"/>
    <title>Tom Arnold Lost His Way In The Peruvian Jungle</title>
    <description>Tom Arnold got off the tour to get coffee... at the only place without a Starbucks.</description>
    <keywords>tom arnold, jungle</keywords>
    <site_text line_1="" line_2="" line_3="" image_text="false"/>
    <display_options background_color="1E3910" image_placement="center" synchronize="true" delay="0"/>
    <image_origin>http://tom-arnold.ytmnd.com/ + various</image_origin>
    <sound_origin>RJD2 - Ring Finger, various</sound_origin>
    <moderated work_safe="true"/>
    <assets>
     <asset type="thumb" asset_id="2427953" kilobytes="6" url="http://content.ytmnd.com/content/7/8/1/78155565973df3f223361eea4c5ba808.jpg"/>
    </assets>
    <score computed_score="3.7574" total_votes="202" vote_sum="759" score_image="stars_red_38.gif"/>
    <site_views today="0" yesterday="7" week="62" month="177" all_time="2922"/>
   </site>
  </sites>
 </ytmnd_response>

Extended

http://api.ytmnd.com/sites/tomarnoldjungle/extended

Basic plus:

<assets>
 <asset type="sound" asset_id="2427590" kilobytes="315" url="http://content.ytmnd.com/content/a/b/5/ab570c256450ed6faf635428bfe5bd96.mp3"/>
 <asset type="image" asset_id="2427951" kilobytes="2657" url="http://content.ytmnd.com/content/0/f/f/0ff70e7d1dae8becec3b6b1975983d96.gif"/>
</assets>
<favorites total_favorites="5"/>
<comments comment_count="55" first_comment="2007-08-15T01:51:40-05:00" last_comment="2007-10-06T22:51:24-05:00"/>

Full

http://api.ytmnd.com/sites/tomarnoldjungle/full

Extended plus:

<votes vote_date="2007-08-15" one_votes="19" two_votes="12" three_votes="27" four_votes="41" five_votes="64" current_score="3.73"/>
<votes vote_date="2007-10-24" one_votes="0" two_votes="0" three_votes="0" four_votes="0" five_votes="1" current_score="3.764"/>
<favorite date="2007-08-15T09:59:26-05:00">
 <user user_id="266689" user_name="greytrooper"/>
</favorite>
<favorite date="2007-08-15T15:11:55-05:00">
 <user user_id="259565" user_name="prowlerdante"/>
</favorite>

Base

http://api.ytmnd.com/sites/tomarnoldjungle/base

<ytmnd_response timestamp="2007-10-26T23:11:03-05:00" request_type="site" extended_request="base" returned_results="1">
 <sites>
  <site site_id="801024" domain="tomarnoldjungle" created="2007-08-15T01:47:04-05:00" modified="2007-08-15T14:28:41-05:00" classic_ytmnd="false">
   <user user_id="111682" user_name="BTape"/>
   <title>Tom Arnold Lost His Way In The Peruvian Jungle</title>
   <description>
    Tom Arnold got off the tour to get coffee... at the only place without a Starbucks.
   </description>
   <keywords>tom arnold, jungle</keywords>
   <site_text line_1="" line_2="" line_3="" image_text="false"/>
   <display_options background_color="1E3910" image_placement="center" synchronize="true" delay="0"/>
   <image_origin>http://tom-arnold.ytmnd.com/ + various</image_origin>
   <sound_origin>RJD2 - Ring Finger, various</sound_origin>
   <moderated work_safe="true"/>
  </site>
 </sites>
</ytmnd_response>

Assets

http://api.ytmnd.com/sites/tomarnoldjungle/assets

<assets>
 <asset type="sound" asset_id="2427590" kilobytes="315" url="http://content.ytmnd.com/content/a/b/5/ab570c256450ed6faf635428bfe5bd96.mp3"/>
 <asset type="image" asset_id="2427951" kilobytes="2657" url="http://content.ytmnd.com/content/0/f/f/0ff70e7d1dae8becec3b6b1975983d96.gif"/>
 <asset type="thumb" asset_id="2427953" kilobytes="6" url="http://content.ytmnd.com/content/7/8/1/78155565973df3f223361eea4c5ba808.jpg"/>
</assets>

Assets Thumb

http://api.ytmnd.com/sites/tomarnoldjungle/assets_thumb

<assets>
 <asset type="thumb" asset_id="2427953" kilobytes="6" url="http://content.ytmnd.com/content/7/8/1/78155565973df3f223361eea4c5ba808.jpg"/>
</assets>

Citations

http://api.ytmnd.com/sites/tomarnoldjungle/citations

<citations>
 <site site_id="735637" domain="tom-arnold"/>
 <user user_id="69949" user_name="money-hat"/>
</citations>

Comments

http://api.ytmnd.com/sites/tomarnoldjungle/comments

<comments comment_count="56" first_comment="2007-08-15T01:51:40-05:00" last_comment="2007-10-24T19:24:17-05:00">
 <comment comment_id="4882579" date="2007-08-15 02:02:53" url="/sites/profile/801024#2007-08-15_02_02_53">
  <user user_id="167760" user_name="kittyblender"/>
  <vote>5</vote>
  <text>incredible.. </text>
  <comment_score votes_up="4" votes_down="0"/>
 </comment>
 <comment comment_id="4882802" date="2007-08-15 07:20:05" url="/sites/profile/801024#2007-08-15_07_20_05">
  <user user_id="69949" user_name="money-hat"/>
  <vote>4</vote>
  <text>Yay! Thanks for reviving this! </text>
  <comment_score votes_up="3" votes_down="0"/>
 </comment>
</comments>

Comments Summary

http://api.ytmnd.com/sites/tomarnoldjungle/comments_summary

Favorites

http://api.ytmnd.com/sites/tomarnoldjungle/favorites

Favorites Summary

http://api.ytmnd.com/sites/tomarnoldjungle/favorites_summary

Modifications

http://api.ytmnd.com/sites/tomarnoldjungle/modifications

Sponsors

http://api.ytmnd.com/sites/tomarnoldjungle/sponsors

Sponsors Summary

http://api.ytmnd.com/sites/tomarnoldjungle/sponsors_summary

Score

http://api.ytmnd.com/sites/tomarnoldjungle/score

Votes by Day

http://api.ytmnd.com/sites/tomarnoldjungle/votes_by_day

Views Summary

http://api.ytmnd.com/sites/tomarnoldjungle/views_summary

Views by Day

http://api.ytmnd.com/sites/tomarnoldjungle/views_by_day

Users

Example request

http://api.ytmnd.com/user/max

Example responses

XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<ytmnd_response timestamp="1192340109" request_type="user_lookup" extended_request="basic" returned_results="1">
  <users>
    <user user_id="1" signup_date="1081312566" user_name="max" />
  </users>
</ytmnd_response>

JSON

{
 "timestamp":1192340298,
 "request_type":"user_lookup",
 "extended_request":"basic",
 "returned_results":1,
 "users":
 {
  "1":
  {
   "signup_date":"1081312566",
   "user_name":"max",
   "user_id":"1"
  }
 }
}

PHP

a:5:
{
 s:9:"timestamp";
 i:1192340492;
 s:12:"request_type";
 s:11:"user_lookup";
 s:16:"extended_request";
 s:5:"basic";
 s:16:"returned_results";
 i:1;
 s:5:"users";
 a:1:
 {
  i:1;
  a:3:
  {
   s:11:"signup_date";
   s:10:"1081312566";
   s:9:"user_name";
   s:3:"max";
   s:7:"user_id";
   s:1:"1";
  }
 }
}

Endpoints

GET /user/{user name}

• Named user.

GET /user/{user name}/all_sites

• All of named user's sites.

GET /user/{user name}/recent_sites

• Named user's 5 most recent sites.

GET /user/{user name}/recent_comments

• Named user's 5 most recent comments.

For more methods, see here.

Related

• YTMND API
• Response Formats