/v1/mentions/timeline
Full timeline of tracked influencer tweets (not just token matches)
Request
https://api.xrpl.to/v1/mentions/timeline| Query parameter | Value | Description |
|---|---|---|
| limit | int (max 100, default 50) | |
| offset | int | |
| period | 1d|7d|30d|90d|all (default 30d) | |
| author | string | |
| sort | recent|engagement|views|likes |
curl 'https://api.xrpl.to/v1/mentions/timeline'
Response
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.
{ mentions[], count, period }
What it does
Full timeline of tracked influencer tweets (not just token matches)