Mentions
Tool ID: x_mentions
Summary
Lists posts that mention an account, using X’s mentions timeline. Read-only. With no handle, that account is the one connected to Metraclick. Replies and quotes show up here even when a word search for the @handle does not.
When to use it
- You want to see where the connected account was mentioned.
- You want replies and quotes aimed at a known @handle.
- You want that list without running a full post search.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| X account connected by an administrator | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
username |
No | Exact @handle. Leave this and user_id empty for the connected account. |
user_id |
No | Numeric user id. Do not pass this and username together. |
since / until |
No | YYYY-MM-DD or a full timestamp. |
max_results |
No | How many posts. Default 10. The API minimum is 5 and the maximum is 100. |
pagination_token |
No | next_token from the previous page. |
What you get back
The user id, handle when it was resolved, the posts (same shape as Get post), and next_token when another page exists.
Example prompts
What mentions did we get on X today?
Show posts that mention @example, including replies and quotes.
Keep going through the next page of mentions.
Tips
- This is the tool for “where am I mentioned.” Search is for topics, tags, and filters.
- A busy account may need another request with the returned
next_token.