YTMND:API:Methods

From YTMND
Jump to: navigation, search

YTMND API Method List

Inheritance

Some methods inherit data from other methods. For instance, by calling "sponsors" on the site interface, you are implicitly going to get "sponsors_summary" as well. This is true for any methods that have both a _summary and a _by_day extended method.

Omissions

The API omits data when it doesn't have it or it isn't solid. For instance, some sites can have a moderation element with a work_safe attribute. If we are positive of a work_safe value, we will include the moderation element, otherwise we omit it. This means your application must actually verify if the result has the data you are looking for.

Sites Interface

Methods

Method Limit per Request Description
base 100 sites Creator, title, description, keywords, site text, display options, image origin, sound origin, awards, moderation
assets 100 sites Asset information for a site
assets_thumb 100 sites Site's thumbnail image information
citations 100 sites Citations for a site
comments 1 site Comments on a site
comments_summary 25 sites Information about site's comments
favorites 25 sites Favorites on a site
favorites_summary 25 sites Number of favorites on a site
modifications 50 sites Changes to a site's title, assets, and text
sponsors 50 sites Sponsorships on a site
modifications 50 sites Modifications to a site
sponsors_summary 50 sites Total dollar amount for sponsorships and paypal fees on a site
score 50 sites score, total votes, sum of votes, and score image
votes_by_day 10 sites Votes on a site in a given day
views_summary 10 sites Views on a site in a given day
views_by_day 10 sites Views today, yesterday, this week, this month, and all time on a site

Method Groups

Method Limit per Request Methods implemented
basic 100 sites base, assets_thumb, score, views_summary
extended 50 sites base, assets, comments_summary, favorites_summary, sponsors_summary, score, views_summary
full 5 sites base, assets, citations, comments_summary, favorites, sponsors, votes_by_day, views_by_day


Users Interface

Methods

Method Limit per Request Description
basic 5 users user_id, user_name, signup_date
popular_sites 100 users User's top 5 rated sites
recent_sites 100 users User's last 5 sites
all_sites 100 users All of a user's sites
recent_comments 100 users User's last 5 comments
comments 1 user User's last 25 comments
vote_spread 25 users User's vote totals and average vote
votes 25 users User's last 30 votes
recent_favorites 25 users User's last 5 favorites
favorites 25 users All of a user's favorites

Method Groups

Method Limit per Request Methods implemented
profile 50 sites popular_sites, recent_sites, recent_comments
full 5 sites all_sites, favorites, votes, comments