Right Relevance (RR) API access is OAuth2 based and an access_token is required for authentication and authorization. All the APIs below can be seen in action at http://rightrelevance.com, which has been built on top of them.
Autocompletion API
This set of APIs return articles, videos & conversations for a given topic or for an influencer.
- Auto-complete Topics Supports topic auto-complete functionality for over 50K “structured” topics for searching content.
- Auto-complete Influencers Supports influencer accounts auto-complete functionality for over 2.5M topical influencers in the Right Relevance platform.
- Auto-complete Locations Supports auto-complete functionality for over 10K “structured” locations in the Right Relevance platform.
Content API
This set of APIs return articles, videos & conversations for a given topic or for an influencer.
- Articles Search Returns relevant articles for a given topic in near real-time. It’s paginated and supports both relevance and time sorting orders.
- Articles Search from a Location Returns relevant articles for a given topic from a specified RR structured location in near real-time.
- Articles Search by Influencers from a Location Returns relevant articles for a given topic from a set of RR topical Influencers from a specified RR structured location in near real-time.
- Articles Lookup by an Influencer Returns articles shared by a Right Relevance topical Influencer.
Influencers API
This set of APIs return influencers for a given topic along with influencers specific metadata.
- Influencers Search Returns top influencers for a given topic.
- Influencer Metadata Lookup Returns details like biodata, location and topics of influence with scores for a Right Relevance influencer.
Topics API
This set of APIs return metadata, articles, semantical information etc. for over 50K structured topics in the Right Relevance platform.
- Topic Metadata Returns metadata for a specified Right Relevance structured topic.
- Topics Images Returns recent images for a list of specified topics.
- Related Topics Returns related topics for a list of specified topics.
- Per-Topic Articles Lookup Returns recent relevant articles for a specified topic.
- Multiple Topics Articles Lookup Returns recent relevant articles for multiple topics.
Domains API
This set of APIs return Right Relevance metadata like top topics, top influencers etc. for over 1.5M domains from which articles are fetched monthly.
- Per-Topic Domains Search Returns top domains for a given topic.
- Domains List Metadata Returns Right Relevance specific metadata for a list of specified domains.
Analytics API
This set of APIs return Right Relevance analytics data for a given account ID.
- Recommended Topics Returns list of recommended topics for a given Twitter account.
- Staff Picked Topics Returns list of hand-picked topics with categories as suggestions.
- Topical Influence Returns per topic influence data for a given Twitter account. This maps the user’s areas/topics of influence with score.
- Followers Topical Distribution Returns followers’ distribution across Right Relevance structured topics for a given Twitter account.
- Friends Topical Distribution Returns friends’ distribution across Right Relevance structured topics for a given Twitter account. This maps the interest graph of the account/user.