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 response61 ms · just now · 2.8 KB · 81 lines
https://api.xrpl.to/v1/mentions/timeline
{
  "mentions": [
    {
      "tweetId": "2108392990444315013",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2109260219201032192/GWSNHp9Y_200x200.jpg",
      "authorName": "Daniel \"CEO of the XRPL\" Keller",
      "authorUsername": "daniel_wwf",
      "likes": 2,
      "media": [
        {
          "t": "p",
          "u": "https://pbs.twimg.com/media/HUKENvQXQAAuXpK.jpg"
        }
      ],
      "replies": 0,
      "retweets": 0,
      "text": "Soon. https://t.co/ozQ3afvOYh",
      "tweetCreatedAt": 1791515035000,
      "tweetUrl": "https://x.com/daniel_wwf/status/2108392990444315013",
      "views": 248
    },
    {
      "tweetId": "2108394010653958501",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2109260219201032192/GWSNHp9Y_200x200.jpg",
      "authorName": "",
      "authorUsername": "daniel_wwf",
      "likes": 5,
      "media": [],
      "replies": 0,
      "retweets": 2,
      "text": "RT @YeshuaXRPL: 🟩🟥 XRPL market heatmap · 24h\n\n16 of 36 top tokens are green today.\n🚀 Best: CSC +8.2%\n🩸 Worst: 666 -3.2%\n\nFind your bag 👇\n\n🔁…",
      "tweetCreatedAt": 1791514890000,
      "tweetUrl": "https://x.com/daniel_wwf/status/2108394010653958501",
      "views": 64
    },
    {
      "tweetId": "2108391516955619405",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2109260219201032192/GWSNHp9Y_200x200.jpg",
      "authorName": "Daniel \"CEO of the XRPL\" Keller",
      "authorUsername": "daniel_wwf",
      "likes": 0,
      "media": [],
      "replies": 1,
      "retweets": 0,
      "text": "OH MY GOD, LEADING RIPPLE ENGINEER SAYS THEY WILL FREEZE XRP!!!!\n\n/s",
      "tweetCreatedAt": 1791514684000,
      "tweetUrl": "https://x.com/daniel_wwf/status/2108391516955619405",
      "views": 374
    },
    {
      "tweetId": "2108391518906024166",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2109260219201032192/GWSNHp9Y_200x200.jpg",
      "authorName": "Daniel \"CEO of the XRPL\" Keller",
      "authorUsername": "daniel_wwf",
      "likes": 0,
      "media": [],
      "replies": 0,
      "retweets": 0,
      "text": "Litmus test....",
      "tweetCreatedAt": 1791514684000,
      "tweetUrl": "https://x.com/daniel_wwf/status/2108391518906024166",
      "views": 42
    },
    {
      "tweetId": "2108385897628483848",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2109260219201032192/GWSNHp9Y_200x200.jpg",
      "authorName": "Daniel \"CEO of the XRPL\" Keller",
      "authorUsername": "daniel_wwf",
      "likes": 9,
      "media": [],
      "replies": 1,
      "retweets": 1,
      "text": "Anyone ready to ship something cool on the $XRP Ledger straight up when Batch goes live?",
      "tweetCreatedAt": 1791513344000,
      "tweetUrl": "https://x.com/daniel_wwf/status/2108385897628483848",
      "views": 597
    }
  ],
  "count": 15445,
  "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