Public API v1.1 - Roar/Runner

    
        Our Technology
    
The Ultimate CMSContent Marketing PlatformThe Particle AcceleratorThe Particle Assembler and Accelerator

        Our Creative Agency
    
How We're DifferentHow We Can HelpRedesign & ReplatformGrow Organic ReachSEO Content StrategyMonetization Strategy & Tactics Creative Services

        For Content Creators
    
The RebelMouse Entry EditorThe New Content LifecycleCreating Organic ReachOptimizing Content
For Developers
Layout & Design ToolFeed IngestionWordPress ImportRebelMouse APIAd Configuration

        Insights
    
Rebel Insights BlogSuccess StoriesWhite PapersProduct Updates and Support

        About Us
    
Meet RebelMouseOur InvestorsRebels for Good
Contact
|
Privacy Policy 

Terms of Use
|
RSS Feed  
Copyright © RebelMouse 2020

        Top
    
        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"            },            ...            ]        }    }}

Build on a Better Platform 
 Request a Proposal

        content marketing

        Why RebelMouse Is the Best Content Marketing Platform
    
	RebelMouse is a unique platform and company. The company was founded on the vision that media companies would need an always-modern solution to thrive in the new connected internet, and that brands would have to behave like new media companies and use the same platforms.

                Keep reading...
                Show less
            
        creators

        Why Premium Creative Agencies and CTOs Choose to Develop on RebelMouse vs. WordPress and Drupal
    
    The Intersection of Design and Development: Where Your Clients Thrive

	We started RebelMouse seven years ago knowing that there was a fundamental design flaw in the world of traditional CMSs: Every instance, on every platform, had to be updated independently. It's similar to an era when users had to manage their own Microsoft Exchange Server for email. The costs of managing, maintaining, and iterating on a CMS to keep it awesome and world class is typically a $10 million-a-year endeavor. But even then, these cost-prohibitive CMSs are still behind the times.

                Keep reading...
                Show less
            
        Google Made Major Changes to Its Formula for Page Speed. Here’s What to Do About It.
    
    Understand what Lighthouse 6.0 and Core Web Vitals mean for your website's future

Understanding Lighthouse 6.0
	Since Google's page speed changes in 2018, publishers have engaged in a mad dash to figure out how to build dynamic sites 
	and maintain performance scores that meet the search engine's user experience expectations. Now in 2020, when people are online more than ever, excellent site performance is no longer optional.

	Earlier this year, Google released version 6.0 of Lighthouse. As a reminder, 
	Lighthouse is a tool built into the latest version of Google Chrome that helps you determine how well your site is performing, and tells you which pages on your site need improvement. So let's look at what's changed.

                Keep reading...
                Show less
            
        multivariate testing

        Native Multivariate Testing at Scale With RebelMouse
    
