Awareness API
Introduction
The FeedBurner Awareness API (AwAPI) allows publishers of FeedBurner feeds to reuse the detailed traffic statistics we capture for any of their feeds. Third-party applications and web services that consume feeds can leverage this data to provide useful feed awareness statistics to potential subscribers. FeedBurner captures traffic data at an overall level for every feed. Feeds that use our free FeedBurner Stats PRO item view tracking have access to much more detailed data at the individual item level. This data includes "resyndication" information, which is very useful for determining where and how a feed is being consumed.
What is “Awareness?”
Feed Awareness describes the extent and frequency with which a publisher's feed and its content items are consumed, clicked on, and referred to by independent sources (i.e., "syndicated").
The following data characterizes Feed Awareness:
- Feed Circulation and Hits: Circulation is a daily measure of feed readership and popularity, recorded over the life of your feed. Hits are a raw measure of request traffic for your feed.
- Detailed Item Popularity: The popularity of each item published as determined by itemviews and clickthroughs.
- Item Syndication: Redisplay or repurposing of a feed's content on a third party website that generates traffic (as itemviews and clickthroughs).
The reports and charts you see when using The FeedBurner website are based on the same data. Using AwAPI, you can create your own analysis and tracking applications. It's your data. Display it your way!
AwAPI Activation and the FeedCount Chicklet
Do you currently use FeedCount to publicize your feed’s circulation? If so, AwAPI is already active for that feed. If you want to continue using FeedCount but do not want to permit any AwAPI access to your feed's traffic data, uncheck “Activate Awareness API for my feed” as described on the main Developers page.
Sample Applications #
Podfeed.net
The folks at Podfeed.net are using AwAPI to display circulation data about podcast feeds. Podfeed uses GetFeedData (with the feed URI passed as an argument) within their ASP-based pages fetches the current circulation from FeedBurner each time the page is requested by a user.
Subscribe to your own FeedBurner stats
Paul Kedrosky has written a script that publishes feed stats via RSS. Supply your FeedBurner URI as an argument to http://www.kedrosky.com/cgi/fb-stats.cgi?n=FeedURI, then subscribe to the feed it returns in any newsreader. (But please honor Paul’s request to not “beat the tar out of this.”)
Note on Date Ranges #
In AwAPI calls, date ranges may be expressed as follows:
- Individual dates always use this format:
YYYY-MM-DD - Date ranges are expressed with a comma:
YYYY-MM-D1,YYYY-MM-D7means all dates between and including D1 and D7 - If a range is specified, the second date must always be later than the first date
- A single date will be interpreted as a range of one date:
YYYY-MM-D1=YYYY-MM-D1, YYYY-MM-D1 - Discrete ranges are separated by a slash:
YYYY-MM-D1/YYYY-MM-D5/YYYY-MM-D7,YYYY-MM-D14means D1 and D5 and all dates between and including D7 and D14. Multiple discrete ranges may also be provided by using multiple date parameters in a single GET request. - If no date is specified, Yesterday's date is assumed. "Current" is always yesterday's data. "Live" daily data is not yet available.
- An individual date starts at 12am CDT (GMT -5) and ends 12am CDT the next day. Custom timezone support is not yet available.
GetFeedData
Current Basic Feed Awareness Data #
GET api.feedburner.com/awareness/1.0/GetFeedData?uri=<feeduri>
Arguments
| Field | Description |
|---|---|
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) Must be used if id is not specified |
| id | The FeedBurner id of the feed (visible when editing a feed in your account, e.g., http://www.feedburner.com/fb/a/optimize?id=<id>). May be used instead if uri is not specified. |
Sample response
| Field | Description |
|---|---|
| rsp | Container for the entire response |
| stat | Status of the response—“ok” indicates a normal response, “fail” indicates an abnormal one |
| err | Container for error messages |
| msg | Message associated with a particular error |
| code | Numeric code associated with a particular error |
| feed | Container for feed-specific responses |
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| entry | A date-specific container within the feed container |
| date | The date this entry describes. |
| circulation | An approximate measure of the number of individuals for whom your feed has been requested in the 24 hour period described by date |
| hits | The exact number of requests for your FeedBurner feed during the 24 hour period described by date |
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
<feed uri="BurningQuestions" >
<entry date="2005-05-10" circulation="2199" hits="39897" />
</feed>
</rsp>
Error codes
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="1" msg="Feed Not Found" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="2" msg="This feed does not permit Awareness API access" />
</rsp>
(Note: A feed publisher must elect to make this service available when they configure their feed.)
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="5" msg="Missing Required Parameter (URI)" />
</rsp>
Past Basic Feed Awareness Data #
GET api.feedburner.com/awareness/1.0/GetFeedData?uri=<feeduri>&dates=2005-05-01,2005-05-03
Arguments
| Field | Description |
|---|---|
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>). Must be used if id is not specified. |
| id | The FeedBurner id of the feed (visible when editing a feed in your account, e.g., http://www.feedburner.com/fb/a/optimize?id=<id>). May be used instead if uri is not specified. |
| dates | Dates are used to specify the period for which data is need (see note on dates) |
Sample response
| Field | Description |
|---|---|
| rsp | Container for the entire response |
| stat | Status of the response—“ok” indicates a normal response, “fail” indicates an abnormal one |
| err | Container for error messages |
| msg | Message associated with a particular error |
| code | Numeric code associated with a particular error |
| feed | Container for feed-specific responses |
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| entry | A date-specific container within the feed container |
| date | The date this entry describes. |
| circulation | An approximate measure of the number of individuals for whom your feed has been requested in the 24 hour period described by date |
| hits | The exact number of requests for your FeedBurner feed during the 24 hour period described by date |
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
<feed uri="BurningQuestions" >
<entry date="2005-05-01" circulation="2199" hits="39897" />
<entry date="2005-05-02" circulation="2187" hits="40003" />
<entry date="2005-05-03" circulation="2165" hits="38776" />
</feed>
</rsp>
Error codes
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="1" msg="Feed Not Found" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="2" msg="This feed does not permit Awareness API access" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="5" msg="Missing required parameter (URI)" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="6" msg="Malformed parameter (DATES)" />
</rsp>
(Note: dates must conform to a specific format — see note on dates above.)
GetItemData
Current Item Awareness Data #
GET api.feedburner.com/awareness/1.0/GetItemData?uri=<feeduri>
Arguments
| Field | Description |
|---|---|
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
Sample response
| Field | Description |
|---|---|
| rsp | Container for the entire response |
| stat | Status of the response—“ok” indicates a normal response, “fail” indicates an abnormal one |
| err | Container for error messages |
| msg | Message associated with a particular error |
| code | Numeric code associated with a particular error |
| feed | Container for feed-specific responses |
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| entry | A date-specific container within the feed container |
| date | The date this entry describes. |
| circulation | An approximate measure of the number of individuals for whom your feed has been requested in the 24 hour period described by date |
| hits | The exact number of requests for your FeedBurner feed during the 24 hour period described by date |
| item | Container for feed item-specific data |
| title | Title of the Item |
| url | Source feed URL of this item |
| itemviews | The number of times an individual content item has been displayed in a feed reader |
| clickthroughs | The number of requests from individuals and bots for a specific content item’s original linked content from your feed |
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
<feed uri="BurningQuestions" >
<entry date="2005-05-10" circulation="2199" hits="39897" >
<item title="Google AdSense Support"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="3901" clickthroughs="2500" />
<item title="Premium Service: Total Stats Pro"
url="http://blogs.feedburner.com/feedburner/archives/001163.html"
itemviews="2003" clickthroughs="1898" />
<item title="20six and Partner API"
url="http://blogs.feedburner.com/feedburner/archives/001164.html"
itemviews="2598" clickthroughs="2045" />
<item title="Circulation Reporting and Statistics Enhancements"
itemviews="598" clickthroughs="432" />
</entry>
</feed>
</rsp>
Error codes
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="1" msg="Feed Not Found" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="2" msg=" This feed does not permit Awareness API access" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="4" msg="Data restricted; this feed does not have FeedBurner Stats PRO item view tracking enabled" />
</rsp>
Note: to get item level stats the feed must be a FeedBurner Stats feed with the "track item views" feature enabled.
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="5" msg="Missing required parameter (URI)" />
</rsp>
Current Individual Item Awareness Data #
GET api.feedburner.com/awareness/1.0/GetItemData?uri=<feeduri>&itemurl=<itemurl>
Arguments
| Field | Description |
|---|---|
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| itemurl | The source URL of item (not the FeedBurner generated URL, but the original source URL). Multiple itemurl parameters may be provided in a single request in order to retrieve additional items. |
Sample response
| Field | Description |
|---|---|
| rsp | Container for the entire response |
| stat | Status of the response—“ok” indicates a normal response, “fail” indicates an abnormal one |
| err | Container for error messages |
| msg | Message associated with a particular error |
| code | Numeric code associated with a particular error |
| feed | Container for feed-specific responses |
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| entry | A date-specific container within the feed container |
| date | The date this entry describes. |
| circulation | An approximate measure of the number of individuals for whom your feed has been requested in the 24 hour period described by date |
| hits | The exact number of requests for your FeedBurner feed during the 24 hour period described by date |
| item | Container for feed item-specific data |
| title | Title of the Item |
| url | Source feed URL of this item |
| itemviews | The number of times an individual content item has been displayed in a feed reader |
| clickthroughs | The number of requests from individuals and bots for a specific content item’s original linked content from your feed |
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
<feed uri="BurningQuestions" >
<entry date="2005-05-10" circulation="2199" hits="39897" >
<item title="Premium Service: Total Stats Pro"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2003" clickthroughs="1898" />
</entry>
</feed>
</rsp>
Error codes
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="1" msg="Feed Not Found" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="2" msg="This feed does not permit Awareness API access" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="3" msg="Item Not Found In Feed" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="4" msg="Data restricted - this feed does not have FeedBurner Stats PRO item view tracking enabled" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?
<rsp stat="fail">
<err code="5" msg="Missing required parameter (URI)" />
</rsp>
Past Item Awareness Data #
GET api.feedburner.com/awareness/1.0/GetItemData?uri=<feeduri>&dates=2005-05-01,2005-05-02
Arguments
| Field | Description |
|---|---|
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| dates | Dates are used to specify the period for which data is need (see note on dates) |
Sample response
| Field | Description |
|---|---|
| stat | Status of the response—“ok” indicates a normal response, “fail” indicates an abnormal one |
| err | Container for error messages |
| msg | Message associated with a particular error |
| code | Numeric code associated with a particular error |
| feed | Container for feed-specific responses |
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| entry | A date-specific container within the feed container |
| date | The date this entry describes. |
| circulation | An approximate measure of the number of individuals for whom your feed has been requested in the 24 hour period described by date |
| hits | The exact number of requests for your FeedBurner feed during the 24 hour period described by date |
| item | Container for feed item-specific data |
| title | Title of the Item |
| url | Source feed URL of this item |
| itemviews | The number of times an individual content item has been displayed in a feed reader |
| clickthroughs | The number of requests from individuals and bots for a specific content item’s original linked content from your feed |
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
<feed uri="BurningQuestions" >
<entry date="2005-05-01" circulation="2199" hits="39897" >
<item title=" Google AdSense Support"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="3901" clickthroughs="2500" />
<item title=" Premium Service: Total Stats Pro"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2003" clickthroughs="1898" />
<item title=" 20six and Partner API"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2598" clickthroughs="2045" />
<item title=" Circulation Reporting and Statistics Enhancements"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="598" clickthroughs="432" />
</entry>
<entry date="2005-05-02" circulation="2001" hits="39783" >
<item title=" Google AdSense Support" itemviews="3951"
clickthroughs="2690" />
<item title=" Premium Service: Total Stats Pro"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2043" clickthroughs="1798" />
<item title=" 20six and Partner API"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2588" clickthroughs="2035" />
<item title=" Circulation Reporting and Statistics Enhancements"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="578" clickthroughs="332" />
</entry>
</feed>
</rsp>
Error codes
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="1" msg="Feed Not Found" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="2" msg="This feed does not permit Awareness API access" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="4" msg="Data restricted - this feed does not have FeedBurner Stats PRO item view tracking enabled" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="5" msg="Missing required parameter (URI)" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="6" msg="Malformed parameter (DATES)" />
</rsp>
(Note: dates must conform to a specific format — see note on dates above.)
Past Individual Item Awareness Data #
GET api.feedburner.com/awareness/1.0/GetItemData?uri=<feeduri>&itemurl=<itemurl>
&dates=2005-05-01,2005-05-02
Arguments
| Field | Description |
|---|---|
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| itemurl | The source URL of item (not the FeedBurner-generated URL, but the original source URL). Multiple itemurl parameters may be provided in a single request in order to retrieve additional items. |
| dates | Dates are used to specify the period for which data is need (see note on dates) |
Sample response
| Field | Description |
|---|---|
| stat | Status of the response—“ok” indicates a normal response, “fail” indicates an abnormal one |
| err | Container for error messages |
| msg | Message associated with a particular error |
| code | Numeric code associated with a particular error |
| feed | Container for feed-specific responses |
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| entry | A date-specific container within the feed container |
| date | The date this entry describes. |
| circulation | An approximate measure of the number of individuals for whom your feed has been requested in the 24 hour period described by date |
| hits | The exact number of requests for your FeedBurner feed during the 24 hour period described by date |
| item | Container for feed item-specific data |
| title | Title of the Item |
| url | Source feed URL of this item |
| itemviews | The number of times an individual content item has been displayed in a feed reader |
| clickthroughs | The number of requests from individuals and bots for a specific content item’s original linked content from your feed |
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
<feed uri="BurningQuestions" >
<entry date="2005-05-01" circulation="2199" hits="39897" >
<item title="Premium Service: Total Stats Pro"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2003" clickthroughs="1898" />
</entry>
<entry date="2005-05-02" circulation="2479" hits="40867" >
<item title="Premium Service: Total Stats Pro"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2453" clickthroughs="1998" />
</entry>
</feed>
</rsp>
Error codes
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="1" msg="Feed Not Found" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="2" msg="This feed does not permit Awareness API access" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="3" msg="Item Not Found In Feed" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="4" msg="Data restricted - this feed does not have FeedBurner Stats PRO item view tracking enabled" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="5" msg="Missing required parameter (URI)" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="6" msg="Malformed parameter (DATES)" />
</rsp>
(Note: dates must conform to a specific format — see note on dates above.)
GetResyndicationData
Current Item Resyndication Feed Awareness Data #
GET api.feedburner.com/awareness/1.0/GetResyndicationData?uri=<feeduri>
Arguments
| Field | Description |
|---|---|
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
Sample response
| Field | Description |
|---|---|
| stat | Status of the response—“ok” indicates a normal response, “fail” indicates an abnormal one |
| err | Container for error messages |
| msg | Message associated with a particular error |
| code | Numeric code associated with a particular error |
| feed | Container for feed-specific responses |
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| entry | A date-specific container within the feed container |
| date | The date this entry describes. |
| circulation | An approximate measure of the number of individuals for whom your feed has been requested in the 24 hour period described by date |
| hits | The exact number of requests for your FeedBurner feed during the 24 hour period described by date |
| item | Container for feed item-specific data |
| title | Title of the Item |
| url | Source feed URL of this item |
| itemviews | The number of times an individual content item has been displayed in a feed reader |
| clickthroughs | The number of requests from individuals and bots for a specific content item’s original linked content from your feed |
| referrer | Container for referrer-specific data—includes the URL of the referrer |
| itemviews | The number of times an individual content item has been displayed in a feed reader via this referrer |
| clickthroughs | The number of requests from individuals and bots for a specific content item’s original linked content from your feed via this referrer |
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
<feed uri="BurningQuestions" >
<entry date="2005-05-10" circulation="2199" hits="39897" >
<item title=" Google AdSense Support"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="3901" clickthroughs="2500">
<referrer itemviews="3100" clickthroughs=2000>http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="801" clickthroughs="500">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
<item title="Premium Service: Total Stats Pro"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2003" clickthroughs="1898" >
<referrer itemviews="2001" clickthroughs="1898">http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="2" clickthroughs="0">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
<item title="20six and Partner API"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2598" clickthroughs="2045" >
<referrer itemviews="2402" clickthroughs=2001>http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="196" clickthroughs="44">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
<item title="Circulation Reporting and Statistics Enhancements"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="598" clickthroughs="432" >
<referrer itemviews="450" clickthroughs=395>http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="148" clickthroughs="37">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
</entry>
</feed>
</rsp>
Error codes
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="1" msg="Feed Not Found" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="2" msg="This feed does not permit Awareness API access" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="4" msg="Data restricted - this feed does not have FeedBurner Stats PRO item view tracking enabled" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="5" msg="Missing required parameter (URI)" />
</rsp>
Current Individual Item Resyndication Feed Awareness Data #
GET api.feedburner.com/awareness/1.0/GetResyndicationData?uri=<feeduri>&itemurl=<itemurl>
Arguments
| Field | Description |
|---|---|
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| itemurl | The source URL of item (not the FeedBurner generated URL, but the original source URL). Multiple itemurl parameters may be provided in a single request in order to retrieve additional items. |
Sample response
| Field | Description |
|---|---|
| stat | Status of the response—“ok” indicates a normal response, “fail” indicates an abnormal one |
| err | Container for error messages |
| msg | Message associated with a particular error |
| code | Numeric code associated with a particular error |
| feed | Container for feed-specific responses |
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| entry | A date-specific container within the feed container |
| date | The date this entry describes. |
| circulation | An approximate measure of the number of individuals for whom your feed has been requested in the 24 hour period described by date |
| hits | The exact number of requests for your FeedBurner feed during the 24 hour period described by date |
| item | Container for feed item-specific data |
| title | Title of the Item |
| url | Source feed URL of this item |
| itemviews | The number of times an individual content item has been displayed in a feed reader |
| clickthroughs | The number of requests from individuals and bots for a specific content item’s original linked content from your feed |
| referrer | Container for referrer-specific data—includes the URL of the referrer |
| itemviews | The number of times an individual content item has been displayed in a feed reader via this referrer |
| clickthroughs | The number of requests from individuals and bots for a specific content item’s original linked content from your feed via this referrer |
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
<feed uri="BurningQuestions"
<entry date="2005-05-10" circulation="2199" hits="39897" >
<item title=" Google AdSense Support"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="3901" clickthroughs="2500">
<referrer itemviews="3100" clickthroughs=2000>http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="801" clickthroughs="500">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
</entry>
</feed>
</rsp>
Error codes
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="1" msg="Feed Not Found" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="2" msg="This feed does not permit Awareness API access" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="3" msg="Item Not Found In Feed" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="4" msg="Data restricted - this feed does not have Total Stats PRO enabled" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="5" msg="Missing required parameter (URI)" />
</rsp>
Past Individual Item Resyndication Feed Awareness Data #
GET api.feedburner.com/awareness/1.0/GetResyndicationData?uri=<feeduri>&dates=2005-05-01,2005-05-02
Arguments
| Field | Description |
|---|---|
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| dates | Dates are used to specify the period for which data is need (see note on dates) |
Sample response
| Field | Description |
|---|---|
| stat | Status of the response—“ok” indicates a normal response, “fail” indicates an abnormal one |
| err | Container for error messages |
| msg | Message associated with a particular error |
| code | Numeric code associated with a particular error |
| feed | Container for feed-specific responses |
| uri | The URI of the feed (same as http://feeds.feedburner.com/<feeduri>) |
| entry | A date-specific container within the feed container |
| date | The date this entry describes. |
| circulation | An approximate measure of the number of individuals for whom your feed has been requested in the 24 hour period described by date |
| hits | The exact number of requests for your FeedBurner feed during the 24 hour period described by date |
| item | Container for feed item-specific data |
| title | Title of the Item |
| url | Source feed URL of this item |
| itemviews | The number of times an individual content item has been displayed in a feed reader |
| clickthroughs | The number of requests from individuals and bots for a specific content item’s original linked content from your feed |
| referrer | Container for referrer-specific data—includes the URL of the referrer |
| itemviews | The number of times an individual content item has been displayed in a feed reader via this referrer |
| clickthroughs | The number of requests from individuals and bots for a specific content item’s original linked content from your feed via this referrer |
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
<feed uri="BurningQuestions" >
<entry date="2005-05-01" circulation="2199" hits="39897" >
<item title=" Google AdSense Support"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="3901" clickthroughs="2500">
<referrer itemviews="3100" clickthroughs=2000>http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="801" clickthroughs="500">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
<item title="Premium Service: Total Stats Pro"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2003" clickthroughs="1898" >
<referrer itemviews="2001" clickthroughs="1898">http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="2" clickthroughs="0">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
<item title="20six and Partner API"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2598" clickthroughs="2045" >
<referrer itemviews="2402" clickthroughs=2001>http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="196" clickthroughs="44">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
<item title="Circulation Reporting and Statistics Enhancements"
url="http://blogs.feedburner.com/feedburner/archives/001162.html" itemviews="598"
clickthroughs="432" >
<referrer itemviews="450" clickthroughs=395>http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="148" clickthroughs="37">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
</entry>
<entry date="2005-05-02" circulation="2199" hits="39897" >
<item title=" Google AdSense Support"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="3901" clickthroughs="2500">
<referrer itemviews="3100" clickthroughs=2000>http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="801" clickthroughs="500">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
<item title="Premium Service: Total Stats Pro"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2003" clickthroughs="1898" >
<referrer itemviews="2001" clickthroughs="1898">http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="2" clickthroughs="0">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
<item title="20six and Partner API"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="2598" clickthroughs="2045" >
<referrer itemviews="2402" clickthroughs=2001>http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="196" clickthroughs="44">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
<item title="Circulation Reporting and Statistics Enhancements"
url="http://blogs.feedburner.com/feedburner/archives/001162.html"
itemviews="598" clickthroughs="432" >
<referrer itemviews="450" clickthroughs=395>http://feeds.feedburner.com/
Burning Questions</referrer>
<referrer itemviews="148" clickthroughs="37">http://www.myblog.com/
BurningQuestions.html</referrer>
</item>
</entry>
</feed>
</rsp>
Error codes
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="1" msg="Feed Not Found" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="2" msg="This feed does not permit Awareness API access" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="4" msg="Data restricted - this feed does not have FeedBurner Stats PRO item view tracking enabled" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="5" msg="Missing required parameter (URI)" />
</rsp>
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
<err code="6" msg="Malformed parameter (DATES)" />
</rsp>
(Note: dates must conform to a specific format — see note on dates above.)