Multiple Topics Articles Lookup API

This API provides recent relevant articles for the specified multiple topics (limit 10). Unlike ‘Articles Search’, this API is a cache lookup, hence much faster but limited to articles from last 3 days. Resource URL GET http://api.rightrelevance.com/v2/topics/getarticles?topics=<topic>&start=X&rows=Y&access_token= Parameters topics=t1,t2 (required) comma-separated list of topics for which to fetch recent article Example: topics=bitcoin,blockchain,cryptocurrency start=X (optional) Returns […]

Continue reading


Articles Lookup by Domains List API

This API returns articles from a list of domains (max 10) over the last 30 days along with metadata related to the articles. It’s a paginated call. Resource URL GET https://api.rightrelevance.com/v2/domains/articles/lookup?domains=<d1.com>,<d2.com> Parameters domains=d1,..,dX (required) Lookup articles shared by a list of comma separated domains (max 10). Example Values: cnn.com, epa.gov start=X (optional) Returns articles starting […]

Continue reading


Articles Lookup by Influencers List API

This API returns articles shared by a list of Right Relevance Influencers over 30 days along with metadata related to the articles. It’s a paginated call. Resource URL GET https://api.rightrelevance.com/v2/experts/articles/lookup?expert_ids=<screen_name1>,<screen_name2> Parameters expert_ids=sn1,..,snX (required) Lookup articles shared by a list of comma separated RR Influencers (max 10) identified by twitter screen names. Example Values: pmarca, DalaiLama […]

Continue reading


Per-Topic Domains Search API

This API returns top domains for a specified topic with details for each domain that include description, image link, up to top 10 associated topics and up to top 10 associated Right Relevance influencers. The call is paginated with maximum 50 results. Resource URL GET https://api.rightrelevance.com/v2/domains/search?topic=<topic> Parameters topic=<topic> (required) query topic for searching top domains […]

Continue reading


Domains List Metadata API

This API returns Right Relevance details for a specified list of comma separated domains. Metadata including top topics and top influencers associated with each domain. Resource URL GET https://api.rightrelevance.com/v2/domains/metadata?domains=<d1,d2>&access_token= Parameters domains=d1,d2,d3 (required) list of domains for which to fetch metadata Example Values: bbc.com, amazon.com Example Request GET https://api.rightrelevance.com/v2/domains/metadata?domains=forbes.com,a16z.com&access_token=PLACE_ACCESS_TOKEN Example Response { forbes.com: { topics: [ […]

Continue reading


Autocomplete Locations API

This API provides auto-complete suggestions for structured locations (~10K) in the Right Relevance platform. It can be leveraged to build search box user experience for influencers and articles from a location. You can see it in action at http://rightrelevance.com. Resource URL GET https://api.rightrelevance.com/v2/topics/locations/autocomplete?q=<string> Parameters query=string (required) ‘string’ for which to fetch auto-complete suggestions. Example Request […]

Continue reading


StaffPicks API

This API returns hand-picked topic┬árecommendations by the┬áRight Relevance team. It’s a small but active subset of the over 50K structured topics in the platform. You can see it in action under the ‘Explore More Topics’ option at http://rightrelevance.com. Resource URL GET https://api.rightrelevance.com/v2/analytics/topics/staffpicked?access_token=<api_token> Parameters None Example Request GET https://api.rightrelevance.com/v2/analytics/topics/staffpicked?access_token=PLACE_ACCESS_TOKEN Example Response [ { category: “News & […]

Continue reading


Per Topic Follow Recommendations API

This API returns follow recommendations across Right Relevance structured topics for a given Twitter account specified by screen_name. Resource URL GET https://api.rightrelevance.com/v2/analytics/friends/recommendations?topic=machine%20learning&screen_name=<twitter_screen_name>&access_token=<api_token> Parameters screen_name=twitter_screen_name (required) Twitter screen_name to fetch followers topical distribution Example Values: datavizrr, gtaank Example Request GET https://api.rightrelevance.com/v2/analytics/friends/recommendations?topic=machine%20learning&screen_name=gtaank&access_token=PLACE_ACCESS_TOKEN Example Response { id: 128894906, screen_name: “gtaank”, name: “Gaurav Taank”, description: “Entrepreneur, DCEite, Hustler! Waiting […]

Continue reading