What Differentiates Our Approach

	There are many popular tools that allow you to perform experiments and A/B tests on your users — primarily Google Chrome Experiments and Optimizely. But all of these solutions are JavaScript additions to your web page that sidestep the problem of old, outdated, and clumsy CMSs. These solutions work by calling on a third-party JavaScript library that rewrites a page after it's rendered. This approach adds extra page weight and creates strange user experiences due to having to wait for everything to load and be rewritten on the fly.

	At RebelMouse, we've solved this in a very elegant way. At the core level of our platform, we can natively render different layouts and track the exact differences in performance when comparing a test to your other layouts.

                Keep reading...
                Show less
            
        search engine optimization

        The RebelMouse Approach to SEO
    
    An SEO Strategy That Wins With Every Publish

	How exactly Google determines search ranking largely remains a mystery for publishers, but what we do know is that the search engine continuously rolls out updates to its algorithm. And while sometimes these updates are small and nearly unnoticeable, other times they result in massive changes around the way Google crawls content, often disrupting the rankings of webpages all across the globe.

	With each one of these algorithm changes comes a new approach to search strategy. It's a lot to keep up with in a competitive digital landscape. Publishers are already burdened with the task of creating high-performing quality content that's easy to find on Google and, in turn, easily shared across social. It's a job that can't be solved with advertising dollars either. It's estimated that nearly 
	80% of users disregard paid search results. Pair this with the fact that 93% of all online experiences begin with a search query and you're left with the realization that it's never been more important to prioritize search engine optimization.

	The good news is that RebelMouse has a unique approach to SEO that leverages the tools available to us from the open web alongside our 
	proprietary technology that enables users to win key phrases with every publish. The best part? The platform is designed to empower the people who live closest to content: writers and editors. Here's how it works.

                Keep reading...
                Show less
            
        organic social media strategy

        The New Content Lifecycle: Build a Creator’s Universe with Discovery
    
    Become the center of the universe on your topic.

	In today's digital world, organic growth is everything. The old pay-to-play mantra adopted by many publishers is putting them at the mercy of Facebook's temperamental News Feed.

	If you want to survive the constant algorithm updates and technological changes, your focus must be on building a community that constantly sparks conversations among its audience. To do so, you have to connect with likeminded Facebook Pages and social profiles at scale, and that starts with quality content. But sometimes good content isn't enough. At RebelMouse, we have a saying: "If you create quality content without distribution, does it even exist?" That's why we created Discovery, an integral part of our suite of sophisticated enterprise-level tools. Using proprietary technology, Discovery is designed to help you figure out the social ecosystem that's already having conversations related to your content. But before you can reach out to potential influencers, your content has to be set up for distributive success.

                Keep reading...
                Show less
            
        creators

        Modern E-Commerce: Blur the Line Between Content and Design
    
    Create Modular + Reusable Design Patterns on RebelMouse

	Content saturation is an industry-wide problem, and the e-commerce space is no exception given that it's filled with big brands, small Etsy stores, and everyone in between all fighting for similar audiences. The best way to fight this symptom is to understand your audience and provide them with what they want.

                Keep reading...
                Show less
            
        instagram-style e-commerce features on rebelmouse

        Instagram-style E-commerce Features on RebelMouse
    
    Revolutionizing E-commerce on RebelMouse

	Whether you're a brand with a blog or a media company with a site, driving purchasing behavior and building an audience that uses your content to find things they love to buy is vital. We're very proud to have built out the same functionality that everyone is now used to on Instagram, with layovers on images that lead to products with attribution.

                Keep reading...
                Show less
            
        communities

        Building Premium Communities and User Journeys on RebelMouse
    
	RebelMouse is much more than just a replacement for a traditional CMS. Our platform is a tremendous community-building experience. Today's social ecosystem has given us a seemingly limitless number of premium creators who understand how to create gorgeous and relevant content that drives the growth of their own audiences. These creators and influencers are either experts in certain topics, or heavily engaged in targeted content that drives their interests. They're not only consuming the content they're passionate about, but they're contributing to the conversation, too. The new role of the editor is not just to cover the most important topics and people around their expertise, but also to 
	invite those preferred influencers into their community and get them to participate in creating premium content.
Read our deck here...

                Keep reading...
                Show less
            
        content publishing workflow

        Tools to Master the New Content Workflow
    
	Content creation has never been static. Since the early days of social, the relationship between publishers and readers has blurred and warped into what's now the state of digital publishing in 2019. At RebelMouse, we 
	started out as a social feeds aggregator and subsequently went viral as the "social front page." Since then, we've obsessed over the best ways to share content in today's social world despite its unpredictable seasons.

                Keep reading...
                Show less
            
        subscription model for publishers

        In 2020, Publishers Take Back Control With Subscription Success
    
    Users are ready to pay for content that delivers.

The Rise of the Mature User

	It's been a long and winding path, but in 2020 the subscription model continues its upward trajectory as a top revenue strategy for publishers of all sizes. The tug of war between platforms and publishers reached its peak in the last few years of the previous decade, leaving users desperate for a modern user experience that's clear of any clutter from the duopoly. This is why intelligent paywall models are a top choice for users looking to consume content right from the source. When done correctly, the strategy can work for any type of media. 
	The New York Times, a frequent showpiece example of the power of paywalls, is constantly reporting record-busting subscription numbers, including 3.5 million digital subscriptions last fall.

	And it all makes perfect sense. The subscription model eliminates the middleman — such as the platforms — so readers get the experience and content they want, and publishers get the cash they need.
