# X User Timeline Fetcher

> X User Timeline Fetcher is a paid API for AI agents from agentbodega.store, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-22).

Fetches recent public posts from an X (Twitter) user's timeline, including text, author info, and engagement metrics.

## Facts

- Endpoint: POST https://agentbodega.store/api/social-media/x/user-timeline?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x-user-timeline-fetcher-64bc3529
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o3ztYsAW-fYyR0BNbidzI

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 x-user-timeline-fetcher-64bc3529 -d '<json body>'
```

Example prompt: Can you pull the last 10 posts from the X account @elonmusk and show me the text and engagement numbers like likes and reposts?

## When to prefer this

Use this endpoint when you need to quickly retrieve recent public posts and engagement metrics for a specific X user without setting up a full Twitter/X API integration. It is especially useful for AI agents operating in an x402 micropayment context where per-call billing at $0.05 USDC is acceptable and no OAuth setup is desired.

## Known failure modes

- Invalid or non-existent username returns an error or empty results
- Private/protected accounts may return no posts
- maxResults exceeding platform limits may be capped silently
- Payment failure via x402 prevents the call from completing
- Rate limiting by the underlying X API may cause transient failures

## How this service works

Small x402-payable utility APIs for agents: endpoint inspection, launch checks, and hosted artifacts.

## Output

Returns a JSON object with a list of recent posts from the specified X user, each containing the post ID, normalized text, author username, and engagement metrics (likes, replies, reposts). Also includes the total result count and the original request parameters (username and maxResults).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "fields": [
      {
       "name": "username",
       "type": "string",
       "required": true
      },
      {
       "name": "maxResults",
       "type": "integer",
       "required": false
      }
     ],
     "required": [
      "username"
     ],
     "fieldCount": 2,
     "contentType": "application/json",
     "optionalPreview": [
      "maxResults"
     ],
     "omittedFieldCount": 0
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": {
   "id": "x-user-timeline",
   "name": "X User Timeline",
   "department": "Social Media"
  },
  "results": [
   {
    "id": "1110302988",
    "text": "Normalized public post text",
    "author": {
     "username": "OpenAI"
    },
    "metrics": {
     "likes": 10,
     "replies": 1,
     "reposts": 2
    }
   }
  ],
  "success": true,
  "requested": {
   "username": "OpenAI",
   "maxResults": 5
  },
  "result_count": 5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x-user-timeline-fetcher-64bc3529/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentbodega.store](https://www.zero.xyz/host/agentbodega.store/llms.txt)