Get leaderboard twitter user statistics

GET

/api/users/leaderboard

Returns a list of analyzed tweets within the selected campaign. Each tweet is accompanied by metadata, engagement metrics (likes, retweets, etc.), and automated scoring results (alignment, engagement, reputation, etc.).

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200OK

application/json

Successful response

Body

🟠401Unauthorized

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/api/users/leaderboard?campaign' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Leaderboard retrieved successfully.",
    "data": [
        {
            "id": 1574131381940200000,
            "username": "michaelolamipo4",
            "name": "michael olamiposi",
            "profile_picture": "https://pbs.twimg.com/profile_images/1574131739399684098/KAynw3f9_normal.jpg",
            "followers": 20,
            "is_verified": false,
            "is_blue_verified": false,
            "final_score": "53",
            "tweets_count": 1,
            "retweet_count": 0,
            "reply_count": 0,
            "like_count": 1,
            "quote_count": 0,
            "view_count": 1,
            "bookmark_count": 0,
            "rank": 1
        }
    ],
    "links": {
        "first": "https://app.x-score.ai/api/users/leaderboard?page=1",
        "last": null,
        "prev": "https://app.x-score.ai/api/users/leaderboard?page=1",
        "next": "https://app.x-score.ai/api/users/leaderboard?page=3"
    },
    "meta": {
        "current_page": 2,
        "current_page_url": "https://app.x-score.ai/api/users/leaderboard?page=2",
        "from": 21,
        "path": "https://app.x-score.ai/api/users/leaderboard",
        "per_page": 20,
        "to": 40
    }
}

Modified at 2026-02-10 16:32:00

Get a ranked X user in a campaign

Get post statistics