# twit.sh Twitter/X User Lookup by ID

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

Fetches public profile data for up to 50 Twitter/X users by their numeric user IDs, returning name, username, bio, and public engagement metrics.

## Facts

- Endpoint: GET https://twit.sh/users
- 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/twit-sh-twitter-x-user-lookup-by-id-edf603f1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mz_IwrEc30PiX1dUQSW_3

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-id-edf603f1
```

Example prompt: Can you pull up the Twitter profile info and follower counts for these user IDs: 9253672, 44196397, and 783214 — I want their display names, usernames, bios, and public metrics.

## When to prefer this

Use this endpoint when you have numeric Twitter/X user IDs and need to resolve them to profile details or public metrics without managing API keys or OAuth. It is ideal for AI agents operating autonomously that need social profile enrichment or influencer stats on-demand, paying per request in USDC. Prefer this over the official Twitter API when you want zero-setup access with micropayment billing rather than a developer account.

## Known failure modes

- Invalid or non-existent user IDs return no matching entry in the data array
- Exceeding 50 IDs per request may result in an error or truncation
- Payment failure via x402/USDC results in a 402 response and no data
- Malformed comma-separated ID string returns a 400 or empty response
- Suspended or deactivated accounts may be omitted from results

## 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 an array of user objects, each containing numeric ID, display name, username handle, verified status, bio description, and public_metrics with follower count, following count, tweet count, and like count. Up to 50 users per request.

## 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": [
      "ids"
     ],
     "properties": {
      "ids": {
       "type": "string",
       "description": "Comma-separated numeric Twitter user IDs, max 50"
      }
     }
    }
   },
   "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-id-edf603f1/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)