Subscribe to Our Newsletter

x

Public API v1.1 - Roar/Runner

RebelMouse Public API version 1.1 is available as of May 10th, 2016. The older version of the API (RebelMouse Public API version 1.0) will be deprecated on August 15, 2016. Please make sure to switch over any and all calls to the new API by that time.

The new API improvements include:

  • New Authors API
  • New Insights API
  • New response format
  • Various endpoints' updates

FRONTPAGE POSTS

Returns frontpage posts.

https://{roar_domain}/api/1.1/posts/frontpage?limit={limit}&offset={offset}

Argument    Required    Default    Description                  Examplelimit       no          10         number of posts to return    1offset      no          0          number of posts to skip      10

POSTS BY SECTION

Returns section’s posts.

https://{roar_domain}/api/1.1/posts/section?section_name={section}&limit={limit}&offset={offset}

Argument        Required    Default    Description                  Examplelimit           no          10         number of posts to return    1offset          no          0          number of posts to skip      10section_name    yes         -          section's url                apps

POSTS BY AUTHOR

Returns author’s posts.

https://{roar_domain}/api/1.1/posts/author?author_name={author_name}&limit={limit}&offset={offset}

Argument       Required    Default    Description                  Examplelimit          no          10         number of posts to return    1offset         no          0          number of posts to skip      10author_name    yes         -          author’s name                luladog

POSTS BY TAG

Returns posts by tag.

https://{roar_domain}/api/1.1/posts/tag?tag={tag}&exclude_tags={exclude_tags}&limit={limit}&offset={offset}

Argument        Required    Default    Description                               Examplelimit           no          10         number of posts to return                 1offset          no          0          number of posts to skip                   10roar_domain     yes         -          roar domain                               positivemousetag             yes         -          tag                                       pythonexclude_tags    no          -          tags to exclude (comma separated list)    mouse

POSTS’ DETAILS

Returns posts’ details.

https://{roar_domain}/api/1.1/posts?ids={ids}

Argument    Required    Default    Description     Exampleids         yes         -          ids of posts    1,2,3

SITES’ DETAILS

Return sites' details.

https://{roar_domain}/api/1.1/site/details?site_id={site_id}

Argument    Required    Default    Description    Examplesite_id     yes         -          site’s id      1

AUTHORS’ DETAILS

Return authors' details.

https://{roar_domain}/api/1.1/authors?ids={ids}&access_token={access_token}

Argument        Required    Default    Description     Exampleids             yes         -          authors' ids    19access_token    yes         -          access token    bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6

AUTHORS’ DETAILS BY NAME

Return authors' details by name.

https://{roar_domain}/api/1.1/authors/name?author_names={author_names}&access_token={access_token}

Argument        Required    Default    Description       Exampleauthor_names    yes         -          authors' names    positivemouseaccess_token    yes         -          access token      bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6

AUTHORS’ DETAILS BY FACEBOOK ID

Return authors' details by facebook ids.

https://{roar_domain}/api/1.1/authors/facebook?fb_ids={fb_ids}&access_token={access_token}

Argument        Required    Default    Description     Examplefb_ids          yes         -          facebook ids    19323283access_token    yes         -          access token    bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6

OVERALL POSTS STATS

GET https://{roar_domain}/api/1.1/insights/posts/ordered?order={order}&period={period}&limit={limit}&offset={offset}&access_token={access_token}

Argument        Required    Description                               Restrictions                                                                       Exampleorder           yes         The field for results to be ordered by    Only "total_views" value is valid for now                                          total_viewsperiod          yes         Period which ends now                     Only "1h", "6h", "12h", "24h", "7d", "30d", "lifetime" values are valid for now    7dlimit           yes         Number of records to return               Positive integer, Max value = 30                                                   10offset          yes         Number of records to skip                 Non-negative integer                                                               5access_token    yes         Access token for the roar                 String                                                                             bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6

Respons:

{    "status": {        "code": 0,        "messages": []    },    "data": {        "report": {            "records": [{                "post_id": 12312321,                "total_views": 1234            }, {                "post_id": 4859674589,                "total_views": 4321            },            ...            ]        }    }}

INDIVIDUAL POSTS STATS

GET https://{roar_domain}/api/1.1/insights/posts/details?period={period}&ids={ids}&access_token={access_token}

Argument        Required    Description                  Restrictions                                                                       Exampleperiod          yes         Period which ends now        Only "1h", "6h", "12h", "24h", "7d", "30d", "lifetime" values are valid for now    7dids             yes         List of post IDs             Positive long numbers separated by comma, Max number = 30                          12312321,4859674589access_token    yes         Access token for the roar    String                                                                             bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6

Respons:

{    "status": {        "code": 0,        "messages": []    },    "data": {        "report": {            "records": [{                "post_id": 12312321,                "total_views": 1234            }, {                "post_id": 4859674589,                "total_views": 4321            },            ...            ]        }    }}