RebelMouse's Subscription Features
	As a creative agency powered by modern technology, we know how to build a subscription experience that's designed for both the modern user who wants an optimized site experience and the modern publisher who relies on paywall revenue to survive.

	RebelMouse's subscription features are customizable and easily support:
Free Trials: Create one-day, weekly, or monthly subscription plans.
Coupon Codes: Use promotional codes to give access to strategic partners and complement B2B deals.
B2B Subscriptions: Use email matching to sell access to companies.
Testing Powered by Data: We have a sophisticated suite of A/B testing tools — complete with Google Analytics integrations — that give you the ability to test what works, what doesn't, and how to better cater to your readers' needs.

	RebelMouse's Paywall API is available to developers to make it easy to manage subscriptions. Access to paid content is managed via subscriptions attached to email qualifiers. 
	Click here for more information on our Paywall API.
The Success of Our Subscription Model
	Sites powered by RebelMouse are experiencing enormous success thanks to our subscription strategies, including the Italian newspaper 
	La Verità. While publishers on other platforms typically see a decrease in audience when they implement a paywall, in their first year leveraging the RebelMouse paywall strategy, La Verità saw 800% audience growth with an average of 16 pages per visitor, far above the industry standard. Their continued, unprecedented growth makes them one of the highest-growth media properties in Italy, and they've experienced significant revenue growth thanks to our paywall tools.

Is a Subscription Model Right for You?

	In the past, there was a stigma around paywalls that signaled they were only sustainable for large publishers with massive audiences already in place. But with today's users maturing, subscription models are more attainable for a variety of emerging media properties and legacy names alike.

	It's important to strike the right balance between free content, subscriber revenue, and ad strategy. This is a lot to juggle for publishers who are already maxed out trying to create quality content worth reading.

	At RebelMouse, we can help you determine if a subscription model will benefit you, and then build a custom, easy-to-use paywall system that works for your site. If you're not publishing on RebelMouse, we also operate as a world-class creative agency that can help you navigate the subscription business and any other content strategy you may be building toward. Either way, 
	request a proposal today and let's start working together.
Related Articles Around the Web

                        An AMP Paywall and Subscription Model for All Publishers – AMP ›
                    
                        If Ads Don't Work, Can Publishers Strike Subscription Gold? | WIRED ›
                    
                        Here's how this Norwegian publisher built a successful digital ... ›
                    
        creators

        Dynamic Voting: Grow Traffic and Engagement Organically
    
    Help your audience find its voice.

	Creating quality content is no longer on marketers alone. We live in a 
	universe of creators who are willing to not only consume content that resonates, but play a role in the creation, promotion, and conversations surrounding it.

	Since the start of RebelMouse, we've been on a journey to create dynamic media that is easier for content creators to curate and amplify on social. It's why we've built an online engagement platform centered around the 
	power of communities that thrive naturally in the digital ecosystem.

                Keep reading...
                Show less
            
        revenue

        How to Monetize Your Website in Today’s Publishing Environment
    
	In order to define distributive publishing, we have to ask the following question: If you have quality content, but nobody sees it, does it even exist? The answer is no, because your content needs to be supported in a way that lets it move seamlessly across all channels, especially site, search, and social. But let's take this question a step further: If you can't monetize your content to generate the support it needs, how do you create quality content in the first place?

                Keep reading...
                Show less
            
        What Makes RebelMouse Secure, Stable, Redundant, and High Performing
    
    Why massive enterprise organizations are switching to RebelMouse.

	Delivering a secure, high-performing environment with extreme reliability is essential to all of our clients at RebelMouse. We only use industry-leading, reliable approaches to host our infrastructure. This ensures maximum stability and security for all our clients' data. Here are just some of the tools and practices we leverage to maintain a hard-bodied product that's flexible, too.

                Keep reading...
                Show less
            
Build on a Better Platform 
 Request a Proposal

        rebelmouse careers

        Explore Careers at RebelMouse
    
	Join RebelMouses's modern and distributive workforce responsible for the websites of media powerhouses, including legacy brands like United Airlines and new media darlings like PAPER Magazine and Protocol.

	If you feel like you've never quite fit into boxes or labels within the tech space, we want to hear from you. Built on a foundation of site performance, our cloud-based platform reaches 50+ million people a month with an always-modern approach to product and strategy.

	Our fully remote team spans 25+ countries and has very flexible schedules. If you don't want to be confined to an office chair, and like the idea of being able to work from any place in the world you choose, we're a match.

	RebelMouse is dedicated to pursuing inclusion for all individuals, regardless of their gender identity, sexual preference, ethnicity, religion, age, or disability. We work hard to form meaningful relationships beyond our platform, and it's this passion that has formed what is now a diverse software company and creative agency that's bucking industry norms. For us, diversity is a company pillar, not just a statistic.
