Articles Lookup by Influencers

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

start=X

(optional)
Returns articles starting from index ‘X’. Default: 0

Example Values: 0

rows=Y

(optional)
Number of articles ‘Y’ to return. Default: 20

Example Values: 9

days=

(optional)
Number of prior days for which to return articles. Default: 30

Example Values: 1,14

Example Request

GET https://api.rightrelevance.com/v2/experts/articles/lookup?expert_ids=ggreenwald,nntaleb&days=1&access_token=PLACE_ACCESS_TOKEN

Example Response

{
    numFound: 7,
    start: 0,
    articles: [
        {
            experts: [
                {
                    twitter_id_str: "381289719",
                    twitter_followers_count: 206159,
                    id: "http://twitter.com/nntaleb",
                    twitter_listed_count: 4351,
                    twitter_screen_name: "nntaleb",
                    instance_type: "person",
                    twitter_friends_count: 583,
                    name: "NassimNicholasTaleb",
                    description: "Flaneur, with focus on probability (philosophy), probability (mathematics), probability (logic),probability (reallife), deadlifts, Lebanese wine, dead languages",
                    image_url: "http://pbs.twimg.com/profile_images/764806062545436672/chnF2k5l_normal.jpg",
                    social_reach: 206159,
                    rr_score: 24531.800000000003,
                    topic_score: "10",
                    tweet: {
                        isRetweet: "false",
                        tweetID: "891059029992144897",
                        expert: "381289719",
                        date: "Fri Jul 28 22:13:22 +0000 2017",
                        text: "Both Lister and his boss shd be in Guantanamo ",
                        favCount: "14",
                        reTweetCount: "5"
                    }
                }
            ],
            id: "fa4f359f972b2d9bfff7751fffdacdfa4b69a3a5",
            image_width: "48",
            share_count: 25,
            video_html: "",
            content_type: "video",
            url: "https://www.youtube.com/watch?v=UgzqabDYK7I",
            title: "Assessing the Trump Administration's Counterterrorism Policy",
            image_height: "48",
            image_url: "https://www.youtube.com/yts/img/pixel-vfl3z5WfW.gif",
            earliest_known_date: "2017-07-27T20:23:02Z",
            excerpt: "As President Trump took office, he inherited a counterterrorism program that was actively engaged in confronting unprecedented terrorist threats in operations across the Middle East and North Africa. Six months into his term, what are the elements of continuity or change in these policies? ...",
            source: "youtube.com"
        },
        ... (more articles) ...
    ]
}

Response Fields

Returns articles shared by the list of specified Influencers, nntaleb and ggreenwald in the example above.

numFound Total number of articles found by that influencer in our platform
articles List of articles with “expert” data, source domain, share count, content type, title, excerpt, image details, date/time etc. information
articles.experts Influencer metadata including RR topical tags with scores, Twitter user data, location, instance type, associated tweet etc. for context

Write a Reply or Comment

Your email address will not be published. Required fields are marked *