English | Site Directory

FeedBurner API

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-D7 means 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-D14 means 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.

Back to top

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>

Back to top

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.)

Back to top

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>

Back to top

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>

Back to top

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.)

Back to top

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.)

Back to top

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>

Back to top

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>

Back to top

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.)