Conversations Search API

This API returns relevant conversations from Right Relevance Influencers for a specified topic.
Note: Generally conversations are stored for a maximum of 2 weeks.

Resource URL

GET https://api.rightrelevance.com/v2/conversations/search?query=<topic>

Parameters

query=topic

(required)
Search ‘topic’ for which to fetch conversations

Example Values: bioinformatics, social media

Example Request

GET https://api.rightrelevance.com/v2/conversations/search?query=bioinformatics&access_token=PLACE_ACCESS_TOKEN

Example Response

{
  num_found: 2284,
  conversations: [
    {
      tweeter_id: "69133574",
      tweeter_screen_name: "hadleywickham",
      replies_count: 2,
      retweet_count: 30,
      favorite_count: 47,
      tweet_text: "To paraphrase @JennyBryan: teaching spreadsheet abstinence doesn't work, need to focus on harm reduction",
      tweet_id: "760833165468532736",
      tweet_time: "1470231736",
      conv_thread: [
        {
          tweeter_id: "773450",
          tweeter_screen_name: "klmr",
          replies_count: "2",
          retweet_count: "0",
          favorite_count: "1",
          tweet_text: "@hadleywickham @jennybryan @kwbroman’s data org tips are golden for this: https://t.co/lb6ElfoQ1l — but ideally we need a new entry tool.",
          tweet_time: "1470231931",
          tweet_id: "760833981562687488",
          conv_thread: [
            {
              tweeter_id: "773450",
              tweeter_screen_name: "klmr",
              replies_count: "0",
              retweet_count: "0",
              favorite_count: "0",
              tweet_text: "@hadleywickham @jennybryan @kwbroman s/entry/data entry/",
              tweet_time: "1470231963",
              tweet_id: "760834115851677696",
              conv_thread: [ ],
              tweeter_name: "λx.Konrad Rudolph",
              id: "http://twitter.com/klmr",
              tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/2617576817/4n2x4ln6fqopk944375r_normal.jpeg",
              tweeter_tags: [
                "systems biology:73:24",
                "computational biology:72:32",
                "stack overflow:71:27",
                "bioinformatics:70:79",
                "genomics:67:71"
              ],
              tweeter_description: "Postdoc in Eric Miska’s group at the Gurdon Institute, University of Cambridge. #genetics #rna #bioinformatics #code #rstats #cpp",
              tweeter_followers_count: 1163,
              tweeter_score: "70"
            },
            {
              tweeter_id: "2167059661",
              tweeter_screen_name: "jennybryan",
              replies_count: "2",
              retweet_count: "0",
              favorite_count: "3",
              tweet_text: "@klmr @hadleywickham @kwbroman I think this looks very promising https://t.co/kiagJFHiTN",
              tweet_time: "1470233386",
              tweet_id: "760840084526694400",
              conv_thread: [
                {
                  tweeter_id: "773450",
                  tweeter_screen_name: "klmr",
                  replies_count: "0",
                  retweet_count: "0",
                  favorite_count: "1",
                  tweet_text: "@jennybryan @hadleywickham @kwbroman Well with that name of course I love it. But it’s a bit *too* simple for my taste. And yet huge.",
                  tweet_time: "1470233500",
                  tweet_id: "760840561536401408",
                  conv_thread: [ ],
                  tweeter_name: "λx.Konrad Rudolph",
                  id: "http://twitter.com/klmr",
                  tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/2617576817/4n2x4ln6fqopk944375r_normal.jpeg",
                  tweeter_tags: [
                    "systems biology:73:24",
                    "computational biology:72:32",
                    "stack overflow:71:27",
                    "bioinformatics:70:79",
                    "genomics:67:71"
                  ],
                  tweeter_description: "Postdoc in Eric Miska’s group at the Gurdon Institute, University of Cambridge. #genetics #rna #bioinformatics #code #rstats #cpp",
                  tweeter_followers_count: 1163,
                  tweeter_score: "70"
                },
                {
                  tweeter_id: "12296332",
                  tweeter_screen_name: "bhive01",
                  replies_count: "0",
                  retweet_count: "0",
                  favorite_count: "0",
                  tweet_text: "@JennyBryan @klmr @hadleywickham @kwbroman I downloaded it and gave it a good run. It is solid as a CSV editor.",
                  tweet_time: "1470233522",
                  tweet_id: "760840654335246341",
                  conv_thread: [ ],
                  tweeter_name: "Brandon Hurr",
                  id: "http://twitter.com/bhive01",
                  tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/44573772/bhive01Icon_normal.jpg",
                  tweeter_tags: [
                    "r programming language:68:33"
                  ],
                  tweeter_description: "Postharvest Physiology, R, computer vision, and datavis junkie, rapid prototyping, multirotor Tweets definitely mine own.",
                  tweeter_followers_count: 292,
                  tweeter_score: "10"
                }
              ],
              tweeter_name: "Jenny Bryan",
              id: "http://twitter.com/jennybryan",
              tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/660978605606875137/s3YrJetD_normal.jpg",
              tweeter_tags: [
                "r programming language:90:180",
                "carpentry:86:60",
                "statistics:81:274",
                "data analysis:79:211",
                "machine learning:79:220"
              ],
              tweeter_description: "prof at UBC, humane #rstats, statistics, teach @STAT545, @ropensci",
              tweeter_followers_count: 5430,
              tweeter_score: "78"
            }
          ],
          tweeter_name: "λx.Konrad Rudolph",
          id: "http://twitter.com/klmr",
          tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/2617576817/4n2x4ln6fqopk944375r_normal.jpeg",
          tweeter_tags: [
            "systems biology:73:24",
            "computational biology:72:32",
            "stack overflow:71:27",
            "bioinformatics:70:79",
            "genomics:67:71"
          ],
          tweeter_description: "Postdoc in Eric Miska’s group at the Gurdon Institute, University of Cambridge. #genetics #rna #bioinformatics #code #rstats #cpp",
          tweeter_followers_count: 1163,
          tweeter_score: "70"
        },
        {
          tweeter_id: "231233414",
          tweeter_screen_name: "djcpi",
          replies_count: "0",
          retweet_count: "0",
          favorite_count: "1",
          tweet_text: "@hadleywickham @jfleck @JennyBryan don't you judge me! *hugs cascading formulas* There there, the bad men are gone",
          tweet_time: "1470233103",
          tweet_id: "760838899195404288",
          conv_thread: [ ],
          tweeter_name: "silver ball'r beats",
          id: "http://twitter.com/djcpi",
          tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/378800000337065856/75733dfee09821559ee54e2f2682d6b6_normal.jpeg",
          tweeter_tags: [
            "pinball:59:7"
          ],
          tweeter_description: "systems analyst, DJ, curator, pinballer, mother. https://t.co/t6GoOKkp90",
          tweeter_followers_count: 965,
          tweeter_score: "10"
        }
      ],
      id: "http://twitter.com/hadleywickham",
      tweeter_name: "Hadley Wickham",
      tweeter_profile_image_url: "http://pbs.twimg.com/profile_images/677589103710306304/m56O6Wgf_normal.jpg",
      tweeter_tags: [
        "r programming language:98:308",
        "probability:98:35",
        "statistics:91:694",
        "social network analysis:91:116",
        "data analysis:90:633"
      ],
      tweeter_description: "R, data, visualisation.",
      tweeter_followers_count: 30384,
      tweeter_score: "83"
    },

    ... (2283 more conversations) ...
    
  ]
}

Response Fields

Returns relevant conversations that influencers for the specified topic engaged in.

numFound

Total number of relevant conversations the Influencer engaged-in
conversations

List of relevant conversations for specified topic that Influencers engaged-in. Each conversation thread may contain recursive conv_thread objects in a tree-like structure.

Write a Reply or Comment

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