AideRSSmantra

Entry Stats

From AideRSS API Documentation

Contents

entry_stats

http://api.aiderss.com/entry_stats

Returns the stats for the specified entries in the specified feeds.

This API is not recommended. We would ask that if at all possible you get the data from the Feed API, since they both provide the same data.

Parameters

Note: The request must be POST, but appkey and format are still specified in a GET-style query string.

HTTP GET

  • appkey=[string] : An Application Key (usually your domain name).
  • format=[rss|json] : The format to return data in.
  • callback=[jsonp callback] : (Optional) Callback for JSONP data.

HTTP POST

  • feed_id[]=[feed id(s)] : The internal ID(s) of the feed(s) the entries are in the context of (see Feed ID).
  • link[]=[entry url(s)] : The URL(s) of the entrie(s) to get stats for.
  • fields[]=[postrank|postrank_color|slash_comments|digs|delicious|google] : (Optional) A set of stat fields to return data for (ie fields[]=postrank&fields[]=digs).

Returns

A list of entry stats.

Example Response

RSS

http://api.aiderss.com/entry_stats?appkey=aiderss.com&format=rss POST link[]=http://google.com&feed_id[]=1221

Result
<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:wfw="http://wellformedweb.org/CommentAPI/" xmlns:aiderss="http://aiderss.com/xsd/2007-11-30/aiderss" xmlns:slash="http://purl.org/rss/1.0/modules/slash/">
        <channel>
                <title>Entry Stats</title>
                <item>
                        <link>http://google.com</link>
                        <aiderss:postrank>5.7</aiderss:postrank>
                        <aiderss:postrank_color>#ffa659</aiderss:postrank_color>
                </item>
        </channel>
</rss>
Errors
<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:wfw="http://wellformedweb.org/CommentAPI/" xmlns:aiderss="http://aiderss.com/xsd/2007-11-30/aiderss" xmlns:slash="http://purl.org/rss/1.0/modules/slash/">
        <channel>
                <title>Entry Stats</title>
                <item>
                        <title>errorURL(s) missing</title>
                        <description>{"error"=>"URL(s) missing"}</description>
                </item>
        </channel>
</rss>

JSON

http://api.aiderss.com/entry_stats?appkey=aiderss.com&format=json POST url[]=http://google.com&feed_id[]=1221

Result
{'http://...snip...':{"delicious":6.0,"slash_comments":0.0,"postrank":3.0,"digs":1.0,"google":3.0,"postrank_color":"#ffc777"}, ...snip... }
Errors
{"error":"FeedID is missing or invalid"}
Retrieved from "http://apidoc.aiderss.com/Entry_Stats"