X-score
  1. Posts
X-score
  • Posts
    • Get post statistics
      GET
    • Get post ratings
      GET
  • Users
    • Check if twitter user has posts in the campaign
      GET
    • Get leaderboard twitter user statistics
      GET
    • Get a ranked X user in a campaign
      GET
  • Schemas
    • Schemas
    • Twitter Post With Scores
    • Twitter Post statistics
    • User Leaderboard Resource
    • User Rank Resource
    • Twitter User
  1. Posts

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
Query Params

Responses

🟢200OK
application/json
Successful response
Body

🟠422Unprocessable Entity
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/posts/rating?user&campaign&cursor'
Response Response Example
200 - Example 1
{
    "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": "http://admin-n8n.spell.club/api/posts/rating?cursor=eyJmaW5hbF9zY29yZSI6IjAuNTQ2IiwiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ"
    },
    "meta": {
        "path": "http://admin-n8n.spell.club/api/posts/rating",
        "per_page": 15,
        "next_cursor": "eyJmaW5hbF9zY29yZSI6IjAuNTQ2IiwiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
        "prev_cursor": null
    }
}
Modified at 2026-01-29 00:21:25
Previous
Get post statistics
Next
Check if twitter user has posts in the campaign
Built with