> For the index of Synoptic streams and APIs for agents, see [llms.txt](https://synoptic.com/llms.txt).

# Twitter Hashtag Tracker (Real Time)

> Twitter Hashtag Tracker is a powerful tool designed to help you monitor hashtag activity on Twitter with outstanding speed and precision. There’s no need to track everything at once. You can begin with a few hashtags, then expand as your needs grow-adding new targets or swapping them out at any time for better performance. Built for high-speed tracking and in-depth analysis, this solution provides rapid data extraction and real-time trend detection. Whether you’re a researcher studying hashtag engagement or a business looking to understand audience sentiment and popular topics, the Twitter Hashtag Tracker delivers exactly what you need. With affordable pricing and real-time monitoring, it offers a cost-effective way to stay informed, analyze trends, and gain a competitive edge on Twitter.

## Facts

- Stream ID: `01KB5XVV7AC48CT2G7CZ1R92RV`
- Page: https://synoptic.com/p/streams/twitter-hashtag-tracker-real-time
- Agent skill: https://synoptic.com/p/streams/twitter-hashtag-tracker-real-time/SKILL.md
- Author: [@APIDojo](https://synoptic.com/APIDojo)
- Category: OSINT
- Kind: Custom targets: each subscriber receives only posts for the targets they choose
- Price: Paid: $10 per month for every 10 targets, $30 per 3 months for every 10 targets, $60 per 6 months for every 10 targets, $120 per year for every 10 targets
- Followers: 0
- Targets are Twitter Hashtags: Submit hashtags with # sign. Example: #bitcoin. A subscription holds 10 to 100000 targets, in steps of 10.

## Connect

No guest access: reading posts needs a Synoptic account and an API key, or MCP sign-in. Posts follow the targets each subscriber picks.

1. Sign in at https://synoptic.com/auth/login (new users: https://synoptic.com/auth/signup).
2. Subscribe at https://synoptic.com/p/streams/twitter-hashtag-tracker-real-time (Paid: $10 per month for every 10 targets, $30 per 3 months for every 10 targets, $60 per 6 months for every 10 targets, $120 per year for every 10 targets).
3. Choose targets on https://synoptic.com/p/streams/twitter-hashtag-tracker-real-time, with MCP `set_stream_custom_targets`, or with `POST https://api.synoptic.com/v1/streams/01KB5XVV7AC48CT2G7CZ1R92RV/custom-targets`. Targets are Twitter Hashtags: Submit hashtags with # sign. Example: #bitcoin. A subscription holds 10 to 100000 targets, in steps of 10.
4. Create a reader key in Settings → API & Keys: https://synoptic.com/p/settings/api-keys.
5. Connect `wss://ws.api.synoptic.com/v1/on-stream-post?apiKey=<reader key>&streamIds=01KB5XVV7AC48CT2G7CZ1R92RV`, or read history with `GET https://api.synoptic.com/v1/streams/01KB5XVV7AC48CT2G7CZ1R92RV/posts?limit=50` and the header `x-api-key: <reader key>`. MCP calls after OAuth sign-in are realtime too.

## Latest posts

Not available without an account: posts depend on your targets.

## How to use

- Each post has `id`, `streamId`, `text` (markdown) and `createdAt` (ISO 8601). Deduplicate by `id`.
- Each post has `customTarget`: the target it matched. You receive only posts for the targets you set; with no targets you receive nothing.

## FAQ

**Do I need an account?**
Yes. Posts depend on the targets you choose, and choosing targets needs an account.

**Is it free?**
Paid: $10 per month for every 10 targets, $30 per 3 months for every 10 targets, $60 per 6 months for every 10 targets, $120 per year for every 10 targets.

**How much history can I read?**
With access, `GET https://api.synoptic.com/v1/streams/01KB5XVV7AC48CT2G7CZ1R92RV/posts` pages with `nextToken`, `GET https://api.synoptic.com/v1/streams/01KB5XVV7AC48CT2G7CZ1R92RV/posts/search` searches text, and MCP `get_stream_posts` accepts `fromDate` and `toDate`.

**How fast do posts arrive?**
The realtime WebSocket sends each post as soon as it is published.

**Which targets can I choose?**
Targets are Twitter Hashtags: Submit hashtags with # sign. Example: #bitcoin. A subscription holds 10 to 100000 targets, in steps of 10.

## More

- [Agent skill for this stream](https://synoptic.com/p/streams/twitter-hashtag-tracker-real-time/SKILL.md)
- [Subscribe to posts](https://docs.synoptic.com/s/websocket/subscribe-to-posts.md)
- [REST API reference](https://docs.synoptic.com/s/rest/api-reference.md)
- [MCP](https://docs.synoptic.com/s/mcp/mcp.md)
- [Custom streams](https://docs.synoptic.com/s/integrations/custom-streams.md)
- [Docs index](https://docs.synoptic.com/s/llms.txt)
