AddThis

Content Feeds

Put your analytics to work for you!

Use our API to access RSS and JSON feeds of your top content. Incorporating these feeds into your pages and widgets will surface your best content to users and invite them to click on interesting parts of your site.

• Feed Types
• Enabling Your Feeds
• Requests
• Examples
• Responses

Feed Types

We offer three types of feeds depending on the viral activity you want to leverage. Use the links below to check out the feeds for the top content on our blog

Trending Feed

A feed of your content that has recently started to trend.

Example: http://q.addthis.com/feeds/1.0/trending.rss?pubid=atblog

Most Shared Feed

A feed that returns your most shared urls.

Example: http://q.addthis.com/feeds/1.0/shared.rss?pubid=atblog

Most Clicked Feed

A feed that returns your most clicked urls. You must have click tracking turned on to use this feed.

Example: http://q.addthis.com/feeds/1.0/clicked.rss?pubid=atblog

Enabling Your Feeds

Before you can use your content feeds you must enable them for your publisher profile. To do this, visit your profile settings page and choose the profile you'd like to access (you may have only one profile). Scroll down to content feeds, select the checkbox and click save to enable your feed.

Your content feeds are turned off by default because they contain data that was formerly private to your account. To function properly, the feeds must be publicly accessible by the internet so they can be integrated into web pages, widgets and feed readers. When you enable your content feeds you make this data public. Most publishers are ok with this but we offer our feeds as an opt-in feature so you can keep control over your data. The rest of your analytics data will remain private and can be accessed via our password protected analytics api.

Requests

To access your feed choose your feed type, locate your pubid from your profile settings page and build a request url as shown below.

Request URL Format

http://q.addthis.com/feeds/1.0/<type>.<format>?pubid=<pubid>[&<optional parameters>]

Feed Format

Feeds can be requested in RSS or JSON format by including the .rss or .json extension on the url. If you prefer a JSONP response you can make a .json request and pass a callback=<function> url parameter.

Feed Parameters

These settings allow you to control the time range used to compute your feed data and filter by a specific domain or service.

Examples

Here are some different ways to use our feeds. These examples pull data for shares on our blog. Make sure to replace atblog with your own pubid to access content from your own site.

RSS feed of my top trending content on facebook

http://q.addthis.com/feeds/1.0/trending.rss?pubid=atblog&service;=facebook

JSON feed of my most emailed content this month

http://q.addthis.com/feeds/1.0/shared.rss?pubid=atblog&service;=email.=month

JSONP data for the most clicked urls on my home domain

http://q.addthis.com/feeds/1.0/clicked.rss?pubid=atblog&domain;=addthis.com&callback;=func

Response Data

Responses will up to 20 of your urls, starting with your most active url and sorted in descending order. The feed data is computed based on how much users have shared and clicked our content using AddThis tools. If you're just starting out with AddThis the feeds may not have data yet. If your website has modest traffic, try the week or month period to increase your scope. The content of your feeds will change on a daily basis as sharing happens on your site.

RSS 2.0 Feed of Your Trending URLs:

• http://q.addthis.com/feeds/1.0/shared.rss?pubid=atblog

<rss version="2.0">
  <channel>
    <title>Most Shared Content</title>
    <link>http://www.addthis.com/</link>
    <description>Feed of urls that were most shared from AddThis</description>
    <pubDate>Fri, 04 Feb 2011 20:50:32 -0500</pubDate>
    <item>
      <title>AddThis Blog » Blog Archive » Sharing Trends in 2010</title>
      <link>http://www.addthis.com/blog/2010/12/29/sharing-trends-in-2010/</link>
    </item>
    ...
</channel>

JSON/JSONP List of Your Most Shared URLs

• http://q.addthis.com/feeds/1.0/shared.json?pubid=atblog

[
    {
        url: http://www.addthis.com/blog/2011/02/04/addthis-users-help-make-addthis-better/
        title: "AddThis Users Help Make AddThis Better"
    },
    ...
}