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.

If you want to search for experts by any text query, instead of by a list of tags, then use the /search/experts endpoint.

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",
            "unique_id": "00.53",
            "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,
            "disclaimer_agreement": "2017-05-29T09:52:00.000Z"
        },
        "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",
            "unique_id": "00.52",
            "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,
            "disclaimer_agreement": "2017-01-01T13:13:00.000Z"
        },
        "score": 12,
        "details": {
            "solution_count": 1,
            "average_rating": null,
            "recommendation_count": 0
        }
    }
]