FACEBOOK WINS

GET https://{roar_domain}/api/1.1/insights/posts/wins/facebook?period={period}&ids={ids}&access_token={access_token}

Argument        Required    Description                  Restrictions                                                               Exampleperiod          yes         Period which ends now        Only "1h", "6h", "12h", "24h", "7d", "30d", "lifetime" values are valid    7dids             yes         List of post IDs             Positive long numbers separated by comma, Max number = 30                  12312321,4859674589access_token    yes         Access token for the roar    String                                                                     bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6

Respons:

{    "status": {        "code": 0,        "messages": []    },    "data": {        "report": {            "records": [{                "post_id": 567,                "page_fans": 84872,                "page_name": "HOT 107.9",                "page_logo": "https://scontent.xx.fbcdn.net/hprofile-xpt1/v/t1.0-1/p50x50/1509847_10152819708755859_1441502743297395555_n.png?oh=909b90499656ccd816f5d9202526d5ff&oe=57549D5A",                "page_url": "https://www.facebook.com/56194705858",                "post_created_at": 1456822800,                "post_likes": 5,                "post_shares": 0,                "post_comments": 0,                "post_url": "https://www.facebook.com/Hot107.9/posts/10153962058115859"            },            ...            ]        }    }}

TWITTER WINS

GET https://{roar_domain}/api/1.1/insights/posts/wins/twitter?period={period}&ids={ids}&access_token={access_token}

Argument        Required    Description                  Restrictions                                                               Exampleperiod          yes         Period which ends now        Only "1h", "6h", "12h", "24h", "7d", "30d", "lifetime" values are valid    7dids             yes         List of post IDs             Positive long numbers separated by comma, Max number = 30                  12312321,4859674589access_token    yes         Access token for the roar    String                                                                     bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6

Respons:

{    "status": {        "code": 0,        "messages": []    },    "data": {        "report": {            "records": [{                "post_id": 234,                "account_fans": 63500,                "account_logo": "https://pbs.twimg.com/profile_images/706968590717681664/MfcERn0d_normal.jpg",                "account_name": "The Dodo",                "account_url: "https://www.twitter.com/statuses/708080524666007552",                "tweet_created_at" :1457654527,                "tweet_likes": 328,                "tweet_retweets": 328,                "tweet_url": "https://twitter.com/dodo/status/708080524666007552"            },            ...            ]        }    }}

Page Speed Is Crucial to Your Marketing Efforts

Most marketers don't prioritize page speed because they don't think it impacts their bottom line. However, page load has a direct impact on conversions and revenue.

Here's a very simple scenario, supported by industry data, to underscore why the way pages are built and powered is crucial for paid media initiatives and your overall business:

Let's say a paid media campaign drives 100,000 new visitors to a landing page that takes five seconds to load. Google says that 53% of mobile site visitors will leave a page that takes longer than three seconds to load. So of the 100K mobile site visitors you paid to bring to the page, ~50K are leaving immediately due to poor page performance alone.

Some studies even show that bounce rate increases approximately 100% for every two-second delay. So, if site load jumps to seven seconds, you'll pretty much lose all of the visitors your paid strategies brought in.

A Poor Site Experience Costs More Than You Realize

Page load plays a huge part in customer dissatisfaction, too. Continuing on with our previous example, let's classify the ~50K that didn't abandon the page as dissatisfied due to poor page performance. As HubSpot points out, 79% of them are less likely to buy again from the same website. That's ~40K visitors never coming back to the site due to poor page speed. The loss is even greater when you consider how valuable returning visitors are: They represent up to 48% of all transactions and spend almost 2x more than new visitors, according to Business Insider.

Plus, people love to spread the word about a bad experience, probably more than a good one. 40% of visitors who had a bad experience with a website's performance would tell a friend or a family member. So of your 50K dissatisfied visitors, 20K are talking negatively about your brand. If they tell only one person each, that's an opportunity cost of another 20K potential site visitors and customers.

The main takeaway? Your paid media has to work much, much harder when you neglect to optimize your site for performance.

Owned and Paid Media Should Work Together for Better Efficiency

And speaking of site improvements to help the bottom line, marketers can't overlook the value of owned content (e.g., articles, reviews, social feeds, etc.) and its impact on overall traffic and lead generation strategies. Sites tend to see significant lift in audience reach and conversion when content is paired with commerce: For e-commerce companies, content can account for up to 69% of total organic traffic. And, even more compelling, conversion rates have been 6x higher for companies that adopt content marketing.

RebelMouse's CMS makes it easy for brands to systematically optimize page speed performance and organic reach, which allows paid media to be more efficient.

RebelMouse allows clients to easily manage website layouts and components at any time, ensuring sites remain fast and are rewarded by Google and Facebook. Our platform features proprietary SEO tools designed to help clients optimize organic search with every post and better align paid and organic search strategies for increased efficiency. Similarly, our platform also includes proprietary social tools to organically build community and growth, and our data helps clients spot winning organic trends that can inform paid social media.

RebelMouse Is a Partner That Can Guide You

When it comes to content marketing, it's important to be mindful of the relationship between owned, earned, and paid media — it will only help your teams engage and convert more audiences into customers and brand loyalists. At RebelMouse, we're proud of how we work with brands and our ability to provide the expertise, best practices, and modern technology that help teams become better content marketers. If you're a brand marketer, feel free to reach out to us to learn how RebelMouse can help you be more strategic and effective in your content marketing efforts.

Related Articles

Target High-Value Users With Affinity Categories

Unlock valuable audience data and shape a new strategy

In today's landscape, quality content isn't enough — it's half the battle. Publishers need to produce shareable content backed by data to experience sustainable growth. At RebelMouse, we have a unique pageview methodology that provides an innovative user experience for every reader without sacrificing revenue and growth opportunities for publishers.

To do this, we track massive amounts of data across our platform through the use of custom-built Google Data Studio dashboards.

Click here to see the kind of growth our clients experience every day.

One of the best ways to discover more about your audience is by taking advantage of Affinity Categories. This feature breaks down audience demographics, including age, location, interests, and more. Affinity Categories are usually used to target audiences for ads, but we also use them to gain insights on what topics a site's visitors are interested in overall.

Normally, each category is listed out separately in Google Analytics. In the example shown above, our data experts split categories into separate levels to reveal different levels of audience depth. For instance, by splitting up the category News & Politics, we can better explore the detailed distribution of users interested in specific types of news:

  • News & Politics/Avid News Readers/Avid Political News Readers
  • News & Politics/Avid News Readers/Entertainment News Enthusiasts

From an editorial standpoint, this is useful because it allows publishers to determine and target varying levels of high-value users, improving the efficacy of a new content strategy or ad campaign.

If your site is already powered by RebelMouse, email support@rebelmouse.com to get a breakdown of your audience's Affinity Categories. If you aren't powered by RebelMouse yet, request a proposal today and start receiving the data you need to grow loyal followers at scale.

Related Articles

Infinite Scroll: An Innovative + Intuitive UX

There is a common misconception that publishers have to sacrifice monetization and professional design to deliver a high-performing, quality user experience to its readers. But in today's modern publishing environment, websites can deliver an unobtrusive site experience that's intuitive, elegant, and prosperous.

To do this consistently, RebelMouse supports infinite scroll as part of our bigger design strategy called Social UX for Media. Much like the news feeds of Facebook, Twitter, and Instagram, infinite scroll provides an endless stream of articles to its readers so they never reach the "end" of your content.

Infinite scroll is an innovative approach, but it is also a widely adopted standard that has been endorsed and is supported officially by Google, Comscore, Nielsen, and many other industry giants. It's part of a new media strategy deployed by companies with massive valuations and the highest level of visibility in the U.S. market, including Axios, Vice, and The Verge.

In fact, RebelMouse built and launched news powerhouse Axios, now one of the biggest new media companies to date, with our Social UX for Media design featuring infinite scroll. It's still a core part of Axios' successful publishing strategy today. The feature has also been key to the growth of many other RebelMouse-powered properties, including La Verità, Dance Magazine, and United Airlines.

RebelMouse's Social UX for Media design, featuring infinite scroll on hub.united.com.

The primary reason infinite scroll is so successful is because it mimics user behavior in an innovative, yet familiar way, thanks to its similarity to social feeds. On mobile, expandable posts make it easy for users to read "before the jump" and quickly expand to the rest of the article with one click, rather than being taken to another article page. This is similar to when a user expands a caption on Instagram. It's these simple design details that bring massive growth to key stats like return visits and time on site.

Our page view methodology not only keeps the user experience intact, it also includes robust ad serving technology. We use industry standard rules for page views that require at least 50% of the screen space to change before it counts as a new page view. So whether you use Comscore or Nielsen to verify your site traffic, infinite scroll will not have a negative impact on your insights.

If you're interested in launching a site with our game-changing Social UX for Media design, request a proposal today and let's start working together. If your site is already powered by RebelMouse, and you have questions about infinite scroll, email support@rebelmouse.com.

Related Articles

Particle Assembler: Ads in Slideshows Now Supported

You can now insert ads between slides in a slideshow!

Monetizing users' engagement and page views is pivotal to most digital businesses, and our Particle Assembler has been an invaluable tool in helping RebelMouse clients to insert native ads seamlessly into their content. Now we've taken this functionality one step further by introducing support for ads between slides in Assembler's slideshow layout.

Keep reading... Show less
Subscribe to Our Newsletter