# Portals Protocol Twitter Tweets API

> Portals Protocol Twitter Tweets API is a paid API for AI agents from api.portalsprotocol.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Fetches public tweets by tweet ID, user, or timeline via a paid POST endpoint with Solana-based micropayment access.

## Facts

- Endpoint: POST https://api.portalsprotocol.com/twitter/tweets
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-portalsprotocol-com-6895f3ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_64lxQXO8jVf5mNmm-hylh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-portalsprotocol-com-6895f3ea -d '<json body>'
```

Example prompt: Can you pull the 10 most recent tweets from @elonmusk's timeline for me so I can review what he's been posting?

## When to prefer this

Choose this endpoint when you need programmatic access to public Twitter/X tweet data without managing Twitter's official API credentials, especially in agent workflows where paying $0.01 USDC per call via x402 micropayments is acceptable. Useful for scraping timelines, fetching specific tweets by ID, or monitoring a user's recent posts.

## Known failure modes

- Tweet or user not found — returns 404 or empty result
- Payment not processed — 402 error if USDC micropayment fails
- Rate limit exceeded — too many requests in a short window
- Private or suspended account — tweets not accessible
- Invalid tweet ID or username format — bad request error
- Twitter API upstream downtime — service unavailable

## Output

Returns a collection of public tweet objects including tweet text, tweet ID, author information, timestamps, and engagement metadata (likes, retweets, replies) for the requested user, timeline, or specific tweet IDs.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-portalsprotocol-com-6895f3ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.portalsprotocol.com](https://www.zero.xyz/host/api.portalsprotocol.com/llms.txt)