X Mentions Monitor
GET
/v1/x/users/{handle}/mentionsMCP
x_mentions3 creditsLiveUpdated
Description
Get recent tweets that mention an X handle (@name), newest first, with author profiles and engagement. Costs 3 credits per page of about 20. Tip: to catch brand mentions without the @, use x.search with the brand name or everywhere.mentions.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
handle | path | string | yes | Handle with or without @, or a profile URL. 1-15 characters. | |
limit | query | integer | no | 20 | Max rows to return (1-100). One X page holds about 20 rows, so values above 20 still return one page. Range 1 to 100. |
cursor | query | string | no | Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048. |
- handle path, string, required
- Handle with or without @, or a profile URL. 1-15 characters.
- limit query, integer
- Max rows to return (1-100). One X page holds about 20 rows, so values above 20 still return one page. Range 1 to 100. Default
20. - cursor query, string
- Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.
Request examples
curl "https://chatterapi.com/v1/x/users/levelsio/mentions" \
-H "Authorization: Bearer $CHATTERAPI_KEY"Response
data is a list of XTweet, with page.nextCursor and page.hasMore for the next page. Fields:
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | no | Platform id. |
text | string | no | Text. |
url | string | no | Full URL on the platform. |
createdAt | string | yes | ISO 8601 UTC timestamp. |
lang | string | yes | Language code. |
likes | number | yes | Likes. |
retweets | number | yes | Retweets. |
replies | number | yes | Replies. |
quotes | number | yes | Quote tweets. |
views | number | yes | Views. |
bookmarks | number | yes | Bookmarks. |
isReply | boolean | no | Is a reply. |
inReplyToId | string | yes | Tweet this replies to. |
conversationId | string | yes | Root tweet id of the conversation. |
isRetweet | boolean | no | Is a retweet. |
quotedTweetId | string | yes | Tweet this quotes. |
author | object | no | Author profile (XUser). |
media | object[] | no | Images, video or gallery URLs, or null. |
response
{
"data": [
{
"id": "2110099793976451174",
"text": "@levelsio Nothing like firing up ~ExCuRsIoN~ and that 50 cent startup track comes “If I can’t do it, homie it can’t be done”",
"url": "https://x.com/vamatt/status/2110099793976451174",
"createdAt": "2026-10-13T20:06:09.000Z",
"lang": "en",
"likes": 0,
"retweets": 0,
"replies": 0,
"quotes": 0,
"views": 1,
"bookmarks": 0,
"isReply": true,
"inReplyToId": "2109950426590417326",
"conversationId": "2109950426590417326",
"isRetweet": false,
"quotedTweetId": null,
"author": {
"id": "2181300669",
"handle": "vamatt",
"name": "Matthew Man e/acc ⏩",
"bio": "Time is our most valuable asset. Don't underutilize the time you have. Love more, build always. Working towards AI-powered Abundance in the Far North",
"followers": 190,
"following": 836,
"tweets": null,
"verified": false,
"blueVerified": false,
"canDm": true,
"protected": null,
"location": "Tallinn, Estonia ",
"url": null,
"avatarUrl": "https://pbs.twimg.com/profile_images/378800000740699003/e8585c55dc8b53c9c50302492b48ee4f_normal.jpeg",
"createdAt": "2013-11-14T23:05:22.000Z"
},
"media": []
},
{
"id": "2110099175383916754",
"text": "@levelsio Close to dead for the notebook maybe. Not for the baker who still sends quotes as a photo.",
"url": "https://x.com/Lionheartbvs/status/2110099175383916754",
"createdAt": "2026-10-13T20:03:41.000Z",
"lang": "en",
"likes": 0,
"retweets": 0,
"replies": 0,
"quotes": 0,
"views": 2,
"bookmarks": 0,
"isReply": true,
"inReplyToId": "2109944044893966447",
"conversationId": "2109944044893966447",
"isRetweet": false,
"quotedTweetId": null,
"author": {
"id": "1758922050985402368",
"handle": "Lionheartbvs",
"name": "Barry | business Automations",
"bio": "I automate your business #SEO #Feyenoord #TRWstudent #Bikelife",
"followers": 224,
"following": 170,
"tweets": null,
"verified": false,
"blueVerified": true,
"canDm": true,
"protected": null,
"location": "Rotterdam, Nederland",
"url": null,
"avatarUrl": "https://pbs.twimg.com/profile_images/2013346515054387200/OiK8tl5E_normal.jpg",
"createdAt": "2024-02-17T18:31:32.000Z"
},
"media": []
},
{
"id": "2110098842376896562",
"text": "@levelsio They laughed at me.",
"url": "https://x.com/phil70i/status/2110098842376896562",
"createdAt": "2026-10-13T20:02:22.000Z",
"lang": "en",
"likes": 0,
"retweets": 0,
"replies": 0,
"quotes": 0,
"views": 2,
"bookmarks": 0,
"isReply": true,
"inReplyToId": "2110098750043501011",
"conversationId": "2109723310762123704",
"isRetweet": false,
"quotedTweetId": null,
"author": {
"id": "1396293804",
"handle": "phil70i",
"name": "Phil",
"bio": "https://t.co/mvYTFubHky Exactly the flight you want\nhttps://t.co/xTM5VhIvTn Analyze Everything\nhttps://t.co/pSOJmVM3H1 Best Solana exchange\nhttps://t.co/gpDoKmOUAB Best wallet messaging",
"followers": 339,
"following": 1637,
"tweets": null,
"verified": false,
"blueVerified": false,
"canDm": true,
"protected": null,
"location": "United States",
"url": null,
"avatarUrl": "https://pbs.twimg.com/profile_images/990986692478808064/d8ruOmHx_normal.jpg",
"createdAt": "2013-05-02T05:18:02.000Z"
},
"media": []
}
],
"page": {
"nextCursor": "eyJ2IjoxLCJwIjoiZ2V0eGFwaSIsImMiOiJEQUFEREFBQkNnQUJIVWlVbFRTWFlHWUtBQUlkU0pEQU9OcGhRQUFJQUFJQUFBQUNDQUFEQUFBQUFBZ0FCQUFBQUFBS0FBVWRTSlRvVE1BbkVBb0FCaDFJbE9oTXY5andDd0FIQUFBQThFVnRVRU0yZDBGQlFXWlJMMmRIU2s0d2RrZHdMMEZCUVVGQ1VXUlRTa2xtU1Vwa1VqVlNNVWxyTUV0VU1tbERia2hWYVZOS1dIWllSVUk0WkZOS1NuUlhTbVJvYzBJeFNXdFFhRzR5Y2toRlNGVnBWRzlwVmxkelpFMWtVMHBFUVU5T2NHaFJRakZKYXpObmJFZDVSazVJVldsU2IxRjJXR05ZVVdSVFNrOHpjRTVoUVUxb01VbHJWME5SVnpSQlNFaFZhVlJIYUc1aFFXUk5aRk5LUlVveVRuUlNjVUl4U1d0aE5YVnRka0ZyU0ZWcFVrRXhaV0ZuUnpCa1UwcFBVamRTZGxFd1FqRkpiRXBWTUd3eVFtMUlWV2xUY0hsellWbEtZMlJUU2xGR1RGcHdaekJvTVVsck1rZDBWekJGU3dBQSIsIm8iOjAsImgiOiI1YmJjMzlmN2RhNmYifQ",
"hasMore": true
},
"credits": {
"charged": 3,
"remaining": 24997
},
"requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
"cached": false
}Recorded live response captured 2026-10-14, truncated to 3 items. Credits and request id are illustrative.
Credits
3 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 10 minutes are served from cache.