This is the first post of a series on how to use Socialmetrix Quantum as datasource, which enables you to create custom dashboards or ingest social data into your internal systems empowering your big data initiatives.
To get started, we will login into your Quantum account and get the API authentication token. Don’t have an account yet? Get a free trial!
All methods in the API need to be authenticated with Json Web Token (JWT), in order to obtain your JWT you need to:
- Get your API Secret
- Submit a request to
/loginwith your API Secret
- Read the response and store your JWT for less than 20 days
Getting your API Secret
1- Login at Socialmetrix Quantum using Facebook or Twitter.
2- After logging-in, go to My Account:
3- Click on My Account:
4- Select option API and copy your API Secret:
IMPORTANT: Please do not expose your API Secret - if an attacker have control of your API Secret, he/she will be able to delete all your accounts. Keep it safe!
Getting your Json Web Token
POST a json containing the
method (“API-SECRET”) and your
secret. As show below:
1 2 3 4 5 6
If everything is OK, the response contains two important fields that will be used on subsequent requests
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
IMPORTANT: API Secret has an expire of 20 days, you MUST re-authorize at least one time within this period
Requesting your current projects
One of the first requests you probably will do is get a list of all your active projects.
The endpoint to access is:
A sample request is:
1 2 3
That’s all! Next time, we will get more information to understand specific aspects from the social profiles.
KEEP READING: Accessing campaign metrics on Socialmetrix Quantum