toolzerhub API Docs

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
GET
/v1/x/profile/mentions

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.

Lengthlength <= 300
cursor?string

cursor from the previous response. Omit for the first page and send it unchanged for later pages.

Lengthlength <= 2000
curl -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  }}