Copyright © RebelMouse 2020

Follow Us:

Public API v1.2 - Roar/Runner

This in the current version of the API
RebelMouse Public API version 1.2 is available as of August 16th, 2016. The older version of the API (Public API version 1.1) will be deprecated on December 1st, 2016. Please make sure to switch over any and all calls to the new API by that time.



Returns frontpage posts.


<strong>Argument    Required    Default    Description                  Example</strong>limit       no          10         number of posts to return    1offset      no          0          number of posts to skip      10


Returns section's posts.


<strong>Argument        Required    Default    Description                  Example</strong>limit           no          10         number of posts to return    1offset          no          0          number of posts to skip      10section_name    yes         -          section's url                apps


Returns author's posts.


<strong>Argument       Required    Default    Description                  Example</strong>limit          no          10         number of posts to return    1offset         no          0          number of posts to skip      10author_name    yes         -          author's name                luladog


Returns posts by tag.


<strong>Argument        Required    Default    Description                               Example</strong>limit           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


Returns posts' details.


<strong>Argument    Required    Default    Description     Example</strong>ids         yes         -          ids of posts    1,2,3


Return sites' details.


<strong>Argument    Required    Default    Description    Example</strong>site_id     yes         -          site's id      1


Return authors' details.


<strong>Argument        Required    Default    Description     Example</strong>ids             yes         -          authors' ids    19access_token    yes         -          access token    bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6


Return authors' details by name.


<strong>Argument        Required    Default    Description       Example</strong>author_names    yes         -          authors' names    positivemouseaccess_token    yes         -          access token      bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6


Return authors' details by facebook ids.


<strong>Argument        Required    Default    Description     Example</strong>fb_ids          yes         -          facebook ids    19323283access_token    yes         -          access token    bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6


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

<strong>Argument        Required    Description                               Restrictions                                                                       Example</strong>order           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


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


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

<strong>Argument        Required    Description                  Restrictions                                                                       Example</strong>period          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


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


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

<strong>Argument        Required    Description                  Restrictions                                                               Example</strong>period          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


{    "status": {        "code": 0,        "messages": []    },    "data": {        "report": {            "records": [{                "post_id": 567,                "page_fans": 84872,                "page_name": "HOT 107.9",                "page_logo": "",                "page_url": "",                "post_created_at": 1456822800,                "post_likes": 5,                "post_shares": 0,                "post_comments": 0,                "post_url": ""            },            ...            ]        }    }}


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

<strong>Argument        Required    Description                  Restrictions                                                               Example</strong>period          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


