Subscribe to Our Newsletter

x

RebelMouse Public API v1.2

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


READ REQUESTS:

FRONT PAGE POSTS

Returns front page posts.

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

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

POSTS BY SECTION

Returns a section's posts.

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

<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 

POSTS BY AUTHOR

Returns an author's posts.

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

<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 

POSTS BY TAG

Returns posts by tag.

https://{roar_domain}/api/1.2/posts/tag?tag={tag}&exclude;_tags={exclude_tags}&limit;={limit}&offset;={offset}

<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 

POSTS' DETAILS

Returns posts details.

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

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

SITES' DETAILS

Returns sites' details.

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

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

AUTHORS' DETAILS

Return authors' details.

https://{roar_domain}/api/1.2/authors?ids={ids}&access;_token={access_token}

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

AUTHORS' DETAILS BY NAME

Return authors' details by name.

https://{roar_domain}/api/1.2/authors/name?author_names={author_names}&access;_token={access_token}

<strong>Argument Required Default Description Example</strong>author_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.2/authors/facebook?fb_ids={fb_ids}&access;_token={access_token}

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

OVERALL POSTS STATS

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 

Response:

{ "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.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 

Response:

{ "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.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 

Response:

{ "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.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 

Response:

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

You're almost there! Fill out the form below and a Rebel will contact you within one business day.

x

A Look Inside the Only Creative Agency Powered by Deep Technology

Strategic development of product that supports content distribution, conversion, and loyalty.

RebelMouse is a creative agency fueled by a publishing platform with deep technology. Our expertise is rooted in media and content marketing because there is no other team that understands distributive publishing better than we do. There is also no other CMS on the market today that provides content creators with the tools they need to unlock sustainable growth backed by sticky monetization methods. RebelMouse blends product and strategy together to move the needle where it matters most — organic traffic and user growth, conversion to loyalty, and revenue growth.

Keep reading... Show less

Why Does RebelMouse Create Growth?

Understand what your content needs to create new reach and deepen loyalty

After a shaky 2018, publishers are positioned to start the new year with less dependency on the platforms. But the chase to consistently create ROI from content is still somewhat unclear. According to Content Marketing Institute, one-third of B2C marketers and 42% of B2B marketers do not measure content growth, with many of them citing it's just not tangible enough to understand.

Keep reading... Show less

Don’t Fire Your Content Team — Arm Them With the Tools They Need

You might have heard about the recent layoffs at Mic following one unsuccessful pivot after another. The story is familiar in the modern digital media landscape, so I won't give another recap on how the mindless pursuit of digital trends ended up backfiring for another media company. Instead, I want to focus on solutions, namely, one solution that's been right under our nose for years.

Keep reading... Show less

You're almost there! Fill out the form below and a Rebel will contact you within one business day.

x

New: Easily Remove Users + Transfer Content

We subscribe to the idea that we live in a universe filled with creators. With that said, not all creators are created equal, and sometimes they move on after a while. That's why we want to make sure our site administrators have complete control over who has access to their RebelMouse pages. We've launched a new user interface within our users dashboard that allows you to efficiently remove authors from your site. And during this process, you can also reallocate posts from one user to another in bulk. Here's a look at how it all works.

Keep reading... Show less

NEW: RebelMouse Native Comments with Notifications

Content creation is never static. To build an audience, it's important to ensure that your content is not only dynamic, but sparks a conversation.

Keep reading... Show less