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://www.rebelmouse.com/api/1.1/posts/frontpage?site_name={site_name}&limit={limit}&offset={offset}

https://www.rebelmouse.com/api/1.1/posts/frontpage?site_id={site_id}&limit={limit}&offset={offset}

Argument     Required    Default    Description                  Examplelimit        no          10         number of posts to return    1offset       no          0          number of posts to skip      10site_id      no          -          site’s id                    1site_name    no          -          site’s name                  positivemouse

{site_id} or {site_name} should be provided. {site_id} is ignored if both are passed.

POSTS BY SECTION

Returns section’s posts.

https://www.rebelmouse.com/api/1.1/posts/section?site_name={site_name}§ion_name={section}&limit={limit}&offset={offset}

https://www.rebelmouse.com/api/1.1/posts/section?site_id={site_id}§ion_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      10site_id         no          -          site’s id                    1site_name       no          -          site’s name                  positivemousesection_name    yes         -          section's url                apps

{site_id} or {site_name} should be provided. {site_id} is ignored if both are passed.

POSTS BY TAG

Returns posts by tag.

https://www.rebelmouse.com/api/1.1/posts/tag?site_name={site_name}&tag={tag}

https://www.rebelmouse.com/api/1.1/posts/tag?site_id={site_id}&tag={tag}

Argument    Required    Default    Description                  Examplelimit       no          10         number of posts to return    1offset      no          0          number of posts to skip      10site_id     no          -          site’s id                    1site_name   no          -          site’s name                  positivemousetag         yes         -          tag                          python

{site_id} or {site_name} should be provided. {site_id} is ignored if both are passed.

POSTS’ DETAILS

Returns posts’ details.

https://www.rebelmouse.com/api/1.1/posts?site_name={site_name}&ids={ids}

https://www.rebelmouse.com/api/1.1/posts?site_id={site_id}&ids={ids}

Argument     Required    Default    Description     Examplesite_id      no          -          site’s id       1site_name    no          -          site’s name     positivemouseids          yes         -          ids of posts    1,2,3

{site_id} or {site_name} should be provided. {site_id} is ignored if both are passed.

SITES’ DETAILS

Return sites' details.

https://www.rebelmouse.com/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://www.rebelmouse.com/api/1.1/authors?ids={ids}&access_token={access_token}&site_name={site_name}

https://www.rebelmouse.com/api/1.1/authors?ids={ids}&access_token={access_token}&site_id={site_id}

Argument        Required    Default    Description     Exampleids             yes         -          authors' ids    19access_token    yes         -          access token    bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6site_id         no          -          site’s id       1site_name       no          -          site’s name     positivemouse

{site_id} or {site_name} should be provided. {site_id} is ignored if both are passed.

AUTHORS’ DETAILS BY NAME

Return authors' details by name.

https://www.rebelmouse.com/api/1.1/authors/name?author_names={author_names}&access_token={access_token}&site_name={site_name}

https://www.rebelmouse.com/api/1.1/authors/name?author_names={author_names}&access_token={access_token}&site_id={site_id}

Argument        Required    Default    Description       Exampleauthor_names    yes         -          authors' names    positivemouseaccess_token    yes         -          access token      bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6site_id         no          -          site’s id         1site_name       no          -          site’s name       positivemouse

{site_id} or {site_name} should be provided. {site_id} is ignored if both are passed.

AUTHORS’ DETAILS BY FACEBOOK ID

Return authors' details by facebook ids.

https://www.rebelmouse.com/api/1.1/authors/facebook?fb_ids={fb_ids}&access_token={access_token}&site_name={site_name}

https://www.rebelmouse.com/api/1.1/authors/facebook?fb_ids={fb_ids}&access_token={access_token}&site_id={site_id}

Argument        Required    Default    Description     Examplefb_ids          yes         -          facebook ids    19323283access_token    yes         -          access token    bdQ0XiTDyR2eOsQHkCooS6CeBwgD4vAd81ux4UmTFx2qXfzeEphrCFGZuK8S5Fk6site_id         no          -          site’s id       1site_name       no          -          site’s name     positivemouse

{site_id} or {site_name} should be provided. {site_id} is ignored if both are passed.