YTMND:API:Basic Overview

Revision as of 22:43, June 20, 2007 by Max (Talk | contribs)

Jump to: navigation, search

YTMND Developer API: Basic Overview

This documentation is partially plagiarized from the Digg API documentation, as the YTMND API was modeled after it.


  • See ResponseFormats for details on specifying the desired format you would like returned
  • All requests should include a User-Agent HTTP Header (see below).
  • Requests made from Javascript running on your web pages should be proxied to avoid same-origin policy conflicts.


  • All responses are UTF-8 encoded, the default response format is XML.
  • Times are expressed in Unix epoch timestamp format.
  • All Times are converted to the GMT timezone before being returned.
This may be problematic as YTMND uses CST for all of its timestamps as its servers are located in the CST timezone.
It is possible that in the future an option may be added to allow timestamps to be returned in CST.

  • The YTMND API and Digg API differ in that the YTMND API will always return a container, even if your request returns no results.
  • HTTP response codes should always be 200 (OK) or 304 (Not Modified) if the response is cached.

Data Limitations

In its initial form, the YTMND API offers no form of pagination or custom limiting of its data response. Each interface has its own specific rules, but in most cases your requests will not return gigantic amounts of data. Various methods should be expected to return more data than others, but such information is listed on each interface's documentation page.