This API returns a list of ranked and scored Right Relevance influencers for a given topic along with relevant metadata. The call is paginated.
Resource URL
GET https://api.rightrelevance.com/v2/experts/search?query=<topic>&start=X&rows=Y&min_score=MIN&max_score=MAX&access_token=<token>
Parameters
query=topic
(required)
|
Search ‘topic’ (e.g. hadoop) to fetch influencers
Example Values: marketing, social media |
start=X
(optional)
|
Returns influencers starting from specified index ‘X’
Example Values: 0 |
rows=Y
(optional)
|
Number of influencers ‘Y’ to return. Default: 20
Example Values: 10 |
min_score=MIN
(optional)
|
Returns influencers with topic score greater than equal to ‘MIN’
Example Values: 60 |
max_score=MAX
(optional)
|
Returns influencers with topic score less than equal to ‘MAX’
Example Values: 98 |
Example Request
GET https://api.rightrelevance.com/v2/experts/search?query=venture capital&start=0&rows=5&min_score=88&max_score=99&access_token=PLACE_ACCESS_TOKEN
Example Response
{ numFound: "36", maxScore: "98", minScore: "64", results: [ { twitter_id_str: "1000591", topic_score: "98", id: "http://twitter.com/fredwilson", twitter_screen_name_cs: "fredwilson", twitter_screen_name: "fredwilson", rr_location: "New York, NY", rr_location_country: "USA", instance_type: "person", name: "Fred Wilson", location: { latitude: 40.7127837, longitude: -74.0059413, name: "New York, NY" }, primary_tags_scores: [ { tag: "venture capital", score: "98", count: "8785" }, { tag: "angel investing", score: "98", count: "2314" }, { tag: "founders", score: "98", count: "8795" }, { tag: "software as a service", score: "98", count: "1633" }, { tag: "financial innovation", score: "98", count: "3938" } ] }, { twitter_id_str: "5943622", topic_score: "97", id: "http://twitter.com/pmarca", rr_location: "Menlo Park, CA", twitter_screen_name_cs: "pmarca", twitter_screen_name: "pmarca", rr_location_country: "USA", instance_type: "person", name: "Marc Andreessen", location: { latitude: 37.4529598, longitude: -122.1817252, name: "Menlo Park, CA" }, primary_tags_scores: [ { tag: "andreessen horowitz", score: "98", count: "205" }, { tag: "founders", score: "97", count: "8467" }, { tag: "venture capital", score: "97", count: "7928" }, { tag: "bitcoin", score: "97", count: "2036" }, { tag: "financial innovation", score: "97", count: "3787" } ] }, ... (3 more) ... ], facets: { related_topics: [ { tag: "founders", count: 2652 }, { tag: "financial innovation", count: 2263 }, { tag: "startups", count: 2249 }, { tag: "seed accelerators", count: 2013 }, { tag: "investing", count: 1876 }, { tag: "business incubators", count: 1693 }, { tag: "angel investing", count: 1272 }, { tag: "entrepreneurship", count: 1261 }, { tag: "silicon valley", count: 1245 }, { tag: "enterprise software", count: 1099 }, { tag: "crowdfunding", count: 1099 }, { tag: "fintech", count: 920 }, { tag: "private equity", count: 847 }, { tag: "technology news", count: 817 }, { tag: "technology", count: 763 } ], instance_type_json: [ { type: "person", count: 3284 }, { type: "organisation", count: 674 } ], locations: [ { location: "San Francisco, CA", count: 730, lat: 37.7749295, lng: -122.4194155 }, { location: "New York, NY", count: 493, lat: 40.7127837, lng: -74.0059413 }, { location: "London, UK", count: 318, lat: 51.5073509, lng: -0.1277583 }, { location: "Boston, MA", count: 140, lat: 42.3600825, lng: -71.0588801 }, { location: "Palo Alto, CA", count: 128, lat: 37.4418834, lng: -122.1430195 }, { location: "Paris, France", count: 70, lat: 48.856614, lng: 2.3522219 }, { location: "Chicago, IL", count: 69, lat: 41.8781136, lng: -87.6297982 }, { location: "Los Angeles, CA", count: 69, lat: 34.0522342, lng: -118.2436849 }, { location: "Berlin, Germany", count: 67, lat: 52.5200066, lng: 13.404954 }, { location: "Washington, D.C.", count: 58, lat: 38.9071923, lng: -77.0368707 }, { location: "Seattle, WA", count: 56, lat: 47.6062095, lng: -122.3320708 }, { location: "Toronto, ON", count: 56, lat: 43.653226, lng: -79.3831843 }, { location: "Austin, TX", count: 44, lat: 30.267153, lng: -97.7430608 }, { location: "Menlo Park, CA", count: 44, lat: 37.4529598, lng: -122.1817252 }, { location: "Boulder, CO", count: 38, lat: 40.0149856, lng: -105.2705456 } ] } }
Response Fields
Returns influencers for the topic ‘venture capital’ between scores 92 and 98. Maximum 5 (rows=5). Most fields are self-explanatory.
results | List of influencers with score in searched topic, other scored topic tags, location, Twitter data etc. |
facets | 3 kinds of facets returned: instance type, related topics & locations |