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 response55 ms · just now · 2.8 KB · 76 lines
https://api.xrpl.to/v1/mentions/timeline
{
  "mentions": [
    {
      "tweetId": "2101928260112154903",
      "authorAvatar": "https://pbs.twimg.com/profile_images/1615240596284653569/kHwX9NKS_200x200.jpg",
      "authorName": "🇳🇱 MackAttackXRP 🇳🇱",
      "authorUsername": "MackAttackXRP",
      "likes": 2,
      "media": [],
      "replies": 0,
      "retweets": 0,
      "text": "XRP Needs to Break $1.45 and $1.51 to Surge 19.7% to $1.70 https://t.co/j05b6bemEm",
      "tweetCreatedAt": 1789973723000,
      "tweetUrl": "https://x.com/MackAttackXRP/status/2101928260112154903",
      "views": 378
    },
    {
      "tweetId": "2101928057132970479",
      "authorAvatar": "https://pbs.twimg.com/profile_images/1615240596284653569/kHwX9NKS_200x200.jpg",
      "authorName": "🇳🇱 MackAttackXRP 🇳🇱",
      "authorUsername": "MackAttackXRP",
      "likes": 2,
      "media": [],
      "replies": 0,
      "retweets": 0,
      "text": "Ripple Stablecoin RLUSD Becomes Third-Fastest-Growing Stablecoin of 2026 https://t.co/tEJ1cfZyDG",
      "tweetCreatedAt": 1789973675000,
      "tweetUrl": "https://x.com/MackAttackXRP/status/2101928057132970479",
      "views": 251
    },
    {
      "tweetId": "2101927943698104392",
      "authorAvatar": "https://pbs.twimg.com/profile_images/1615240596284653569/kHwX9NKS_200x200.jpg",
      "authorName": "🇳🇱 MackAttackXRP 🇳🇱",
      "authorUsername": "MackAttackXRP",
      "likes": 1,
      "media": [],
      "replies": 0,
      "retweets": 0,
      "text": "XRP Beats Bitcoin in August With a 30% Monthly Gain https://t.co/YLG1dGUH9I",
      "tweetCreatedAt": 1789973648000,
      "tweetUrl": "https://x.com/MackAttackXRP/status/2101927943698104392",
      "views": 235
    },
    {
      "tweetId": "2101927806556913758",
      "authorAvatar": "https://pbs.twimg.com/profile_images/1615240596284653569/kHwX9NKS_200x200.jpg",
      "authorName": "🇳🇱 MackAttackXRP 🇳🇱",
      "authorUsername": "MackAttackXRP",
      "likes": 1,
      "media": [],
      "replies": 0,
      "retweets": 0,
      "text": "X Finance Bull highlights $3,300 XRP price model filed with SEC https://t.co/Ol0yCSkjoR",
      "tweetCreatedAt": 1789973615000,
      "tweetUrl": "https://x.com/MackAttackXRP/status/2101927806556913758",
      "views": 237
    },
    {
      "tweetId": "2101927260433342736",
      "authorAvatar": "https://pbs.twimg.com/profile_images/1615240596284653569/kHwX9NKS_200x200.jpg",
      "authorName": "🇳🇱 MackAttackXRP 🇳🇱",
      "authorUsername": "MackAttackXRP",
      "likes": 1,
      "media": [],
      "replies": 0,
      "retweets": 0,
      "text": "XRP Security Alert: Web3 App Wallet Users Urged to Act Now https://t.co/J2nRaNmAPM",
      "tweetCreatedAt": 1789973485000,
      "tweetUrl": "https://x.com/MackAttackXRP/status/2101927260433342736",
      "views": 314
    }
  ],
  "count": 14093,
  "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