# Portals Protocol Twitter Search

> Portals Protocol Twitter Search 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).

Search Twitter for tweets, users, and threads by query parameters and return JSON-formatted results

## Facts

- Endpoint: POST https://api.portalsprotocol.com/twitter/search
- 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-0d347e4b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ty6-TGufK93U7L20koWZn

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-0d347e4b -d '<json body>'
```

Example prompt: Search Twitter for the latest tweets and threads mentioning 'AI agents' from the past week and give me the top results.

## When to prefer this

Use this endpoint when you need to search Twitter/X for tweets, users, or threads by keyword, hashtag, or phrase and require structured JSON output. Prefer this over scraping or unofficial methods when you need reliable, paid-access results with consistent formatting. Particularly useful for social listening, trend monitoring, or content research pipelines.

## Known failure modes

- Invalid or missing query parameters return an error response
- Payment of 0.01 USDC not received results in 402 Payment Required
- Rate limits exceeded result in throttling or rejection
- Twitter API downstream errors cause partial or empty results
- Malformed POST body returns a 400 Bad Request

## Output

A JSON-formatted response containing matching tweets, user profiles, and/or threads that satisfy the query parameters, including metadata such as usernames, tweet text, timestamps, engagement counts, and thread context.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-portalsprotocol-com-0d347e4b/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)