{    "status": {        "code": 0,        "messages": []    },    "data": {        "report": {            "records": [{                "post_id": 234,                "account_fans": 63500,                "account_logo": "",                "account_name": "The Dodo",                "account_url: "",                "tweet_created_at" :1457654527,                "tweet_likes": 328,                "tweet_retweets": 328,                "tweet_url": ""            },            ...            ]        }    }}


Our REST API service uses a key based authorization that could be managed in your Account page. You can find your own API key in form of a 64 character string, and note that we will be able to identifies you with it, so please do not share it.

All client requests are authorized using valid API keys via an specific HTTP header or query string. Query string takes priority over HTTP header, so query string will be considered if you send both at the same time.

Sending API key via query string

In order to authorize requests using "api_key" query string, you need to send it as follows:

<HTTP-METHOD> <domain>/api/<version>/<path>?api_key=<api_key> 

Sending API key via HTTP header

In order to authorize requests using HTTP header named "X-RMAuth", you need to perform as follows:

<HTTP-METHOD> <domain>/api/<version>/<path> X-RMAuth: <api_key> 

Unauthorized requests

If you send invalid API keys, you are going to get a response with HTTP 403 Forbidden status and the following payload:

{ "status": { "code": null, "messages": ["API key is not valid"] }, "data": null }

Author API

The author API supports creating users that could be used to create drafts.

Creating authors

Creates an author and sets its role as guest editor.

POST /api/1.1/authors 


first_nameStringFirst name - Required
last_nameStringLast name - Required
emailStringUser email - Required
passwordStringUser password - Required
about_htmlStringUser biography - Optional
image_idIntegerID of the uploaded image - Optional


  • image_id can be found as id in Image API response when uploading or editing images.


{ "id": <id>, "name": "paulberry", "displayname": "Paul Berry", "about_html": "This is me", "bio": "", "photo": "https://<domain>/res/avatars/default", "fb_id": null, "profile_url": "https://<domain>/community/paulberry/" }

Drafts API

The draft API supports creating drafts that could be used to publish content on site.

Creating drafts

Creates a draft and sets current user as author by default.

POST /api/1.1/posts 


headlineStringHeadline - Required
bodyStringBody - Optional
subheadlineStringSubheadline - Optional
tagsArray of stringsTags - Optional
primary_tagStringPrimary tag - Optional
sectionsArray of stringsSections - Optional
primary_sectionStringPrimary section - Optional
og_titleStringSocial headline - Optional
og_descriptionStringSocial description - Optional
image_idIntegerID of the uploaded image - Optional
manual_image_cropsObjectCrops calculated when uploading image - Optional


  • primary_section and sections fields are eligible by title using insensitive case mode. "Home" can be passed if you want to set draft in homepage.
  • image_id can be found as id in Image API response when uploading or editing images.
  • manual_image_crops can be also found as manual_image_crops in Image API response when editing images.


The response can contain several fields, but would like to highlight some of them that were specially requested:

post_urlStringURL for the draft when is published.
draft_urlStringComposited by post_url + "?draft=1", which enables users to see draft page.
slugStringURL path from post_url.

Image API

The Image API supports uploading and editing images that could be used as splash post image, teaser, social teaser and even other features than posts such as authors creation.


Every site in RebelMouse platform has its own image crops configured, these settings are useful when a image is going to be rezised or cropped. So they are considered in every process related to images, and each resized or cropped image has usually a different purpose depending on page type.

For Axios, we have the following ratios configured:

  • 960x540
  • 480x270
  • 1200x600
  • 600x300
  • 1200x600
  • 600x300
  • 600x600
  • 700x1245

Uploading images

Upload a image sending its content as a part of HTTP request body or sending a URL as part of a JSON document.

POST /api/1.3/images


image_urlStringA image URL location - Optional


Multiple files can be also sent as part of HTTP request. They are used only if image_url is not used in HTTP request.


For a single image uploaded:

{ "is_animated_gif": false, "task_id": "c3e2a367-24cb-426f-9179-457a0e0ea9ec", "height": 511, "shortcode_id": "7229TA1498262817", "iptc": { "by-line": "", "caption/abstract": "" }, "id": <id>, "shortcode_params": { "is_animated_gif": false, "crop_info": "

For multiple images uploaded:

It takes the same schema for each image uploaded but in form of an array.

Editing images

Editing an image for creating some others with certain dimensions.

PUT /api/1.3/images/<id>


image_urlStringA image URL location - Required
manual_image_cropsObjectCrop setting for resizing image - Optional

Manual Image Crops

It depends on ratios configured per site. It must be a objects, whose keys must be the ratio codes and the values should contain the following information:

topIntegerAbsolute top coordinate
leftIntegerAbsolute left coordinate
heightIntegerAbsolute height coordinate
widthIntegerAbsolute width coordinate
imgHeightIntegerWidth of the original image
imgWidthIntegerHeight of the original image


{ "16x9": { "top": 222, "left": 0, "height": 289, "width": 512, "imgWidth": 512, "imgHeight": 511 }, "2x1": { "top": 255, "left": 0, "height": 256, "width": 512, "imgWidth": 512, "imgHeight": 511 }, "3x2": { "top": 169, "left": 0, "height": 342, "width": 512, "imgWidth": 512, "imgHeight": 511 }, "1x1": { "top": 402, "left": 0, "height": 109, "width": 109, "imgWidth": 512, "imgHeight": 511 }, "9x16": { "top": 303, "left": 0, "height": 208, "width": 117, "imgWidth": 512, "imgHeight": 511 } } 


It takes the same schema than uploading images. Only one image is permitted to edit per request.



Webhooks allows you to receive a notification to certain events from RebelMouse platform. HTTP POST requests are performed for the configured URL you provide us, these requests are formed with the following headers:

User-AgentRebelMouse/0.1 Mozilla/5.0 (compatible; Gecko/20100101 Firefox/7.0.1

Published post

You can receive a notification when a post is published, you are going to receive the following information:

post_idIntegerID of the post
post_urlStringURL for the published post

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

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

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

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

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

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

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

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

Facebook Offering Small Business Grants Program During COVID-19 Crisis

Program to provide $100 million in cash grants and ad credits for small businesses

Publishers big and small all over the globe are grappling with the financial constraints caused by the COVID-19 pandemic. Trying to find the right brand messaging in this unprecedented time is a balance that none of us have ever faced before.

We've developed a live-blog experience that's designed to maximize your potential on search. Keep your audiences up to date by the second as they turn to you for the latest news, updates, and guidance. This feature is free to government and healthcare organizations for immediate use.

In an effort to help ease the strain on publishers, Facebook has announced a Small Business Grants program for publishers. The social network is offering $100 million in cash grants and ad credits during the crisis. The offer is available for up to 30,000 eligible small businesses across 30 countries.

More information on how to apply for the program is forthcoming. Click here to learn more and sign up for updates. Check out Facebook's COVID-19 Business Resource Hub here.

Live-Blog Feature: Publish Real-Time Updates + Maximize Search Performance

Make sure your audience never misses an update

Many organizations are facing communication challenges after the recent outbreak of COVID-19. With so much information available everywhere, it is harder than ever to control the message of your own audience.

At RebelMouse, we're constantly iterating on our platform to help you make your content as relevant as possible. In the current news environment, staying on top of breaking stories using live blogs is incredibly important.

We've implemented our own version of the live-blog experience that's designed to maximize your potential on search. We power this new functionality using WebSockets, which allows for near-instant updates.

The advantage of creating a live blog using RebelMouse is that we index each live-blog update for search so that you receive SEO credit for every single update. This means if one of your live-blog updates hits on a key search phrase, it can drive a lot of traffic from search. This is superior to the traditional way of doing live updates where it was simply embedded JavaScript loading posts.

Keep reading... Show less

The RebelMouse Creative Agency

  • Built for Times of Uncertainty
    • RebelMouse has had a distributed, remote workforce for years:
      • Our team collaborates easily across time zones.
      • Leaders in the company excelled within an ethos of remote work.
      • Our growth-centric team has worked closely together for years.
      • RebelMouse is made up of 60 people in 28 countries, exempt from any risk of a centralized shutdown.
      • Iterative culture that allows us to adapt rapidly to change
      • Diversified portfolio - we have clients across every vertical and every business type. Our solution works for brands and media companies of varying sizes and any content vertical
    • We're the best in breaking news and crisis communications:
      • Our digital services agency built the version of Axios that fueled their rapid growth, making them a new media giant over the past three years.
      • United Airlines uses RebelMouse's agency and tech services to power their content hub and communicate with customers.
      • We're the agency behind La Verità, a subscription-based news site in Milan, Italy that has been at the center of the COVID-19 crisis.
    • We build products designed for a mobile, office-less world:
      • Editors, writers, reporters, and creators can keep up with breaking news and vital edits, and can create content all on their mobile device.
      • In times of crisis, being fast to respond is critical. Solutions that require a desktop environment to create and edit content are no longer appropriate.
    • We don't require any new capital:
      • Our business can elegantly move up and down like an accordion to fit in the current publishing climate.
      • RebelMouse has not required capital for over three years, and is in a strong cash position to survive hard economic times.
    • "No business travel" has been our company policy for many years:
      • It's our policy to avoid business travel if possible. We haven't required a single in-person meeting to close a new deal or launch a new property in years.
      • We know how to work with clients through technology to understand each other and deliver what's needed for success.
      • Our unique work culture makes us very resilient in times where business travel is shut down.
  • Lower-Cost Products With Bigger Returns
    • We build best-in-class digital experiences:
      • The RebelMouse CMS will outperform any platform on page speed, stability, and breadth of features.
      • We power massively popular websites and scale without breaking a sweat.
      • Our CEO is a technical, product-focused person who built HuffPost. The team she's built at RebelMouse since 2012 is passionate about products that outperform.
  • Digital Growth Specialists
    • RebelMouse + Media companies:
      • We grow RPMs.
      • We improve ad visibility.
      • We create new opportunities for digital revenue.
        • Paywalls
        • E-commerce
        • Native advertising
        • Programmatic advertising
    • RebelMouse + Brands:
      • Our digital agency helps brands reach potential customers at scale by winning in search and social.
      • We put in better conversion units and the data systems to track iterations on the metrics that matter.
      • RebelMouse technology builds smarter, faster pages that convert better for paid campaigns.

Learn more about the team at RebelMouse.

No More Website Updates: Publish Like It’s the 2020s

These are the next-gen updates you need to stay ahead of the competition

Content creation is still the most powerful engine that propels every publisher forward. But in 2020 and beyond, quality content won't sustain a site on its own. The modern content lifecycle hinges on a number of things working together in unison — including page speed, intelligent SEO, and effective distribution, just to name a few.

However, there's one thing that can throw a wrench in the entire system, and that's platform updates. Whether you're publishing on a common CMS solution like WordPress, using a custom in-house CMS, have access to a dedicated team of developers, or any option in between, platform updates can be both costly and frustrating.

Keep reading... Show less
Subscribe to Our Newsletter