Click here to browse our current opportunities

        structured data

        Google’s Rich Results Test to Take Priority Over Structured Data Testing Tool
    
	Google 
	recently announced that its Rich Results Test is out of beta and now fully supports all of its rich results features.

	Powered by structured data, rich results are the dynamic snippets you see at the top of Google's search results, whether it's a carousel, image, or listicle.

An example or Google's rich results for recipes.

	The 
	Rich Results Test determines if your website's structured data is set up correctly so that your page can be eligible for rich results. With this latest update, Google will be deprecating its Structured Data Testing Tool. Here are some reasons from Google about why the prioritization of their Rich Results Test is an upgrade:

                Keep reading...
                Show less
            
        social ux layout

        Intelligent Social UX Layout: Data-Backed Site Design
    
	Today's media landscape has put publishers in a tough position. They're making less money than ever before, on top of struggling with rising costs and technical inefficiencies. Our data on over 100+ high-traffic sites gives us a unique opportunity to see what kind of websites are successful in this climate and, perhaps more importantly, what sort of sites are failing. This enables us to build optimized sites with a built-in growth strategy.

	For any website that needs help getting out of a rut, but might not have the funds to take on a complete design and strategy overhaul, our new intelligent Social UX Layout provides a unique solution. The layout combines the best of what we do in search engine optimization (SEO), design, and overall strategy into one iterable solution that achieves amazing results 
	without the high cost.

                Keep reading...
                Show less
            
        pageviews

        Trigger New Pageviews With “Keep Reading” Feature
    
	RebelMouse supports an infinite scroll feed of content that is mobile-friendly by using expandable posts. Your users can read the beginning of your article that is "before the jump," but instead of jumping to a new page, the story expands upon click to show the rest of the post. We do this with our "Keep Reading" functionality:

                Keep reading...
                Show less
            
Build on a Better Platform 
 Request a Proposal

Ready to See More?
 Request a Proposal
Subscribe to Our Newsletter

Ready to See More?
 Request a Proposal
ABOUT US

OUR TECHNOLOGY

OUR CREATIVE AGENCY

FOR CONTENT CREATORS

FOR DEVELOPERS

INSIGHTS

Our Technology

Our Creative Agency

For Content Creators

Insights

About Us

Public API v1.1 - Roar/Runner

A Next-Generation Website and Publishing Platform

The Always-Modern Platform

Blazing Fast

Multivariate Testing Built In

Proprietary SEO Tools: Win With Every Post

Proprietary Social Tools Grow Organic Reach

Proprietary E-commerce Integrations

Elegant, Efficient Workflows to Optimize Content

Native Support for Paywalls and Sign-up Walls

Build Thriving Communities

Launch Robust Contests With Voting and Submissions

An Intuitive Platform

Insightful Native Data

The Hyper-Connected, Developer-Friendly CMS

We Were Built for the Acceleration of History

We Are the Last Mile — Where Content Reaches Your Customers

The Strategic CMS and Agency

Case Studies for Every Vertical

What Do You Need to Succeed With Us?

The Intersection of Design and Development: Where Your Clients Thrive

​Stay Ahead of the Algorithms

Understand what Lighthouse 6.0 and Core Web Vitals mean for your website's future

Understanding Lighthouse 6.0

An SEO Strategy That Wins With Every Publish

Become the center of the universe on your topic.

Create Modular + Reusable Design Patterns on RebelMouse

Revolutionizing E-commerce on RebelMouse

Users are ready to pay for content that delivers.

The Rise of the Mature User

RebelMouse's Subscription Features

The Success of Our Subscription Model

Is a Subscription Model Right for You?

Help your audience find its voice.

Why massive enterprise organizations are switching to RebelMouse.

Stay Ahead of the Algorithms
