Reporting

Search Agents

Project Users

User Management

Tasks

Social Report API

The Social Report SDKs gets your app connected quickly and easily, so you can focus on creating an experience. Social Report exposes its data via an Application Programming Interface (API), so developers can interact in a programmatic way with the Social Report website. This document is the official reference for that functionality.

The purpose of this API is to allow anyone to build applications that interact with social networks using a unified API without having to worry about integrating with each network separately.

The current API version is 1.3Authentication

All requests have to be signed using an api key that. Simply add "api_key" request header when making all requests. For testing purposes you can also pass "api_key" as a parameter. This is not a recommended option however for obvious security reasons.

Obtain API Key

If you have an existing Social Report account you can find your API in My Account > API Access section. If you don't have an account - you can create it here.
Rate limits

Account Create

Create a new social account. Don't forget to add created account to a project.

IMPORTANT: Please note that this end point only applies to those integrators that implement oauth with each network on their end. Please work with our support team on setting this up. Your app keys for each network will have to be setup in your API account by our team.

Parameters

project: project identifier

user: user identifier

contentGroup: JSON object of id and name of content group (optional)
If id is specified, then the post will go to a specific content group. If name is specified, a new content group will be created. If the content group parameter is omitted or the id and name paramaters are not specified, a post will be scheduled with no content group.

name: publication name required but only used to publish to Blogger, LinkedIn Groups and WordPress

Authentication

which will seamlessly log the user into his or her Social Report account. Note that if you are using a white labeled domain - you can substitute www.socialreport.com with your domain. Generated tokens are only valid for 30 seconds once generated.

Parameters

user_id: user identifier

Output

[
{
"token": "0hokth7bh7rbbmravhabcam4uo27gx9cec46"
}
]

Export

All data available within Social Report can be exported. Exports are delivered in a ZIP archive containing CSV files for each metric you are exporting. If you need coding samples of how to process the results - just ask our support team. Note that export results are cached for 1 hour. Also note that you can easily test exports right from the dashboard by clicking on 'Export Data'.

Example Requests

Export top level activity stats for profile 111 (111 is a system id that you can find using API or on the dashboard by going to Settings > Profiles):
https://api.socialreport.com/export.svc?export_type=account&account=111&activity=1&api_key=*******&from=20170601&to=20170615

Export Twitter activity for profile 111 (111 is a system id that you can find using API or on the dashboard by going to Settings > Profiles), followers, and statues:
https://api.socialreport.com/export.svc?export_type=account&account=111&activity=1&followers=1&twitter_status=1&api_key=*******&from=20170601&to=20170615