GET
/user/mentions$0.0008 / callUser Mentions
Return the tweets that mention a given account, cursor-paginated. This is the canonical way to read a handle's mentions; it is a thin wrapper over a to:username search and returns the same tweet objects.
- →Equivalent to a tweet/advanced_search with query "to:username"; both return the same tweet objects.
Request
curl "https://api.twitterapis.com/user/mentions?username=twitterapis" \
-H "Authorization: Bearer $TWITTERAPIS_KEY"Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
username | string | required | Handle without the leading @ to find mentions of. Example: |
cursor | string | optional | Pagination cursor from a previous response. |
Response
| Field | Type | Description |
|---|---|---|
tweets | array<Tweet> | Tweets mentioning the username, for this page. |
has_next_page | boolean | True when more results are available; pass next_cursor to fetch them. |
next_cursor | string | Opaque cursor token for the next page. Empty string on the final page. |
status | string | Request status, "success" on a normal response. |
Example response
{
"tweets": [
{
"id": "1759555444333222111",
"text": "@twitterapis just shipped great docs.",
"author": { "id": "9921", "username": "devjane" }
}
],
"has_next_page": true,
"next_cursor": "DAABCgABF...",
"status": "success"
}Pricing for this endpoint
user/mentions costs $0.0008 per call and returns ~20 tweets, so roughly $0.04 per 1,000 tweets. No subscriptions or minimum spend.