# ClinkAgent X/Twitter User Timeline

> ClinkAgent X/Twitter User Timeline is a paid API for AI agents from clinkagent.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-02).

Fetches the latest tweets from any public Twitter/X handle, including post text, engagement metrics, and pinned tweet — no Twitter API key required.

## Facts

- Endpoint: GET https://clinkagent.com/x/user?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clinkagent-x-twitter-user-timeline-3bd353e7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nn1cT3alb2QgxHeUgbpuU

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 clinkagent-x-twitter-user-timeline-3bd353e7
```

Example prompt: Pull the latest tweets from @naval on X — I want to see his most recent posts including how many likes and retweets each got.

## When to prefer this

Choose this endpoint when you need structured tweet data and engagement metrics for a specific known Twitter/X handle without managing a Twitter developer account or API key. Ideal for agent workflows that monitor individuals (founders, analysts, journalists, crypto influencers) or brands. Prefer this over the /x/search endpoint when you know the exact account you want to track rather than searching by topic or keyword.

## Known failure modes

- Username does not exist or is misspelled — returns error or empty result
- Account is private/protected — tweets not accessible
- Twitter/X rate limiting or platform changes may cause intermittent failures
- Username parameter missing — returns validation error
- Account has been suspended or deactivated — no data returned

## How this service works

X/Twitter user timeline for AI agents - the latest tweets from any handle, no Twitter API key or login. Up to 20 newest posts with text, date, likes, retweets, replies, views, follower count and URL, plus the pinned tweet. Track founders, analysts, competitors, crypto callers, journalists, brands. ?username=elonmusk. Search all of X instead: /x/search $0.02. AI trend summary: /x/digest $0.05.

## Output

Returns up to 20 of the most recent tweets from the specified Twitter/X handle, each with post text, publication date, likes, retweets, replies, views, and direct URL. Also includes the account's follower count and the user's pinned tweet if one exists.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "username"
     ],
     "properties": {
      "username": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tweets": [
   {
    "url": "https://x.com/...",
    "text": "...",
    "likes": 1234,
    "author": "elonmusk"
   }
  ],
  "username": "elonmusk",
  "result_count": 20
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/clinkagent-x-twitter-user-timeline-3bd353e7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clinkagent.com](https://www.zero.xyz/host/clinkagent.com/llms.txt)