Articles Lookup by Domains

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

Write a Reply or Comment

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