# X (Twitter) mentions unofficial API: read tweets that mention you

Automatically read tweets that mention you on x.com. List recent tweets mentioning the logged-in account (the Notifications > Mentions tab). Returns per tweet a canonical record: id, url, author {id, handle, name}, text, created_at, lang, likes, retweets, replies, quotes, bookmarks, views, is_retweet, is_quote, and in_reply_to {id, author_handle} (null unless the mention is a reply). Scrolls until count is met or the list dries up.

- Site: x.com
- Address: `reduck/x.com/get_mentions`
- Updated: 2026-10-22 (v7)
- Author: Reduck AI (reduck)

## Run it

Ask an AI agent connected to Reduck over MCP (`https://mcp.reduck.ai/mcp`) to run `reduck/x.com/get_mentions`, or run it from a terminal:

```bash
npx @reduck-ai/cli@latest run --script reduck/x.com/get_mentions
```

## Input

- `count` (integer, optional): How many to return. Without it, the script returns the first page X shows (often 20 to 40). With it, the script loads more until it has count, reaches the end, or X stops loading; complete says whether it reached the end.

## Output

- `count` (integer, required): Number of mentions returned. 0 is a valid answer.
- `complete` (boolean, required): True when X showed the end of the mentions and every one it sent is returned. False when there may be more: count was reached, X stopped loading, or no count was given and the first page is not the end.
- `mentions` (array, required)

## FAQ

### What does "X (Twitter) mentions unofficial API: read tweets that mention you" do?

List recent tweets mentioning the logged-in account (the Notifications > Mentions tab). Returns per tweet a canonical record: id, url, author {id, handle, name}, text, created_at, lang, likes, retweets, replies, quotes, bookmarks, views, is_retweet, is_quote, and in_reply_to {id, author_handle} (null unless the mention is a reply). Scrolls until count is met or the list dries up.

### How do I automatically read tweets that mention you on x.com?

Ask an AI agent connected to Reduck to run reduck/x.com/get_mentions, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/x.com/get_mentions

### Is there a x.com API to read tweets that mention you?

You do not need one. "X (Twitter) mentions unofficial API: read tweets that mention you" drives the real x.com pages in a browser, so it works whether or not x.com offers an API for this.

### What information do I need to provide?

Optional: count.

### What does it return?

It returns count, complete, mentions.

### Do I need to be logged in to x.com?

Yes. It acts as you on x.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the x.com cookies saved by the Reduck extension.

### Does it change anything on x.com, or only read data?

It only reads. It looks things up on x.com and changes nothing there.

### How do I run it?

Ask an AI agent connected to Reduck to run reduck/x.com/get_mentions, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/x.com/get_mentions

### Who maintains it?

It is part of Reduck's official curated catalogue.

Source: https://reduck.ai/explore/scripts/reduck/x.com/get_mentions