Articles Lookup 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": [
        {
            "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", 
            "excerpt: "His Holiness the Dalai Lama speaks to members of the Shia and Sunni...", 
            "image_height": "", 
            "image_width": "", 
            "source": "youtube.com",
            "experts": [
                {
                    "twitter_id_str": "20609518",
                    "id": "http://twitter.com/dalailama",
                    "twitter_screen_name": "dalailama",
                    "instance_type": "person",
                    "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": {
                        "tweet_id": "false",
                        "date": "Mon Aug 01 09:30:21 +0000 2016"
                    }
                }
            ]
        }, 
        ... (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 *