Articles by an Influencer API

This API returns a set of articles shared by a Right Relevance Influencer along with metadata.

Resource URL

GET https://api.rightrelevance.com/v2/articles/search?screen_name=<screen_name>&access_token=<token> 

Parameters

screen_name=twitter_screen_name

(required)
Lookup articles shared by an Influencer specified by a Twitter screen_name.

Example Values: pmarca, DalaiLama

Example Request

GET https://api.rightrelevance.com/v2/articles/search?screen_name=DalaiLama;&access_token=PLACE_ACCESS_TOKEN

Example Response

{
    numFound: 9,
    start: 0,
    image_url: "https://img.washingtonpost.com/rf/image_1484w/2010-2019/WashingtonPost/2016/06/13/Editorial-Opinion/Images/0614_OpEd-DalaiLama_quote.jpg",
    image_width: "1484",
    image_height: "742",
    articles: [
        {
            experts: [
                {
                    twitter_followers_count: 12841439,
                    twitter_id_str: "20609518",
                    id: "http://twitter.com/dalailama",
                    twitter_screen_name: "dalailama",
                    instance_type: "person",
                    name: "Dalai Lama",
                    description: "Welcome to the official twitter page of the Office of His Holiness the 14th Dalai Lama.",
                    image_url: "http://pbs.twimg.com/profile_images/529214699041067008/fqPBAr5s_normal.jpeg",
                    social_reach: 12841439,
                    rr_score: 1358618.0000000002,
                    location: {
                        latitude: "",
                        longitude: "",
                        name: ""
                    },
                    primary_tags_scores: [
                        {
                            tag: "spirituality",
                            score: "98",
                        count: "6405"
                        },
                        {
                            tag: "philosophy",
                            score: "98",
                            count: "1620"
                        },
                        {
                            tag: "meditation",
                            score: "98",
                            count: "2423"
                        },
                        {
                            tag: "tibet",
                            score: "98",
                            count: "381"
                        },
                        {
                            tag: "free tibet",
                            score: "98",
                            count: "39"
                        }
                    ],
                    topic_score: "10",
                    tweet: {
                        isRetweet: "false",
                        tweetID: "760044990621949952",
                        expert: "20609518",
                        date: "Mon Aug 01 09:30:21 +0000 2016",
                        text: "Video of HHDL speaking to the Shia and Sunni communities at the Shia Mosque in Leh, Ladakh, India on July 27th. ",
                        favCount: "210",
                        reTweetCount: "111"
                    }
                }
            ],
            id: "52f878e419b1bb68e395114cad8601fd8b4c4fde",
            share_count: 52,
            video_html: "", content_type: "video", url: "https://www.youtube.com/watch?v=RdemALBMMuE", title: "Meeting with the Shia and Sunni Communities in Leh", image_url: "https://i.ytimg.com/vi/RdemALBMMuE/maxresdefault.jpg", earliest_known_date: "2016-07-31T22:24:34Z", redirect_policy: "no", excerpt: "His Holiness the Dalai Lama speaks to members of the Shia and Sunni...", image_height: "", image_width: "", source: "youtube.com" }, { experts: [ { twitter_followers_count: 12841439, twitter_id_str: "20609518", id: "http://twitter.com/dalailama", twitter_screen_name: "dalailama", instance_type: "person", name: "Dalai Lama", description: "Welcome to the official twitter page of the Office of His Holiness the 14th Dalai Lama.", image_url: "http://pbs.twimg.com/profile_images/529214699041067008/fqPBAr5s_normal.jpeg", social_reach: 12841439, rr_score: 1358618.0000000002, location: { latitude: "", longitude: "", name: "" }, primary_tags_scores: [ { tag: "spirituality", score: "98", count: "6405" }, { tag: "philosophy", score: "98", count: "1620" }, { tag: "meditation", score: "98", count: "2423" }, { tag: "tibet", score: "98", count: "381" }, { tag: "free tibet", score: "98", count: "39" } ], topic_score: "10", tweet: { isRetweet: "false", tweetID: "758595377536917505", expert: "20609518", date: "Thu Jul 28 09:30:06 +0000 2016", text: "Thank you from HHDL for greetings and good wishes on the occasion of his 81st birthday. ", favCount: "529", reTweetCount: "162" } } ], id: "093d2c7fcbc9945c2c3766fd1edb5815e829904f", image_width: "583", share_count: 65, content_type: "article", url: "http://dalailama.com/news/post/1425-thank-you-from-his-holiness-the-dalai-lama", title: " The Office of His Holiness The Dalai Lama", image_height: "31", image_url: "http://dalailama.com/images/public/quote.gif", earliest_known_date: "2016-07-28T09:30:06Z", redirect_policy: "yes", excerpt: "I would like to thank you for your greetings and good wishes on the occasion of my 81st birthday. What would make me happier still would be if these good wishes were transformed into a wider sense of warm-heartedness; if people acted more out of a genuine concern for each other's well being. Simply put, this means: Be of help to others if...", source: "dalailama.com" }, ... (more articles) ... ] }

Response Fields

Returns set of relevant articles shared by the specified Influencer.

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
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 *