Influencers Search API

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_followers_count: 550739,
            twitter_id_str: "1000591",
            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",
            twitter_friends_count: 1069,
            name: "Fred Wilson",
            description: "I am a VC",
            image_url: "http://pbs.twimg.com/profile_images/3580641456/82c873940343750638b7caa04b4652fe_normal.jpeg",
            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"
                }
            ],
            topic_score: "98"
        },
        {
            twitter_followers_count: 560222,
            twitter_id_str: "5943622",
            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",
            twitter_friends_count: 7875,
            name: "Marc Andreessen",
            description: "“I don’t mean you’re all going to be happy. You’ll be unhappy – but in new, exciting and important ways.” – Edwin Land",
            image_url: "http://pbs.twimg.com/profile_images/649108987128868864/rWnwMe55_normal.jpg",
            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"
                }
            ],
            topic_score: "97"
        },
        ... (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
            }
        ],
        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
            }
        ],
        instance_type_json: [
            {
                type: "person",
                count: 3284
            },
            {
                type: "organisation",
                count: 674
            }
        ]
    }
}                         

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

Write a Reply or Comment

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