Twitter Mentions API | Tweets Mentioning a User

User Mentions returns the tweets that mention a given @handle, cursor-paginated as full tweet objects. It is the canonical way to read a profile's mentions and is a thin wrapper over a to:username search, returning the same tweet objects. Each page is one $0.0008 standard read.

curl -X GET "https://example.com/user/mentions?username=twitterapis&count=20"

{  "tweets": [    {      "id": "1759555444333222111",      "text": "@twitterapis just shipped great docs.",      "author": {        "id": "9921",        "username": "devjane"      }    }  ],  "next_cursor": "DAABCgABF..."}

{  "error": "bad_request",  "message": "Missing or malformed parameter. Fix the request before retrying."}

{  "error": "unauthorized",  "message": "The API key is missing, malformed, or revoked. Check the Authorization header."}

{  "error": "insufficient_credits",  "message": "Your balance is exhausted. Top up your credits to continue."}

{  "error": "not_found",  "message": "The resource does not exist, for example a deleted tweet or a private account."}

{  "error": "rate_limited",  "message": "Too many requests. Back off and retry with exponential backoff."}

{  "error": "server_error",  "message": "Something failed on our side. Retry with backoff; if it persists, contact support."}

Pricing

Each page of mentions is one $0.0008 read. For continuous monitoring, poll on an interval and dedupe by tweet ID rather than re-reading all pages.

When to use

Use it for mention monitoring, for example tracking every tweet that mentions your product handle.

Pagination

This endpoint is cursor-paginated and returns roughly 20 records per call. Pass the next_cursor from each response back as the cursor parameter to read the next page. Stop when the records array comes back empty: follower-graph endpoints return a non-null cursor even on the final page, so the empty array is the only reliable stop signal. See Pagination for the full loop.

Related endpoints

• Advanced Tweet Search: Search tweets with Twitter's full query-operator syntax, paginated with cursors.
• User Tweets: Fetch a user's public timeline (original tweets, retweets, and their own replies).
• User Info by Username: Fetch a full profile by @handle.

FAQ

How is User Mentions related to search?

It is equivalent to an Advanced Tweet Search with the query to:username. Both return the same tweet objects, so use whichever reads cleaner.

Can I monitor mentions in near real time?

Yes. Poll on an interval, keep a high-water-mark tweet ID, and surface only net-new mentions to avoid double counting.

What does each mention row contain?

Each row is a full tweet object with author, text, timestamp, and engagement counts, so you can triage mentions without a second call.