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 […]
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 […]
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 […]
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 […]
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: [ […]
Articles by Influencers from a Location API
This API returns relevant articles for a given topic from a set of Right Relevance topical Influencers from a specified location in near real-time. Right Relevance platform supports over 2.5M influencers and 10K structured locations in the form “city, state” for the US & Canada and “city, country” for rest of the world. It’s paginated […]
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 […]
Articles Search from a Location API
This API returns relevant articles for a given topic from a specified location in near real-time. Right Relevance platform supports over 10K structured locations in the form “city, state” for the US & Canada and “city, country” for rest of the world. It’s paginated with articles provided in time sorted oder. Note: Generally articles are […]
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 & […]
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 […]