YTMND:API:Methods

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