# X Profile & Recent Tweets Fetcher (x402factory.ai)

> X Profile & Recent Tweets Fetcher (x402factory.ai) is a paid API for AI agents from x402factory.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-22, last successful call 2026-07-18).

Fetches a full X (Twitter) profile and the 10 most recent tweets for a given handle, returning raw profile data plus a trimmed tweet list with engagement metrics and media.

## Facts

- Endpoint: POST https://x402factory.ai/base/xprofile?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Last successful call: 2026-07-18
- Success rate: 86% of calls made through Zero
- Rating: 2.3 / 5 from 3 reviews
- Activations on Zero: 37
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402factory-ai-92675e44
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3MHl-lpmehSY0GKqw0DUm

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 x402factory-ai-92675e44 -d '<json body>'
```

Example prompt: Can you pull up the X profile and the 10 most recent tweets for @paulg, including their follower count and engagement stats like likes and retweets?

## When to prefer this

Use this endpoint when you need a quick, low-cost snapshot of a specific X user's profile and their most recent 10 tweets with engagement metrics, particularly when operating within an x402 micropayment workflow on Base. Prefer this over full Twitter API integrations when you only need a lightweight profile + recent-activity lookup without OAuth setup.

## Known failure modes

- Handle not found — returns error if the X username does not exist or is suspended
- Private account — returns error or empty tweet list if the account is protected
- Rate limiting — may return an error if upstream X API limits are hit
- Invalid handle format — returns error if the input is malformed
- Payment failure — request rejected if 0.001 USDC x402 payment is not included or invalid

## How this service works

Base X profile mini-endpoint. Fetches a full X profile and the 10 most recent tweets for a given handle, returning the raw profile data plus a trimmed tweet list with key engagement metrics and media. Cost: 0.001 USDC per request.

## Output

Returns the full X profile object (bio, follower/following counts, profile image, etc.) plus a trimmed list of the 10 most recent tweets, each with key engagement metrics (likes, retweets, replies) and any attached media URLs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "handle"
 ],
 "properties": {
  "handle": {
   "type": "string",
   "description": "X handle (username) without the @ prefix, for example WURKDOTFUN or statikheadz."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "ok": {
  "type": "boolean",
  "description": "True on success."
 },
 "handle": {
  "type": "string",
  "description": "Normalized X handle that was requested."
 },
 "tweets": {
  "type": "array",
  "description": "Array of up to 10 recent tweets with trimmed but useful metadata: id, text (max 3000 chars; longer texts are truncated), created_at, language, basic user info, engagement metrics, media and links."
 },
 "profile": {
  "type": "object",
  "description": "Full upstream X profile payload for the user, including core fields like id, rest_id, name, screen_name, description, avatar, location and counters."
 },
 "price_usdc": {
  "type": "string",
  "description": "Fixed price charged for this call in USDC (6 decimals)."
 },
 "tweet_count": {
  "type": "number",
  "description": "Number of recent tweets returned (up to 10)."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402factory-ai-92675e44/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402factory.ai](https://www.zero.xyz/host/x402factory.ai/llms.txt)