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

# Twitter Follows-Unfollows

> Track twitter follows unfollows of the account

## Facts

- Stream ID: `01K0FJRYS6BT0NW4MS33QZJ3A9`
- Page: https://synoptic.com/p/streams/twttr-follows-unfollows
- Agent skill: https://synoptic.com/p/streams/twttr-follows-unfollows/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: $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: 4
- Targets are Twitter usernames: Type usernames in lowercase, without @ sign. Example: elonmusk. A subscription holds 10 to 10000 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/twttr-follows-unfollows (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/twttr-follows-unfollows, with MCP `set_stream_custom_targets`, or with `POST https://api.synoptic.com/v1/streams/01K0FJRYS6BT0NW4MS33QZJ3A9/custom-targets`. Targets are Twitter usernames: Type usernames in lowercase, without @ sign. Example: elonmusk. A subscription holds 10 to 10000 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=01K0FJRYS6BT0NW4MS33QZJ3A9`, or read history with `GET https://api.synoptic.com/v1/streams/01K0FJRYS6BT0NW4MS33QZJ3A9/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/01K0FJRYS6BT0NW4MS33QZJ3A9/posts` pages with `nextToken`, `GET https://api.synoptic.com/v1/streams/01K0FJRYS6BT0NW4MS33QZJ3A9/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 usernames: Type usernames in lowercase, without @ sign. Example: elonmusk. A subscription holds 10 to 10000 targets, in steps of 10.

## More

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