How to call the new Rankur API

The new Rankur API is a RESTful web service. There are many tutorial on the web about REST (Representational State Transfer) abstraction on how to implement a client for particular service. If you are not familiar with the topic you might want to take a look at the following tutorial: www.restapitutorial.com

All calls to the interface require an API key, provided on your profile settings page. Currently the API covers the social media and web monitoring services and it is being expanded to all our modules like social media management, reporting, business dashboards and team workflow management.

 

Rate Limits

The maximum number of calls per 24h is fixed to 1000 calls for all services except the ‘New Saved Search’ service where the limit is set to 100 calls per 24h.

 

Echo Service

Echo service to test your account.

Parameters:


key
Required, contains your API key.

echo
Required, contains text to be echoed back.

Sample url request:

https://api.rankur.com/echo?key=[your API key]&echo=test

 

Get Saved Searches

Gets list of all saved searches with IDs that can later be used to retrieve results.

Parameters:


key
Required, contains your API key.

Sample url request:

https://api.rankur.com/searches?key=[your API key]

 

Get Search Results

Gets list of recent search results.

Parameters:


key
Required, contains your API key.

search_id
The ID of saved search or folder, obtained through ‘Get Saved Searches’ service.

Sample url request:

https://api.rankur.com/results?key=[your API key]&search_id=[your saved search ID]

 

New Saved Search

Creates and executes new saved search of type ‘Keyword search’.

Parameters:


key
Required, contains your API key.

name
Required, contains the name of the saved search.

query
Required, contains the search expression (value should be URL encoded).

sources
Optional, contains list of available search source. Values are one of news, images, web, forums, videos, reviews, facebook, twitter, gplus.
Sample value: [news, web, facebook]

languages
Optional, contains a list of language codes defining a language filter.
Sample value: [en, es, fr]

countries
Optional, contains a list of country codes defining a geographic filter.
Sample value: [us, ca]

excluded_domains
Optional, contains a list of excluded domain names.
Sample value: [spam.com, nonsense.com]

excluded_twitter_profiles
Optional, contains a list of excluded twitter profiles.
Sample value: [spammer_profile1, unimportant_profile1, unimportant_profile2]

Sample url request:

https://api.rankur.com/add_search?key=[your API key]&name=big%20brand&query=%22Big%20Brand%22

Delete Saved Search

Removes saved search - available to While Label (Unlimited plan) subscribers.

Parameters:


key
Required, contains your API key.

search_id
The ID of saved search or folder, obtained through ‘Get Saved Searches’ service.

Sample url request:

https://api.rankur.com/delete_search?key=[your API key]&search_id=[your saved search ID]

Get Influencer Info

Gets list of influencers with mentions - available to While Label (Unlimited plan) subscribers.

Parameters:


key
Required, contains your API key.

search_id
The ID of saved search or folder, obtained through ‘Get Saved Searches’ service.

source
Optional, contains one of available influence sources. Values are one of newsblogs, video, twitter.

Sample url request:

https://api.rankur.com/influencers?key=[your API key]&search_id=[your saved search ID]&source=twitter