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 |