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

# Twitter Search Tracker

> Twitter search monitor. Add search queries that you want to track. Three symbols minimum limit, otherwise tracker will not work.

## Facts

- Stream ID: `01K0FJN0J7J4PN1R8QCWS9AWYP`
- Page: https://synoptic.com/p/streams/twttr-search-tracker
- Agent skill: https://synoptic.com/p/streams/twttr-search-tracker/SKILL.md
- Author: [@CVB_feeds](https://synoptic.com/CVB_feeds)
- Category: Other
- Kind: Custom targets: each subscriber receives only posts for the targets they choose
- Price: Paid: $20 per month for every 5 targets, $60 per 3 months for every 5 targets, $120 per 6 months for every 5 targets, $240 per year for every 5 targets
- Followers: 7
- Targets are Search keywords: min 4 symbols. A subscription holds 5 to 120 targets, in steps of 5.

## 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/twttr-search-tracker (Paid: $20 per month for every 5 targets, $60 per 3 months for every 5 targets, $120 per 6 months for every 5 targets, $240 per year for every 5 targets).
3. Choose targets on https://synoptic.com/p/streams/twttr-search-tracker, with MCP `set_stream_custom_targets`, or with `POST https://api.synoptic.com/v1/streams/01K0FJN0J7J4PN1R8QCWS9AWYP/custom-targets`. Targets are Search keywords: min 4 symbols. A subscription holds 5 to 120 targets, in steps of 5.
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=01K0FJN0J7J4PN1R8QCWS9AWYP`, or read history with `GET https://api.synoptic.com/v1/streams/01K0FJN0J7J4PN1R8QCWS9AWYP/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: $20 per month for every 5 targets, $60 per 3 months for every 5 targets, $120 per 6 months for every 5 targets, $240 per year for every 5 targets.

**How much history can I read?**
With access, `GET https://api.synoptic.com/v1/streams/01K0FJN0J7J4PN1R8QCWS9AWYP/posts` pages with `nextToken`, `GET https://api.synoptic.com/v1/streams/01K0FJN0J7J4PN1R8QCWS9AWYP/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 Search keywords: min 4 symbols. A subscription holds 5 to 120 targets, in steps of 5.

## More

- [Agent skill for this stream](https://synoptic.com/p/streams/twttr-search-tracker/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)
