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 |