Difference between revisions of "YTMND:API:Interfaces"

Revision as of 22:44, November 1, 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

 
 <comments comment_count="56" first_comment="2007-08-15T01:51:40-05:00" last_comment="2007-10-24T19:24:17-05:00"/>

Favorites

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

 
 <favorites total_favorites="5">
  <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>
   <favorite date="2007-08-17T21:14:46-05:00">
    <user user_id="257714" user_name="montereymatt"/>
   </favorite>
 </favorites>

Favorites Summary

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

 
 <favorites total_favorites="5"/>

Modifications

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

 
 <modifications>
  <modification change_date="2007-09-22 00:07:01" type="title">
   <title>
    NON-Featured User of the Day * 09/21/07 (changes daily)
   </title>
   <title>NON-Featured User of the Day * 09/22/07 (changes daily)</title>
  </modification>
  <modification change_date="2007-09-28 22:27:45" type="image">
   <asset type="image" asset_id="2469744" kilobytes="1144" url="http://content.ytmnd.com/content/3/e/8/3e83cdfa524342a72d2cd610bb11768a.gif"/>
   <asset type="image" asset_id="2470447" kilobytes="1059" url="http://content.ytmnd.com/content/9/5/b/95b95a1ac1829ac5633773bbca48ca3a.gif"/>
  </modification>
 </modifications>

Sponsors Summary

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

 
 <sponsors total_sponsorship="127.67" total_fees="7.56"/>

Score

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

 
 <score computed_score="3.7635" total_votes="203" vote_sum="764" score_image="stars_red_38.gif"/>

Votes by Day

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

 
 <score computed_score="3.7635" total_votes="203" vote_sum="764" score_image="stars_red_38.gif">
  <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-08-16" one_votes="0" two_votes="0" three_votes="2" four_votes="1" five_votes="2" current_score="3.738"/>
  <votes vote_date="2007-08-19" one_votes="0" two_votes="0" three_votes="0" four_votes="0" five_votes="3" current_score="3.773"/>
  <votes vote_date="2007-09-24" one_votes="0" two_votes="0" three_votes="0" four_votes="0" five_votes="2" current_score="3.779"/>
  <votes vote_date="2007-10-09" one_votes="0" two_votes="0" three_votes="0" four_votes="0" five_votes="1" current_score="3.789"/>
 </score>

Views Summary

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

 
 <site_views today="3" yesterday="11" week="40" month="161" all_time="2999"/>

Views by Day

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

 
 <site_views today="3" yesterday="11" week="40" month="161" all_time="2999">
  <views date="2007-08-14" view_count="2356"/>
  <views date="2007-08-15" view_count="70"/>
  <views date="2007-08-16" view_count="35"/>
  <views date="2007-08-17" view_count="48"/>
  <views date="2007-08-18" view_count="51"/>
  <views date="2007-08-19" view_count="23"/>
  <views date="2007-08-22" view_count="20"/>
  <views date="2007-10-30" view_count="11"/>
 </site_views>

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.

@@ Line 157: / Line 157: @@
      NON-Featured User of the Day * 09/21/07 (changes daily)
     </title>
-    <title>
+    <title>NON-Featured User of the Day * 09/22/07 (changes daily)</title>
-    NON-Featured User of the Day * 09/22/07 (changes daily)
-   </title>
    </modification>
    <modification change_date="2007-09-28 22:27:45" type="image">
@@ Line 168: / Line 166: @@
   </Highlight>
 ===Sponsors===
-  http://api.ytmnd.com/sites/tomarnoldjungle/sponsors
+  http://api.ytmnd.com/sites/featureflash/sponsors
   <Highlight lang="XML">
+ <sponsors total_sponsorship="127.67" total_fees="7.56">
+  <user user_id="119412" user_name="RedFrog">
+   <sponsorship amount="11.68" processing_fee="0.66" sponsor_date="2007-09-24T00:14:26-05:00"/>
+  </user>
+  <user user_id="119412" user_name="RedFrog">
+   <sponsorship amount="11" processing_fee="0.64" sponsor_date="2007-09-30T01:36:07-05:00"/>
+  </user>
+  <user user_id="230159" user_name="Click">
+   <sponsorship amount="14.26" processing_fee="0.74" sponsor_date="2007-10-15T17:34:36-05:00"/>
+  </user>
+ </sponsors>
   </Highlight>
 ===Sponsors Summary===
-  http://api.ytmnd.com/sites/tomarnoldjungle/sponsors_summary
+  http://api.ytmnd.com/sites/featureflash/sponsors_summary
   <Highlight lang="XML">
+ <sponsors total_sponsorship="127.67" total_fees="7.56"/>
   </Highlight>
 ===Score===
@@ Line 181: / Line 191: @@
   <Highlight lang="XML">
+ <score computed_score="3.7635" total_votes="203" vote_sum="764" score_image="stars_red_38.gif"/>
   </Highlight>
 ===Votes by Day===
@@ Line 186: / Line 197: @@
   <Highlight lang="XML">
+ <score computed_score="3.7635" total_votes="203" vote_sum="764" score_image="stars_red_38.gif">
+  <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-08-16" one_votes="0" two_votes="0" three_votes="2" four_votes="1" five_votes="2" current_score="3.738"/>
+  <votes vote_date="2007-08-19" one_votes="0" two_votes="0" three_votes="0" four_votes="0" five_votes="3" current_score="3.773"/>
+  <votes vote_date="2007-09-24" one_votes="0" two_votes="0" three_votes="0" four_votes="0" five_votes="2" current_score="3.779"/>
+  <votes vote_date="2007-10-09" one_votes="0" two_votes="0" three_votes="0" four_votes="0" five_votes="1" current_score="3.789"/>
+ </score>
   </Highlight>
 ===Views Summary===
@@ Line 191: / Line 209: @@
   <Highlight lang="XML">
+ <site_views today="3" yesterday="11" week="40" month="161" all_time="2999"/>
   </Highlight>
 ===Views by Day===
@@ Line 196: / Line 215: @@
   <Highlight lang="XML">
+ <site_views today="3" yesterday="11" week="40" month="161" all_time="2999">
+  <views date="2007-08-14" view_count="2356"/>
+  <views date="2007-08-15" view_count="70"/>
+  <views date="2007-08-16" view_count="35"/>
+  <views date="2007-08-17" view_count="48"/>
+  <views date="2007-08-18" view_count="51"/>
+  <views date="2007-08-19" view_count="23"/>
+  <views date="2007-08-22" view_count="20"/>
+  <views date="2007-10-30" view_count="11"/>
+ </site_views>
   </Highlight>

Difference between revisions of "YTMND:API:Interfaces"

Revision as of 22:44, November 1, 2007

Contents

Sites

Basic

Extended

Full

Base

Assets

Assets Thumb

Citations

Comments

Comments Summary

Favorites

Favorites Summary

Modifications

Sponsors

Sponsors Summary

Score

Votes by Day

Views Summary

Views by Day

Users

Example request

Example responses

XML

JSON

PHP

Endpoints

Related

Navigation menu

Views

Personal tools

Navigation

Search

Tools