List profile mentions
List posts that mention an account, newest first. Paginate with cursor and has_more. An unknown handle returns data: null or an empty page.
5 credits / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
handle*string
Account handle with or without @, or an x.com or twitter.com profile URL.
Length
length <= 300cursor?string
cursor from the previous response. Omit for the first page and send it unchanged for later pages.
Length
length <= 2000curl -X GET "https://example.com/v1/x/profile/mentions?handle=NASA" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "posts": [ { "id": "2111016836783321517", "url": "https://x.com/usunvie/status/2111016836783321517", "text": "The 2nd Annual U.S. Space Forum is underway in Vienna!\n\n🇺🇸🚀Ambassador Griffith and @NASA leadership opened two days of conversations showcasing American excellence, innovation, and leadership in space. From NASA exploration to the strength of U.S. commercial space companies, America is setting the pace for the next era of discovery, security, and economic opportunity in space.\n@State_IO @CommerceinSpace", "lang": "en", "source": "Twitter for iPhone", "created_at": "2026-10-16T08:50:09.000Z", "like_count": 0, "reply_count": 0, "repost_count": 0, "quote_count": 0, "view_count": 71, "bookmark_count": 0, "is_reply": false, "in_reply_to_post_id": null, "in_reply_to_user_id": null, "in_reply_to_handle": null, "conversation_id": "2111016836783321517", "is_pinned": null, "author": { "id": "23946671", "handle": "usunvie", "name": "U.S. Mission to the UN (Vienna)", "description": null, "location": "Vienna, Austria", "website": null, "avatar_url": "https://pbs.twimg.com/profile_images/1387772183666102281/wBAJYHqW_normal.jpg", "banner_url": "https://pbs.twimg.com/profile_banners/23946671/1785406769", "followers_count": 17609, "following_count": 441, "posts_count": 1055, "media_count": 319, "likes_count": 6578, "is_verified": false, "is_blue_verified": true, "verified_type": "Government", "protected": null, "created_at": "2009-03-12T13:32:07.000Z", "pinned_post_ids": [], "is_automated": false }, "media": [ { "id": "2111016280169873408", "type": "photo", "url": "https://pbs.twimg.com/media/HUvWH0aXgAAWC9M.jpg", "alt_text": null, "width": 4096, "height": 2731, "duration_ms": null, "variants": null }, { "id": "2111016322393927680", "type": "photo", "url": "https://pbs.twimg.com/media/HUvWKRtXcAAxmUM.jpg", "alt_text": null, "width": 4096, "height": 2731, "duration_ms": null, "variants": null }, { "id": "2111016361669398529", "type": "photo", "url": "https://pbs.twimg.com/media/HUvWMkBXkAEzdd0.jpg", "alt_text": null, "width": 4096, "height": 2731, "duration_ms": null, "variants": null }, { "id": "2111016401406144512", "type": "photo", "url": "https://pbs.twimg.com/media/HUvWO4DWMAAI7OX.jpg", "alt_text": null, "width": 4096, "height": 2731, "duration_ms": null, "variants": null } ], "hashtags": [], "mentions": [ { "id": "11348282", "handle": "NASA", "name": "NASA" }, { "id": "475210759", "handle": "State_IO", "name": "Bureau of International Organization Affairs" }, { "id": "1136993039380074496", "handle": "CommerceinSpace", "name": "U.S. Office of Space Commerce" } ], "urls": [], "card": null, "article": null, "place": null, "quoted_post": null, "reposted_post": null }, { "id": "2111027894541803976", "url": "https://x.com/BobFlintoid/status/2111027894541803976", "text": "Great story.\nScientists have improved the predicted time of arrival of a solar storm from a 5 hour window to 30 minutes.\n\nNASA’s PUNCH Sharpens Solar Storm Forecasting in First Test https://t.co/cuNwSPriF0 via @NASA", "lang": "en", "source": "Twitter for iPhone", "created_at": "2026-10-16T09:34:05.000Z", "like_count": 0, "reply_count": 0, "repost_count": 0, "quote_count": 0, "view_count": 3, "bookmark_count": 0, "is_reply": false, "in_reply_to_post_id": null, "in_reply_to_user_id": null, "in_reply_to_handle": null, "conversation_id": "2111027894541803976", "is_pinned": null, "author": { "id": "1607823659292413956", "handle": "BobFlintoid", "name": "Bob Wright", "description": null, "location": "Flint, MI", "website": null, "avatar_url": "https://pbs.twimg.com/profile_images/1883505441503600640/SYfHekbb_normal.jpg", "banner_url": "https://pbs.twimg.com/profile_banners/1607823659292413956/1737717723", "followers_count": 3335, "following_count": 3393, "posts_count": 7421, "media_count": 861, "likes_count": 70877, "is_verified": false, "is_blue_verified": true, "verified_type": null, "protected": null, "created_at": "2022-12-27T19:40:26.000Z", "pinned_post_ids": [ "1873041813654921700" ], "is_automated": false }, "media": [], "hashtags": [], "mentions": [ { "id": "11348282", "handle": "NASA", "name": "NASA" } ], "urls": [ { "url": "https://t.co/cuNwSPriF0", "expanded_url": "https://science.nasa.gov/science-research/heliophysics/nasas-punch-sharpens-solar-storm-forecasting-in-first-test/" } ], "card": { "name": "summary_large_image", "url": "https://t.co/cuNwSPriF0", "title": "NASA’s PUNCH Sharpens Solar Storm Forecasting in First Test", "description": "Using continuous imagery from NASA’s PUNCH (Polarimeter to Unify the Corona and Heliosphere) mission, scientists predicted the near-Earth arrival of a solar eruption to within 30 minutes in an...", "image_url": "https://pbs.twimg.com/card_img/2110773724454768650/t7Q1WCGc?format=jpg&name=orig" }, "article": null, "place": null, "quoted_post": null, "reposted_post": null } ], "count": 2, "cursor": "DAADDAABCgABHUvisQpXcUcKAAIdS9ag31axrQAIAAIAAAACCAADAAAAAAgABAAAAAAKAAUdS-TwwMAnEAoABh1L5PDAv9jwCwAH", "has_more": true }}