# twit.sh — Twitter/X User Lookup by Numeric ID

> twit.sh — Twitter/X User Lookup by Numeric ID is a paid API for AI agents from twit.sh, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Fetches real-time Twitter/X user profile data (name, username, bio, follower count, and other public metrics) given a numeric Twitter user ID.

## Facts

- Endpoint: GET https://twit.sh/users/by/id
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twit-sh-twitter-x-user-lookup-by-numeric-id-349b6602
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MPdSCqm0BYoxSozoos_JC

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 twit-sh-twitter-x-user-lookup-by-numeric-id-349b6602
```

Example prompt: Can you look up the Twitter/X profile for user ID 9253672 — I want to see their username, bio, and follower count?

## When to prefer this

Choose this endpoint when you have a numeric Twitter/X user ID and need real-time profile data without managing Twitter API keys or OAuth. It is ideal for fully autonomous agents that can pay per request in USDC on Base via x402, especially when you need to resolve IDs to usernames or retrieve current follower/engagement metrics programmatically without sign-up friction.

## Known failure modes

- Invalid or non-numeric ID returns an error or empty data response
- Suspended or deactivated accounts may return no data
- Payment failure via x402/USDC on Base will block the request
- Rate limiting may occur under high request volume
- Private or restricted accounts may return limited public data

## How this service works

Real-time Twitter/X data for AI agents. No sign-up, no API keys. Pay per request in USDC on Base via x402. Fully autonomous.

## Output

Returns a JSON object with the user's numeric ID, display name, username, verified status, bio/description, and public metrics including follower count, following count, tweet count, and like count.

## 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": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Numeric Twitter user ID"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "id": "9253672",
   "name": "Hal Finney",
   "username": "halfin",
   "verified": false,
   "description": "Running bitcoin.",
   "public_metrics": {
    "like_count": 300,
    "tweet_count": 600,
    "followers_count": 134000,
    "following_count": 200
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twit-sh-twitter-x-user-lookup-by-numeric-id-349b6602/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twit.sh](https://www.zero.xyz/host/twit.sh/llms.txt)