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 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/domains/articles/lookup?domains=bbc.com,nasa.gov&access_token=PLACE_ACCESS_TOKEN
Example Response
{
numFound: 5594,
start: 0,
articles: [
{
experts: [
{
twitter_id_str: "607946179",
twitter_followers_count: 32910,
id: "http://twitter.com/lotteleicht1",
twitter_listed_count: 931,
twitter_sf_count: 4419,
twitter_screen_name: "lotteleicht1",
twitter_friends_count: 8045,
name: "Lotte Leicht",
description: "EU Director, Human Rights Watch. Tweets about human rights, IHL, Int'l law & politics. Passionate skier. Favorite place: where the view has no end!",
image_url: "http://pbs.twimg.com/profile_images/472065500613079040/lc1VyrFU_normal.jpeg",
social_reach: 32910,
rr_score: 4128.9,
topic_score: "10",
tweet: {
isRetweet: "false",
tweetID: "894248887397093376",
expert: "607946179",
date: "Sun Aug 06 17:28:43 +0000 2017",
text: "Insurgents have killed at least 40 people, including women and children, in northern #Afghanistan, officials say. ",
favCount: "0",
reTweetCount: "0"
}
}
],
id: "55f9d7621a6f448d56d7e06e43e34c936fcde682",
image_width: "1024",
share_count: 2,
content_type: "article",
url: "http://www.bbc.com/news/world-asia-40845361?ns_campaign=bbc_news_asia&ns_linkname=news_central&ns_mchannel=social&ns_source=twitter",
title: "Afghan conflict: Dozens killed in 'brutal' Sar-e Pul attack - BBC News",
image_height: "576",
image_url: "https://ichef.bbci.co.uk/news/1024/cpsprodpb/4AA9/production/_97231191_2017_08_afghan_sar.png",
earliest_known_date: "2017-08-06T17:28:43Z",
related_concepts: [ ],
excerpt: "Insurgents have killed at least 40 people, including women and children, in northern Afghanistan, officials say..."
},
... (more articles) ...
]
}
Response Fields
Returns set of relevant articles shared by the specified Influencer.
| numFound | Total number of articles found from specified domains 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 |