Get post ratings

GET

/api/posts/rating

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/posts/rating?user&campaign&cursor' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Post ratings retrieved successfully.",
    "data": [
        {
            "user": {
                "id": 1828764699007037400,
                "username": "obiemezi",
                "name": "ObiEmezi",
                "profile_picture": "https://pbs.twimg.com/profile_images/1830928358202327046/f5AzVT0x_normal.jpg",
                "cover_picture": "",
                "description": "",
                "location": "",
                "followers": 11,
                "following": 478,
                "favourites_count": 898,
                "statuses_count": 573,
                "media_count": 27,
                "is_verified": false,
                "is_blue_verified": false,
                "verified_type": null,
                "can_dm": true,
                "created_at": "2024-08-28T08:01:16.000000Z",
                "is_translator": false,
                "is_automated": false,
                "automated_by": null,
                "possibly_sensitive": false,
                "bio": "Gentle like the butterfly, Stings like the bee"
            },
            "id": 1931005685036135000,
            "user_id": 1828764699007037400,
            "url": "https://x.com/obiemezi/status/1931005685036134882",
            "twitter_url": "https://twitter.com/obiemezi/status/1931005685036134882",
            "text": "How to set up your Spell Wallet App 💯@spell_club https://t.co/uCgffPH66L",
            "source": "Twitter for iPhone",
            "retweet_count": 0,
            "reply_count": 0,
            "like_count": 1,
            "quote_count": 0,
            "view_count": 3,
            "bookmark_count": 1,
            "is_reply": false,
            "in_reply_to_id": null,
            "in_reply_to_user_id": null,
            "in_reply_to_username": null,
            "conversation_id": 1931005685036135000,
            "lang": "en",
            "created_at": "2025-06-06T11:10:06.000000Z",
            "alignment": "ok",
            "textual_score": "0.398",
            "engagement_score": "0.775",
            "reputation_score": "0.419",
            "behavior_score": "0.5",
            "final_score": "52",
            "campaign_id": 41
        }
    ],
    "links": {
        "first": null,
        "last": null,
        "prev": null,
        "next": "https://app.x-score.ai/api/posts/rating?cursor=eyJmaW5hbF9zY29yZSI6IjAuNTQ2IiwiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ"
    },
    "meta": {
        "path": "https://app.x-score.ai/api/posts/rating",
        "per_page": 15,
        "next_cursor": "eyJmaW5hbF9zY29yZSI6IjAuNTQ2IiwiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
        "prev_cursor": null
    }
}

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

Get post statistics

List campaigns