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 response22 ms · just now · 3.2 KB · 81 lines
https://api.xrpl.to/v1/mentions/timeline
{
  "mentions": [
    {
      "tweetId": "2116774831891136854",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2077570632699858944/cGczo6ev_200x200.jpg",
      "authorName": "🌷 Mel P 🌷",
      "authorUsername": "MelP808",
      "likes": 3,
      "media": [],
      "replies": 0,
      "retweets": 0,
      "text": "Black-tober that also hack-tober had passed. \nWelcome to Nov-alert-ber, where the headlines never sleep.",
      "tweetCreatedAt": 1793513422000,
      "tweetUrl": "https://x.com/MelP808/status/2116774831891136854",
      "views": 180
    },
    {
      "tweetId": "2116750983401271699",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2072141258861228032/M_8sF2rS_200x200.jpg",
      "authorName": "King Solomon (Ryan Solomon)",
      "authorUsername": "IOV_OWL",
      "likes": 271,
      "media": [
        {
          "t": "p",
          "u": "https://pbs.twimg.com/media/HWA1zNJXUAAFyW4.jpg"
        }
      ],
      "replies": 35,
      "retweets": 10,
      "text": "Tonight, I found my son on the verge of tears. He told me he wasn’t going to a Halloween party because his friends were just going to drink and smoke.\n\nSo we all decided to go to the amusement park as a family. When I was still drinking, I wouldn’t have handled this the same way. I probably would have brushed aside his pain or told him to get over it.\n\nSobriety has changed the way I show up in lif…",
      "tweetCreatedAt": 1793507736000,
      "tweetUrl": "https://x.com/IOV_OWL/status/2116750983401271699",
      "views": 6152
    },
    {
      "tweetId": "2116765553746391397",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2048450729728454656/_YkT5Zne_200x200.jpg",
      "authorName": "",
      "authorUsername": "DigPerspectives",
      "likes": 0,
      "media": [],
      "replies": 0,
      "retweets": 203,
      "text": "RT @WatcherGuru: JUST IN: Binance to resume withdrawals in phases within the next few hours for the first time following $6.3 billion hack.",
      "tweetCreatedAt": 1793507081000,
      "tweetUrl": "https://x.com/DigPerspectives/status/2116765553746391397",
      "views": 646
    },
    {
      "tweetId": "2116745731788640394",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2048450729728454656/_YkT5Zne_200x200.jpg",
      "authorName": "",
      "authorUsername": "DigPerspectives",
      "likes": 0,
      "media": [],
      "replies": 0,
      "retweets": 22,
      "text": "RT @Xaif_Crypto: 1 BILLION XRP released from escrow.\n\nTwo separate 500 million XRP escrow transactions were executed on the XRP Ledger, bot…",
      "tweetCreatedAt": 1793505898000,
      "tweetUrl": "https://x.com/DigPerspectives/status/2116745731788640394",
      "views": 1123
    },
    {
      "tweetId": "2116742617396633646",
      "authorAvatar": "https://pbs.twimg.com/profile_images/2077570632699858944/cGczo6ev_200x200.jpg",
      "authorName": "🌷 Mel P 🌷",
      "authorUsername": "MelP808",
      "likes": 10,
      "media": [],
      "replies": 0,
      "retweets": 0,
      "text": "Me:\nHappy Halloween ❌\nHallowed Be The Light ✅",
      "tweetCreatedAt": 1793505741000,
      "tweetUrl": "https://x.com/MelP808/status/2116742617396633646",
      "views": 280
    }
  ],
  "count": 13290,
  "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