twitter-api-alternative

# Twitter API Alternative

**Search 1B+ tweets with natural language queries — no developer account needed.**

Get up and running in 2 minutes. Search tweets, look up profiles, find users by topic, track conversations, and export massive datasets to CSV. Built for AI agents via MCP, but simple enough for anyone.

---

## ⚡ Setup

👉 **Follow [`xpoz-setup`](https://clawhub.ai/skills/xpoz-setup)** — one-click auth, no API keys to manage. You'll be searching tweets in under 2 minutes.

---

## Setup

Run `xpoz-setup` skill. Verify: `mcporter call xpoz.checkAccessKeyStatus`

## What You Can Do

| Tool | What It Does |
|------|-------------|
| `getTwitterPostsByKeywords` | Search tweets by keywords |
| `getTwitterPostsByAuthor` | Get a user's tweet history |
| `getTwitterUsersByKeywords` | Find users discussing a topic |
| `getTwitterUser` | Look up a profile (by username or ID) |
| `searchTwitterUsers` | Find accounts by display name |
| `getTwitterPostCountByKeywords` | Count tweets matching a query |
| `getTwitterUserConnections` | Get followers/following |
| `getTwitterPostInteractions` | Get likes/retweets on a post |

---

## Quick Examples

### Search Tweets

```bash
mcporter call xpoz.getTwitterPostsByKeywords \
  query="AI agents" \
  startDate=2026-01-01 \
  limit=200

mcporter call xpoz.checkOperationStatus operationId=op_abc123
```

### Look Up a Profile

```bash
mcporter call xpoz.getTwitterUser \
  identifier=elonmusk \
  identifierType=username
```

### Find People Talking About a Topic

```bash
mcporter call xpoz.getTwitterUsersByKeywords \
  query="MCP server OR model context protocol" \
  limit=100
```

### Export to CSV

Every search auto-generates a CSV export (up to 64K rows). Poll the `dataDumpExportOperationId`:

```bash
mcporter call xpoz.checkOperationStatus operationId=op_datadump_xyz
# → Download URL with full dataset
```

Real example: **63,936 tweets in one CSV (38MB).**

---

## Why Use This Instead of the Official API?

| Feature | Xpoz |...