Experts GET resource

GET /statistics/network/experts

Get a list of users who are the top experts for the given combination of tags. The list is ordered with the highest ranking experts appearing first.

In order to prevent a possible identification of question authors (see question poser anonymity), users who are only linked with the given tags through question posing are excluded from the response.

In order to motivate why a particular user has been selected as an expert, the details includes some statistics on how the user is connected to the combination of tags, namely:

solution_count: The number of published solutions written by the user that are linked to at least one of the tags
avarage_rating: The average of all ratings on those solutions, or null if there are no ratings available.
recommendation_count: The number of times the user was recommended as an expert for a question linked to at least one of the tags. Recommendations for questions that were later deleted are also counted.

Note that the Starmind algorithm considers many more factors to decide which user is the top expert for a combination of tags. An exact explanation of how experts are ranked is currently not available through the API.

The score field (which returns an integer number between 0 and 100) is deprecated from version 2.33.0. Instead, use the details object, which contains more transparent statistics for each expert.

Parameter	Type	Default	Required	Description
`tags`	`string`	-	✓	Comma-separated list of tags (up to 4)
`limit`	`int`	10	✗	Return no more than `limit` experts

Response

[
    {
        "user": {
            "location": "London",
            "image": "http://cdn.starmind.com:8080/static/user/default.jpg",
            "firstname": "Sherlock",
            "email": "sherlock.holmes@example.com",
            "auth_type": "simple",
            "is_deleted": false,
            "is_hidden": false,
            "is_system": false,
            "country": "uk",
            "lastname": "Holmes",
            "id": 17310,
            "language": "en",
            "about": "Detective",
            "company": "Ward, Lock & Co",
            "department": "Investigations", 
            "position": "Master Detective", 
            "gender": "m",
            "first_seen": "2015-02-02T11:31:05.000Z",
            "last_seen": "2015-08-09T11:31:05.000Z",
            "customfields": { "occupation": "Detective" },
            "score_level": null,
            "score_points": null
        },
        "score": 99,
        "details": {
            "solution_count": 3,
            "average_rating": 0.8666664958000183,
            "recommendation_count": 2
        }
    },
    {
        "user":  {
            "location": "London",
            "image": "http://cdn.starmind.com:8080/static/user/default.jpg",
            "firstname": "Siger",
            "email": "siger.holmes@example.com",
            "auth_type": "simple",
            "is_deleted": false,
            "is_hidden": false,
            "is_system": false,
            "country": "uk",
            "lastname": "Holmes",
            "id": 17309,
            "language": "en",
            "about": "Father of Sherlock. Inactive",
            "company": "Ward, Lock & Co",
            "department": null, 
            "position": null, 
            "gender": "m",
            "first_seen": "2015-02-02T11:31:05.000Z",
            "last_seen": "2015-08-09T11:31:05.000Z",
            "customfields": { "occupation": "Detective" },
            "score_level": null,
            "score_points": null
        },
        "score": 12,
        "details": {
            "solution_count": 1,
            "average_rating": null,
            "recommendation_count": 0
        }
    }
]