# glim.sh Twitter User Profile Lookup

> glim.sh Twitter User Profile Lookup is a paid API for AI agents from glim.sh, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Fetches a live Twitter/X user profile by username or user ID, returning account metadata and stats

## Facts

- Endpoint: POST https://glim.sh/api/v1/twitter/users/:ref
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/glim-sh-twitter-user-profile-lookup-796529d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NgCGfKU7oa3bbDAEn2Ssc

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 glim-sh-twitter-user-profile-lookup-796529d7 -d '<json body>'
```

Example prompt: Look up the Twitter profile for @paulg — I want their bio, follower count, and when the account was created.

## When to prefer this

Use this endpoint when you need live, up-to-date Twitter/X user profile data (follower counts, bio, verified status) for a specific user by handle or ID. Prefer it over cached social data sources when recency matters, or when enriching contact records with current social metadata. It's the right choice when you already know the username or ID and need a direct profile lookup rather than a search.

## Known failure modes

- User not found — username or ID does not exist or account is suspended
- Rate limit exceeded — too many requests in a short window
- Private/protected account — profile details may be restricted
- Invalid ref format — malformed username or ID returns a 400-level error
- Twitter API downstream outage — service temporarily unavailable

## How this service works

Fetch a user profile by username or ID

## Output

Returns a live Twitter/X user profile object including display name, username (handle), bio/description, follower count, following count, tweet count, profile image URL, account creation date, verified status, and other public account metadata.

## 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": {
     "type": "object",
     "properties": {},
     "description": "No body parameters - the user @handle or id is taken from the URL path"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object",
       "propertyNames": {
        "type": "string"
       },
       "additionalProperties": {}
      }
     },
     "required": [
      "data"
     ]
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/glim-sh-twitter-user-profile-lookup-796529d7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from glim.sh](https://www.zero.xyz/host/glim.sh/llms.txt)