GET /mentions/timeline
GET

/v1/mentions/timeline

Full timeline of tracked influencer tweets (not just token matches)

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/mentions/timeline
Query parameterValueDescription
limitint (max 100, default 50)
offsetint
period1d|7d|30d|90d|all (default 30d)
authorstring
sortrecent|engagement|views|likes
curl 'https://api.xrpl.to/v1/mentions/timeline'

Response

200Example response21 ms · just now · 2.6 KB · 76 lines
https://api.xrpl.to/v1/mentions/timeline
{
  "mentions": [
    {
      "tweetId": "2111222925818814652",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2056927318367444993/a1DPveQN_200x200.jpg",
      "authorName": "🚜 Farmer’s Union $FARM",
      "authorUsername": "FarmerUnionXRPL",
      "likes": 24,
      "media": [],
      "replies": 32,
      "retweets": 20,
      "text": "https://t.co/eAcgJbl0ML",
      "tweetCreatedAt": 1792189744000,
      "tweetUrl": "https://x.com/FarmerUnionXRPL/status/2111222925818814652",
      "views": 393
    },
    {
      "tweetId": "2111157241931788643",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2056927318367444993/a1DPveQN_200x200.jpg",
      "authorName": "",
      "authorUsername": "FarmerUnionXRPL",
      "likes": 5,
      "media": [],
      "replies": 1,
      "retweets": 2,
      "text": "RT @raffi14158: @nile_xrp @syn3rgy_artlab @LuckyHashWin @daniel_wwf @FarmerUnionXRPL 💯  was such a unique experience and equally as addicti…",
      "tweetCreatedAt": 1792173237000,
      "tweetUrl": "https://x.com/FarmerUnionXRPL/status/2111157241931788643",
      "views": 97
    },
    {
      "tweetId": "2111153632196620709",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2056927318367444993/a1DPveQN_200x200.jpg",
      "authorName": "",
      "authorUsername": "FarmerUnionXRPL",
      "likes": 15,
      "media": [],
      "replies": 6,
      "retweets": 13,
      "text": "RT @FarmerUnionXRPL: https://t.co/34hSl946L1",
      "tweetCreatedAt": 1792173044000,
      "tweetUrl": "https://x.com/FarmerUnionXRPL/status/2111153632196620709",
      "views": 473
    },
    {
      "tweetId": "2111152878375088539",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2056927318367444993/a1DPveQN_200x200.jpg",
      "authorName": "🚜 Farmer’s Union $FARM",
      "authorUsername": "FarmerUnionXRPL",
      "likes": 15,
      "media": [],
      "replies": 6,
      "retweets": 13,
      "text": "https://t.co/34hSl946L1",
      "tweetCreatedAt": 1792173044000,
      "tweetUrl": "https://x.com/FarmerUnionXRPL/status/2111152878375088539",
      "views": 473
    },
    {
      "tweetId": "2111126323943051268",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2056927318367444993/a1DPveQN_200x200.jpg",
      "authorName": "🚜 Farmer’s Union $FARM",
      "authorUsername": "FarmerUnionXRPL",
      "likes": 11,
      "media": [],
      "replies": 0,
      "retweets": 8,
      "text": "https://t.co/RCQs2BSNZO",
      "tweetCreatedAt": 1792166713000,
      "tweetUrl": "https://x.com/FarmerUnionXRPL/status/2111126323943051268",
      "views": 216
    }
  ],
  "count": 12958,
  "period": "30d"
}

Long arrays and strings are shortened in the example; Send request for the full answer.

Shapeas documented
{ mentions[], count, period }

What it does

Full timeline of tracked influencer tweets (not just token matches)

Each token comes back with its md5, the id every Token endpoint takes. Go to Token →
OpenAPI