# AgentUtility User Tweets API

> AgentUtility User Tweets API is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches the latest public tweets from a specified X (Twitter) username, including text, timestamps, engagement metrics, pagination token, and author profile data.

## Facts

- Endpoint: POST https://x402.agentutility.ai/user-tweets
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-user-tweets-api-4333e158
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ckTsFyJnMgFBxyiEY6jYK

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 agentutility-user-tweets-api-4333e158 -d '<json body>'
```

Example prompt: Pull the 10 most recent public tweets from the X account @elonmusk — I want the tweet text, timestamps, and engagement metrics like likes and retweets.

## When to prefer this

Choose this endpoint when you need to retrieve the recent post history of a specific known X user by username, including rich engagement metrics and author profile data. It is ideal for monitoring individual accounts, researching influencers, tracking brand communications, or building timelines. Prefer this over the search endpoint when you already know the specific account you want to pull from rather than searching across all public tweets by keyword or topic.

## Known failure modes

- Username not found or account does not exist — returns user resolution error
- Account is private/protected — returns access denied or empty results
- X API v2 rate limits exceeded — returns rate limit error
- Invalid or expired pagination token — returns pagination error
- X API service downtime — returns upstream error
- Payment failure or insufficient USDC balance — returns payment required error

## How this service works

Fetches the latest public tweets from any X username, with text, timestamps, metrics, pagination token, and author profile. Read-only X API v2 route: resolves a public username, fetches that user's recent public posts, and excludes retweets by default. No posting, replying, liking, following, DM access, or account mutation. Use it as a user tweets API, X user timeline, or Twitter user posts endpoint.

## Output

Returns a list of recent public tweets for the specified X username. Each tweet includes the tweet text, creation timestamp, public engagement metrics (likes, retweets, replies, impressions), and a pagination token for fetching additional results. Also includes expanded author profile data such as display name, handle, and profile description. Retweets are excluded by default.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "properties": {
      "mode": {
       "type": "string",
       "enum": [
        "user_tweets"
       ],
       "description": "Use 'user_tweets' for public timeline lookup."
      },
      "username": {
       "type": "string",
       "description": "X/Twitter handle, with or without @."
      },
      "max_results": {
       "type": "number",
       "description": "Number of recent posts to fetch. Clamped to 5-50. Default 10."
      },
      "pagination_token": {
       "type": "string",
       "description": "Optional X pagination token for the next page."
      },
      "include_retweets": {
       "type": "boolean",
       "description": "Include retweets when true. Defaults false."
      }
     },
     "required": [
      "username"
     ]
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "mode": {
       "type": "string"
      },
      "username": {
       "type": "string"
      },
      "result_count": {
       "type": "integer"
      },
      "tweets": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": "string"
         },
         "text": {
          "type": "string"
         },
         "author": {
          "type": "object",
          "properties": {
           "username": {
            "type": "string"
           }
          }
         }
        }
       }
      },
      "source": {
       "type": "string"
      }
     }
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "user_tweets",
  "source": "X API v2 user tweets timeline",
  "tweets": [
   {
    "id": "123",
    "text": "x402 payments are live",
    "author": {
     "username": "bankrbot"
    }
   }
  ],
  "username": "bankrbot",
  "result_count": 10
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-user-tweets-api-4333e158/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)