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

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

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

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
Subscribe to Our Newsletter