Article Lookup API

This API returns details for a specified article from the Right Relevance platform.
Note: Articles are generally stored for a period of 60-days.

Resource URL

GET https://api.rightrelevance.com/v2/articles/lookup?articleid=<article_id>&access_token=<token> 

Parameters

articleid=article_id

(required)
Article ID for the article for which details are being looked up.

Example Request

GET https://api.rightrelevance.com/v2/articles/lookup?articleid=ARTICLE_ID_GUID&access_token=PLACE_ACCESS_TOKEN

Example Response

{
  id: "60c4cc89fc19b5ca1f32b379c4e790ec683c26e9",
  image_width: "1200",
  content_type: "article",
  url: "http://www.nydailynews.com/news/national/man-shot-dead-minn-police-traffic-stop-article-1.2701935",
  title: "Man shot dead by Minn. police during traffic stop GRAPHIC CONTENT",
  image_height: "630",
  image_url: "http://assets.nydailynews.com/polopoly_fs/1.2701947.1467867070!/img/httpImage/image.jpg_gen/derivatives/landscape_1200/article-minnesota-12-0706.jpg",
  earliest_known_date: "2016-07-07T04:32:24Z",
  redirect_policy: "no",
  excerpt: "A woman livestreamed the heartbreaking moments after her boyfriend was shot and killed by a cop Wednesday near Minneapolis. In the Facebook video, the woman, identified by WCCO as Diamond Reynolds, claims the couple were pulled over for a busted taillight and that her boyfriend informed the police officer he was carrying a permitted firearm. “Please no, don’t let him be gone. Why?!” she yelled. The man, identified as Philando Castile, 32, slumps back in the driver’s seat of his car, blood running across his shirt. Mourners want justice for Delrawn Small, killed by off-duty cop “I told him not to reach for it,” the cop says as he continues to point his weapon into the vehicle.",
  source: "nydailynews.com",
  experts: [
    {
      id: "http://twitter.com/nydailynews",
      primary_tags: [
        "nyc media",
        ... (more tags, max 25) ...
        "sports"
      ],
      twitter_screen_name: "nydailynews",
      tweet: {
        isRetweet: "false",
        tweetID: "750918942848352256",
        expert: "9763482",
        date: "Thu Jul 07 05:06:42 +0000 2016",
        text: "UPDATE: The victim, identified by local media as Philando Castile, 32, has reportedly died ",
        favCount: "38",
        reTweetCount: "119"
      },
      name: "New York Daily News",
      description: "Breaking news, politics, entertainment and sports coverage in New York City and beyond | Snapchat: NYDailyNews | http://t.co/biVL3lO6pz",
      image_url: "http://pbs.twimg.com/profile_images/2503554916/7zazvpo8e6kof69twjte_normal.png",
      social_reach: 480995,
      rr_score: 55829.6,
      twitter_sf_count: 19324
    },
    {
      id: "http://twitter.com/shaunking",
      primary_tags: [
      "black lives matter",
      "ferguson",
      ... (more tags, max 25) ...
      "lesbian gay bisexual transgender",
      "human rights"
      ],
      twitter_screen_name: "shaunking",
      tweet: {
        isRetweet: "false",
        tweetID: "750928183961214976",
        expert: "755113",
        date: "Thu Jul 07 05:43:25 +0000 2016",
        text: "Our late night post on #PhilandoCastile who was shot & killed by police just a few hours ago #FalconHeightsShooting ",
        favCount: "118",
        reTweetCount: "237"
      },
      conversation: [
        {
          tweeter_id: "755113",
          tweeter_screen_name: "shaunking",
          replies_count: 5,
          retweet_count: 237,
          favorite_count: 118,
          tweet_text: "Our late night post on #PhilandoCastile who was shot & killed by police just a few hours ago #FalconHeightsShooting https://t.co/WXPIr61wzz",
          tweet_id: "null",
          tweet_time: "1467870205",
          conv_thread: [
            {
              tweeter_id: "2715103010",
              tweeter_screen_name: "beayahus",
              replies_count: "0",
              retweet_count: "2",
              favorite_count: "2",
              tweet_text: "@ShaunKing @NYDailyNews This is genocide, Shaun and Obama does not care!",
              tweet_time: "1467870494",
              tweet_id: "750929397264232449",
              conv_thread: [ ],
              tweeter_name: "Bea Samuel",
              id: "http://twitter.com/beayahus",
              tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/747667522305007616/RFhgsdDq_normal.jpg",
              tweeter_tags: [ ],
              tweeter_description: "Abba Yah's child, Entrepreneur. I live for truth.",
              tweeter_followers_count: 5479,
              tweeter_score: "10"
            },
            ... (more internal conversation threads) ...
            {
              tweeter_id: "13460112",
              tweeter_screen_name: "kiasuchick",
              replies_count: "1",
              retweet_count: "0",
              favorite_count: "1",
              tweet_text: "@ShaunKing @johncolucci No words. Tears.",
              tweet_time: "1467871064",
              tweet_id: "750931786419494916",
              conv_thread: [
                {
                  tweeter_id: "23033882",
                  tweeter_screen_name: "johncolucci",
                  replies_count: "1",
                  retweet_count: "0",
                  favorite_count: "0",
                  tweet_text: "@kiasuchick @ShaunKing I'm in shock. Praying for Philando and Alton and their families tonight.",
                  tweet_time: "1467871143",
                  tweet_id: "750932120831336448",
                  conv_thread: [
                    {
                      tweeter_id: "13460112",
                      tweeter_screen_name: "kiasuchick",
                      replies_count: "1",
                      retweet_count: "1",
                      favorite_count: "1",
                      tweet_text: "@johncolucci @ShaunKing Feel so powerless. What can be done to make people see this is not acceptable?",
                      tweet_time: "1467871383",
                      tweet_id: "750933125262258177",
                      conv_thread: [
                        {
                          tweeter_id: "23033882",
                          tweeter_screen_name: "johncolucci",
                          replies_count: "0",
                          retweet_count: "0",
                          favorite_count: "0",
                          tweet_text: "@kiasuchick @ShaunKing I don't know. For now, pray for their loved ones. Learn about their lives, say their names loud. Share their stories.",
                          tweet_time: "1467871729",
                          tweet_id: "750934578806726656",
                          conv_thread: [ ],
                          tweeter_name: "John Colucci",
                          id: "http://twitter.com/johncolucci",
                          tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/750939356655808512/9iNcbBAL_normal.jpg",
                          tweeter_tags: [
                            "engadget:90:66",
                            "gadget show:68:91",
                            "sxsw:68:196",
                            "digital media:67:160",
                            "phones:67:36"
                          ],
                          tweeter_description: "EWR ✈️ SFO ✈️ SEA | Director of Social Media @ Sinclair Broadcast Group | @Snapchat: johnTcolucci",
                          tweeter_followers_count: 8866,
                          tweeter_score: "10"
                        }
                      ],
                      tweeter_name: "Melanie Nichols",
                      id: "http://twitter.com/kiasuchick",
                      tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/1041447167/Screen_shot_2010-06-30_at_11.48.31_PM_normal.png",
                      tweeter_tags: [
                        "southern california:70:151",
                        "orange county ca:67:69",
                        "silicon beach:65:26",
                        "debt:64:26",
                        "los angeles ca:64:85"
                      ],
                      tweeter_description: "Half-English, Half-American. Based in LA often found in London/Manchester. USC alum. Marketing nerd. Guinea pig parent. #DepecheMode fan. Go @Reds! #GoTrojans",
                      tweeter_followers_count: 9639,
                      tweeter_score: "10"
                    }
                  ],
                  tweeter_name: "John Colucci",
                  id: "http://twitter.com/johncolucci",
                  tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/750939356655808512/9iNcbBAL_normal.jpg",
                  tweeter_tags: [
                    "engadget:90:66",
                    "gadget show:68:91",
                    "sxsw:68:196",
                    "digital media:67:160",
                    "phones:67:36"
                  ],
                  tweeter_description: "EWR ✈️ SFO ✈️ SEA | Director of Social Media @ Sinclair Broadcast Group | @Snapchat: johnTcolucci",
                  tweeter_followers_count: 8866,
                  tweeter_score: "10"
                }
              ],
              tweeter_name: "Melanie Nichols",
              id: "http://twitter.com/kiasuchick",
              tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/1041447167/Screen_shot_2010-06-30_at_11.48.31_PM_normal.png",
              tweeter_tags: [
                "southern california:70:151",
                "orange county ca:67:69",
                "silicon beach:65:26",
                "debt:64:26",
                "los angeles ca:64:85"
              ],
              tweeter_description: "Half-English, Half-American. Based in LA often found in London/Manchester. USC alum. Marketing nerd. Guinea pig parent. #DepecheMode fan. Go @Reds! #GoTrojans",
              tweeter_followers_count: 9639,
              tweeter_score: "10"
            },
            {
              tweeter_id: "2926064450",
              tweeter_screen_name: "ivyn19641",
              replies_count: "0",
              retweet_count: "0",
              favorite_count: "0",
              tweet_text: "@ShaunKing @kathleenwattle @NYDailyNews If I was AA this would scare me to take my kids to store and get shoot by racially fueled cops",
              tweet_time: "1467874939",
              tweet_id: "750948041339789312",
              conv_thread: [ ],
              tweeter_name: "Walter",
              id: "http://twitter.com/ivyn19641",
              tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/747265984503783424/0ocx5wXz_normal.jpg",
              tweeter_tags: [ ],
              tweeter_description: "Wait for the EPITAPH, this must be most selfish shit to do // by the way went INDY moment I was born",
              tweeter_followers_count: 1979,
              tweeter_score: "10"
            }
          ],
          id: "http://twitter.com/shaunking",
          tweeter_name: "Shaun King",
          tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/690138574050705408/HkB9XCu4_normal.jpg",
          tweeter_tags: [
            "black lives matter:94:1034",
            "ferguson:93:866",
            "racism:92:631",
            "social justice:91:2387",
            "bernie sanders:90:655"
          ],
          tweeter_description: "Senior Justice Writer @NYDailyNews; @Morehouse alum; Husband; Father of 5; Views expressed here are mine & mine alone; News Tips: sking@nydailynews.com",
          tweeter_followers_count: 291099,
          tweeter_score: "10"
        }
      ],
      name: "Shaun King",
      description: "Senior Justice Writer @NYDailyNews; @Morehouse alum; Husband; Father of 5; Views expressed here are mine & mine alone; News Tips: sking@nydailynews.com",
      image_url: "http://pbs.twimg.com/profile_images/690138574050705408/HkB9XCu4_normal.jpg",
      social_reach: 291099,
      rr_score: 33353.4,
      twitter_sf_count: 18809
    },
    ... (more influencers) ...
    {
      id: "http://twitter.com/mommyjenna",
      primary_tags: [
      "diapers",
      ... (more tags, max 25) ...
      "oklahoma"
      ],
      twitter_screen_name: "mommyjenna",
      name: "Jenna Goodwin",
      description: "Iowa Mom of 2 girls & identical twin boys. Living with #fibro. Social Media Mom, Brand Ambassador, Blogger. #WWEMoms Jenna@MommyJenna.com",
      image_url: "http://pbs.twimg.com/profile_images/698688035249119232/h0OF1xXt_normal.jpg",
      social_reach: 22925,
      rr_score: 2787.5,
      twitter_sf_count: 3461
    }
  ]
}

Response Fields

Returns details for the specified article.

id Article ID GUID
content_type Article type: article, video etc.
url Article URL
source Source domain from which the article was sourced
image_url Best image extracted from the article
earliest_known_date Earliest date the article was found and sourced
excerpt Article abstract
title Title of the article
experts List of influencers (max-15) who shared/RT the article. ‘Expert’ objects optionally contain embedded ‘tweet’ and ‘conversation’ objects.

Write a Reply or Comment

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