# twitter.surf.cascade.fyi – Fetch Twitter/X User Profile

> twitter.surf.cascade.fyi – Fetch Twitter/X User Profile 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, verification status, and profile images by username

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/brian_armstrong
- 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-a9f84271
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__QXJ8J1Bxkq9setGNeY2I

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-a9f84271
```

Example prompt: Can you pull up the Twitter profile for @brian_armstrong — I want to see their bio, follower count, and whether they're verified?

## When to prefer this

Use this endpoint when you need structured public profile data for a specific Twitter/X user by username, especially follower counts, verification status, bio, and profile image. Prefer this over scraping or general web search when you need reliable, structured JSON output with public metrics. Best suited for single-user lookups; check sibling endpoints for tweets, followers, or mentions.

## Known failure modes

- Username not found — user does not exist or has been suspended
- Rate limit exceeded — too many requests to the underlying Twitter API
- Invalid username format — special characters or empty string
- Payment failure — insufficient USDC balance for x402 micropayment
- Twitter API downstream error — service unavailable

## How this service works

Fetch user profile

## Output

Returns a JSON object with the user's Twitter ID, display name, username, bio description, location, 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"
    },
    "pathParams": {
     "type": "object"
    },
    "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-a9f84271/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)