Support

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. For easy implementation on your site, use our Trending content box.



Get Your API Endpoint



Feeds

We offer three kinds of feeds depending on the type of activity you want to leverage:

trending
A feed of your content that is growing in popularity.
shared
A feed of your most shared content.
clicked
A feed of your most clicked content. You must have click tracking turned on to use this feed.

Examples

Here are some different ways to use our feeds. These examples are built from the sharing activity on our blog for which we've enabled the feeds. Make sure to replace atblog with your own publisher profile ID to access top content for 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.json?pubid=atblog&service=email&period=month
JSONP request for the most clicked urls on my home domain
http://q.addthis.com/feeds/1.0/clicked.json?pubid=atblog&domain=addthis.com&callback=func
 



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.

Name Description Value Example Default
pubid Publisher profile ID for the feed you wish to retrieve. <publisher profile ID> &pubid=atblog required
period Show urls for a specific time range, starting from yesterday going back a number of days equal to the specified period. day|week|month &period=week day
domain Show urls on a specific domain <domain name> &domain=www.example.com all domains on your account
service Show urls that were shared or clicked to/from a specific service. <service code> &service=email,print all services


Response Data

Responses will contain 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 any data yet. If your website has a modest amount of 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.

Example RSS Response:

<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>
</rss>
 

Example JSON Response:

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

Analytics

We attach tags to content feeds URLs so we can measure clicks and optimize your feed content. URLs in your content feeds will look like this:

http://example.com/blog.html#at_pco=cft-1.0

We'll respect your URLs if they already have fragments - we'll keep the existing fragment intact, though this will limit our ability to measure clicks. We're also using these tags to build content feed analytics so you can see how many views they're driving within your site. Reporting will be available in the coming months.

If you'd rather disable these features you can pass tag=false on your content feed requests, like this:

Errors

You may encounter the following error responses while using this API:

Status Code Error Description
400 20 Missing Parameter See message details about which parameter is missing.
400 30 Invalid Parameter Use only valid parameters. Accept no substitutes.
400 90 Rate Limited Whoa there, you've exceeded the rate limit. Take it easy partner, then try your request again.
401 80 Authentication Failed Invalid userid or password. Try again, but this time, get it right.
404 50 Not Found Check to make sure that your path matches the URL format and uses valid path parameters.
406 70 Unsupported Data Format Is your path extension one of the supported response formats?
500 999 Internal Error Something has gone terribly wrong! This should never happen, but on the off chance that it does, we'll be hard at work to correct it. Please let our team know here if you do encounter a problem.
503 100 Service Unavailable Some requests may take longer to satisfy than others, especially if you are requesting data for the first time. If the server is unable to generate a response in a timely manner, it will return with this error instead. This is to be expected while the service is still new and we're in the process of gauging demand and usage patterns. Simply wait for a short period of time (see Retry-After) and retry your request.
Last Updated: Nov 22, 2013 03:04PM EST
help@addthis.com
http://assets02.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete