Tweet insights

Get tweets

Retrieve a list of tweets based on query parameters.

GET
/v2/tweets
AuthorizationBasic <token>

In: header

Query Parameters

limit?number
Default10
Range1 <= value <= 30
cursor?string
labels?array<string>
minTokenScore?number

Minimum token score (from token analytics avg_score)

maxTokenScore?number

Maximum token score (from token analytics avg_score)

minKolScore?number

Minimum KOL score (from x_user_statistic ranking_score)

maxKolScore?number

Maximum KOL score (from x_user_statistic ranking_score)

minFollowerCount?number

Minimum follower count of the account that tweeted

maxFollowerCount?number

Maximum follower count of the account that tweeted

sortField?string

Field to sort by

Default"tweetedAt"
Value in"tweetedAt" | "tokenScore" | "kolScore" | "followerCount"
sortOrder?string
Default"desc"
tweetTypes?array<string>

Filter by tweet types. Empty array [] means no filter. Single value or array accepted.

chainId?array<string>

Response Body

application/json

application/json

application/json

curl -X GET "https://api-business.nerox.ai/v2/tweets"
{
  "items": [
    {
      "id": 65917378,
      "content": "$trenches \n\nCalled in early on my private TG group at $48k Mcap \n\nContract Address EU1q1FfzCPG9QHZZQvy1fL7vmisWtBApMcaiaWsVpump",
      "twitter_id": "2009997776017621184",
      "tweeted_at": "2026-01-11T14:48:56.059Z",
      "bookmark_count": 1,
      "reply_count": 1,
      "retweet_count": 1,
      "favorite_count": 1,
      "quote_count": 1,
      "view_count": 1,
      "photo_urls": [
        "https://pbs.twimg.com/media/G-TyUoFXEAALnfQ.jpg"
      ],
      "videos": [],
      "tweet_type": "tweet",
      "original_tweet": null,
      "token": {
        "id": 244096,
        "name": "The White Pepe",
        "token_address": "HVS5knBKYJ9Xy4WCYEHCrXYJ7Noz2CWLibnMM6Sipump",
        "symbol": "WHITEPEPE",
        "icon_url": "https://cdn.nerox.ai/uploads/token-icons/j4f10irer0ezf5slwuguaadkbg4e.jpeg",
        "chain_id": "solana",
        "token_score": 28.15276496832507,
        "score": 28.15276496832507,
        "score_v2": 28.15276496832507,
        "avg_score": 28.15276496832507,
        "avg_score_v2": 2.3460637473604224,
        "change1h": 44.12,
        "change24h": 487,
        "sentiment": 2
      },
      "tokens": [
        {
          "id": 244096,
          "name": "The White Pepe",
          "token_address": "HVS5knBKYJ9Xy4WCYEHCrXYJ7Noz2CWLibnMM6Sipump",
          "symbol": "WHITEPEPE",
          "icon_url": "https://cdn.nerox.ai/uploads/token-icons/j4f10irer0ezf5slwuguaadkbg4e.jpeg",
          "chain_id": "solana",
          "token_score": 28.15276496832507,
          "score": 28.15276496832507,
          "score_v2": 28.15276496832507,
          "avg_score": 28.15276496832507,
          "avg_score_v2": 2.3460637473604224,
          "change1h": 44.12,
          "change24h": 487,
          "sentiment": 2
        }
      ],
      "x_user": [
        {
          "id": 244096,
          "name": "The White Pepe",
          "token_address": "HVS5knBKYJ9Xy4WCYEHCrXYJ7Noz2CWLibnMM6Sipump",
          "symbol": "WHITEPEPE",
          "icon_url": "https://cdn.nerox.ai/uploads/token-icons/j4f10irer0ezf5slwuguaadkbg4e.jpeg",
          "chain_id": "solana",
          "token_score": 28.15276496832507,
          "score": 28.15276496832507,
          "score_v2": 28.15276496832507,
          "avg_score": 28.15276496832507,
          "avg_score_v2": 2.3460637473604224,
          "change1h": 44.12,
          "change24h": 487,
          "sentiment": 2
        }
      ],
      "last30_min_tweet_count": 6,
      "highlights": [
        {
          "id": 2395830,
          "tweet_id": 65917378,
          "token_id": 244690,
          "highlight": "EU1q1FfzCPG9QHZZQvy1fL7vmisWtBApMcaiaWsVpump",
          "chain_id": "solana",
          "tweeted_at": "2026-01-11T14:48:56.059Z",
          "is_kol": true,
          "sentiment": 2,
          "created_at": "2026-01-11T14:48:56.059Z",
          "updated_at": "2026-01-11T14:48:56.059Z",
          "deleted_at": null
        }
      ]
    }
  ],
  "next_cursor": "eyJ0d2VldGVkQXQiOiIyMDI2LTAxLTEwVDE0OjM2OjI4LjAwMFoiLCJ0d2VldElkIjo2NTkxNzM3OH0="
}
{
  "statusCode": 400,
  "message": "Bad Request",
  "error": "Bad Request"
}
{
  "statusCode": 401,
  "message": "Unauthorized",
  "error": "Unauthorized"
}

Last updated on