Skip to main content
GET
/
x
/
users
/
{id}
/
mentions
Get user mentions
curl --request GET \
  --url https://xquik.com/api/v1/x/users/{id}/mentions \
  --header 'x-api-key: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.xquik.com/llms.txt

Use this file to discover all available pages before exploring further.

Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page or ID list, Xquik returns fewer results. If zero paid results are affordable, it returns 402 insufficient_credits.
1 credit per tweet returned · All plans from $0.00012/credit
curl "https://xquik.com/api/v1/x/users/44196397/mentions" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq
The Node.js and Python snippets write one JSON Lines row per mentioned tweet. Persist each row with the latest next_cursor before requesting the next page.

​
Direct mention handoff

Use GET /x/users/{id}/mentions when a support, community, brand monitoring, lead routing, or agent workflow needs the newest tweets mentioning one account. It returns one JSON page at a time. Use mentions when you need a saved extraction, estimate, or CSV/JSON/XLSX file export. Store mentioned_user, tweet_id, text, tweet_url, author_id, author_username, author_name, author_followers, author_verified, author_profile_picture, created_at, conversation_id, reply context, engagement counts, media URLs, page_cursor, has_next_page, and next_cursor. Treat next_cursor as opaque and pass it back as cursor only when has_next_page is true. Use sinceTime and untilTime to bound a poller window. Zero affordable results return 402 insufficient_credits.

​
Path parameters

​
id
string
required
User ID (numeric) or username.

​
Query parameters

​
cursor
string
Pagination cursor from a previous response. Omit for the first page.
​
sinceTime
string
Unix timestamp in seconds. Only return mentions after this time.
​
untilTime
string
Unix timestamp in seconds. Only return mentions before this time.

​
Tweet result filters

These optional filters apply to tweets[] returned by this route. They keep the same mentions target and filter rows after each page is fetched, so selective filters can return fewer rows than an unfiltered page.
​
fromUser
string
Filter to tweets authored by this username. The @ prefix is optional.
​
toUser
string
Filter to replies directed to this username.
​
mentioning
string
Filter to tweets that mention this username.
​
language
string
Filter by tweet language code, such as en, tr, or es.
​
sinceDate
string
Filter to tweets created on or after this date or timestamp.
​
untilDate
string
Filter to tweets created before this date or timestamp. A YYYY-MM-DD value includes the whole day before the boundary.
​
mediaType
string
Filter by attached media or links. Values: images, videos, gifs, media, links, none.
​
minFaves
integer
Minimum like count.
​
minRetweets
integer
Minimum retweet count.
​
minReplies
integer
Minimum reply count.
​
minQuotes
integer
Minimum quote count.
​
verifiedOnly
boolean
When true, only return tweets from verified authors.
​
replies
string
Reply mode. Values: include, exclude, only.
​
retweets
string
Retweet mode. Values: include, exclude, only.
​
quotes
string
Quote mode. Values: include, exclude, only.
​
exactPhrase
string
Exact text that must appear in the tweet.
​
excludeWords
string
Words or quoted phrases to exclude from returned tweets. Separate with spaces, commas, or lines.
​
anyWords
string
Words or quoted phrases where at least 1 term must appear in the tweet. Separate with spaces, commas, or lines.
​
hashtags
string
Hashtags to match. Separate with spaces, commas, or lines. The # prefix is optional.
​
cashtags
string
Cashtags to match. Separate with spaces, commas, or lines. The $ prefix is optional.
​
url
string
URL substring or domain that must appear in tweet URL entities.
​
conversationId
string
Filter to tweets in this conversation thread.
​
inReplyToTweetId
string
Filter to replies to this tweet ID.
​
quotesOfTweetId
string
Filter to quote tweets of this tweet ID.
​
retweetsOfTweetId
string
Filter to retweets of this tweet ID.

​
Headers

​
x-api-key
string
required
Your API key. Session cookie authentication is also supported.

​
Response

​
tweets
object[]
Array of tweets mentioning the user.
​
has_next_page
boolean
Whether more results are available.
​
next_cursor
string
Cursor for the next page.
{
  "tweets": [
    {
      "id": "1893456789012345678",
      "text": "Hey @user check this out!",
      "createdAt": "2026-03-27T10:00:00.000Z",
      "likeCount": 5,
      "author": {
        "id": "987654321",
        "username": "customer",
        "name": "Customer",
        "followers": 4200,
        "verified": false,
        "profilePicture": "https://pbs.twimg.com/profile_images/customer/photo.jpg"
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGE..."
}
Related: User Tweets · User Media · User Likes
Last modified on May 19, 2026