YackTrack RSS
The API is very simple. There is one basic HTTP call that takes some query parameters. The result format can be either extended RSS or JSON, though the data is basically the same. The call format is as follows:
Extended RSS Format
The YackTrack RSS feeds are mostly standard RSS 2.0 with some custom elements to describe the comment concept. The table below describes the elements, as well as what is optional. This information is based on the information that is available from the source services, so YackTrack is not in complete control of what information is presented.
| Element Name | Element Source | Parent Element | Required | Number Allowed | Description |
|---|---|---|---|---|---|
| title | RSS | channel | required | 1 | Standard YackTrack title: “YackTrack RSS coomments for (url)” |
| link | RSS | channel | required | 1 | Link back to the original YackTrack query. |
| description | RSS | channel | required | 1 | Always the YackTrack description: “YackTrack.com RSS feed for comments related to the search term.” |
| pubDate | RSS | channel | required | 1 | Date that the feed was generated in the format of “Mon, 26 May 2008 07:04:26 EDT” |
| item | RSS | channel | optional | 1 | Standard RSS item element. If there are no items in the feed, there will be no item elements. |
| title | RSS | item | required | 1 | Title of the item from the source service. |
| link | RSS | item | required | 1 | Link back to the source service query. |
| description | RSS | item | optional | 1 | Description of the item from the source service. |
| pubDate | RSS | item | optional | 1 | Date that the source service item was created in the format of “Mon, 26 May 2008 07:04:26 EDT” |
| yt:service | YackTrack | item | required | 1 | Name of the source service. For example, Mixx, StumbleUpon, etc. |
| yt:comment | YackTrack | item | required | multiple | If an item exists, there will always be at least one yt:comment element. It is just a container element. |
| yt:comment-title | YackTrack | yt:comment | optional | 1 | Title of the comment from the source service. |
| yt:comment-link | YackTrack | yt:comment | optional | 1 | Link to the comment from the source service. |
| yt:comment-description | YackTrack | yt:comment | required | 1 | This is the actual content of the comment from the source service. |
| yt:comment-author | YackTrack | yt:comment | optional | 1 | The author of the comment from the source service. |
| yt:comment-pubDate | YackTrack | yt:comment | optional | 1 | Date the comment was made on the source service in the format of “Mon, 26 May 2008 07:04:26 EDT” |
JSON Format
The JSON format was provided because custom RSS is generally a pain to deal with. The format of the JSON feed is as follows:
title link description pubDate - in the format of "Monday, 26 May 2008 10:23:00 EDT" feeds[] - list of service feeds title - title of service feed link - link back to the source service description pubDate - in the format of "Monday, 26 May 2008 10:23:00 EDT" serviceName comments[] title - optional title of the comment link - optional link back to the comment comment - actual comment text author - author of the comment, possibly a link back to the user profile pubDate - in the format of "Monday, 26 May 2008 10:23:00 EDT"
Subscribe to RSS