# Twitter/X User Profile Lookup

> Twitter/X User Profile Lookup is a paid API for AI agents from twitter.surf.cascade.fyi, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Fetches a Twitter/X user's public profile data including bio, metrics, and account details by username

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/programmer
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Success rate: 63% of calls made through Zero
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-surf-cascade-fyi-645a1cbd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xC7rVAOJgdnhO2nJnX4Zf

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 twitter-surf-cascade-fyi-645a1cbd
```

Example prompt: Can you pull up the Twitter profile for the user @programmer — I want to see their bio, follower count, and when they joined?

## When to prefer this

Use this endpoint when you need structured public profile data for a specific Twitter/X user by their username, especially when you need follower counts, bio text, verification status, or account metadata. Prefer this over scraping or general web search when you need clean, structured JSON output with reliable public metrics.

## Known failure modes

- Username not found — user may not exist or account may be suspended
- Private account — profile data may be restricted
- Rate limiting — too many requests in a short window
- Invalid username format — usernames must be valid Twitter handles
- Service unavailable — upstream Twitter API outage

## How this service works

Fetch user profile

## Output

Returns a JSON object with the user's Twitter ID, display name, username, bio description, location, website URL, verified status, account creation date, profile image URL, cover image URL, pinned tweet IDs, and public metrics including follower count, following count, tweet count, like count, and media count.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

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

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "id",
    "url",
    "name",
    "location",
    "username",
    "verified",
    "created_at",
    "description",
    "public_metrics",
    "cover_image_url",
    "pinned_tweet_ids",
    "profile_image_url"
   ],
   "properties": {
    "id": {
     "type": "string"
    },
    "url": {
     "type": "string"
    },
    "name": {
     "type": "string"
    },
    "location": {
     "type": "string"
    },
    "username": {
     "type": "string"
    },
    "verified": {
     "type": "boolean"
    },
    "created_at": {
     "type": "string"
    },
    "description": {
     "type": "string"
    },
    "public_metrics": {
     "type": "object",
     "required": [
      "like_count",
      "media_count",
      "tweet_count",
      "followers_count",
      "following_count"
     ],
     "properties": {
      "like_count": {
       "type": "number"
      },
      "media_count": {
       "type": "number"
      },
      "tweet_count": {
       "type": "number"
      },
      "followers_count": {
       "type": "number"
      },
      "following_count": {
       "type": "number"
      }
     }
    },
    "cover_image_url": {
     "type": "string"
    },
    "pinned_tweet_ids": {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    "profile_image_url": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-surf-cascade-fyi-645a1cbd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitter.surf.cascade.fyi](https://www.zero.xyz/host/twitter.surf.cascade.fyi/llms.txt)