The API access is OAuth2 based and an access_token from Right Relevance is required for authentication and authorization.

  1. Articles API

    This API returns relevant articles for a given topic in near real-time. It’s paginated and supports both relevance and time sorting orders.

    Signature: http://api.rightrelevance.com/v2/articles/search?query=<topic>&start=<X>&rows=<Y>&access_token=<access_token>
    Parameters:
    1. query=topic: Query topic for articles. Best results for topics from auto-complete list but free-form is supported.
    2. start=X: Starting index for articles. Default-0
    3. rows=Y: Number of articles to return. Default-10
    4. rgroup=[small|large]: Fields to return. 'large' leads to all data including abstract, related tweets and conversations being returned. Default-small
    5. content_type=[all|video]: Type of articles, all or video-only. Default-all
    6. orderby=[time|relevance]: Order in which the articles are received. Default-relevance
    Example: http://api.rightrelevance.com/v2/articles/search?query=angularjs&access_token=<access_token>
  2. Influencers API

    This API provides the list of ranked and scored Right Relevance influencers for a topic. Best results are for structured Right Relevance topics in the auto-complete dropdown. Works for free-form terms too but YMMV wrt to relevance.

    Signature: http://api.rightrelevance.com/v2/experts/search?query=<rr_topic>&start=X&rows=Y&access_token=<access_token>
    Parameters:
    1. query=topic: Query topic for influencers. Best results for topics from auto-complete list but free-form is supported.
    2. start=X: Starting index for Influencers. Default-0
    3. rows=Y: Number of influencers to return. Default-10

    Note: We’ve stripped the location and instance_type params but those are available on request based on requirements.

    Example: http://api.rightrelevance.com/v2/experts/search?query=electric%20utilities&access_token=<access_token>
  3. Conversations API

    This API is unique to RightRelevance. We aggregate and provide influencers conversations in an Outlook-conversation like tree topology. As an example please check the conversations view for venture capital

    Signature: http://api.rightrelevance.com/v2/conversations/search?query=<rr_topic>&page=X&rows=Y&order_by=_order_by_&access_token=<access_token>
    Parameters:
    1. query=topic: Query topic for conversations. Best results for topics from auto-complete list but free-form is supported.
    2. page=X: Starting index for conversations. Default-0
    3. rows=Y: Number of conversations to return. Default-10
    4. orderby=[time|relevance]: Order in which the conversations are received. Default-relevance
    Example: http://api.rightrelevance.com/v2/conversations/search?query=big+data&page=0&rows=2&access_token=<access_token>
  4. Autocomplete API

    This API supports auto-complete functionality for a search box experience in your application. You can see it in action at rightrelevance.com

    Signature: http://api.rightrelevance.com/v2/topics/autocomplete?q=<string>&access_token=<access_token>
    Parameters:
    1. q=string: Any string for which suggested topics are needed.
    Example: http://api.rightrelevance.com/v2/topics/autocomplete?q=big+da&access_token=<access_token>


Other APIs

There are other APIs that provide topic recommendations, staff picks etc. functionality that may be provided on a per case basis, based on requirements.

We’re looking to open up our Analytics API. These provide analytics, primarily for Twitter accounts, including topical influence, followers analysis across topics, locations, demographics and following analysis across topics, locations along with follow recommendations.

Please contact social@rightrelevance.com for more details.