# Twitter Surf - Fetch User Profile

> Twitter Surf - Fetch 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).

Retrieves 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/sama
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-surf-cascade-fyi-1e38f4a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ThO5mC46WTcSR9J69wnho

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-1e38f4a1
```

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

## When to prefer this

Use this endpoint when you need to retrieve public profile metadata for a specific Twitter/X user by their username. Ideal for enriching contact records, checking influencer metrics, verifying account existence, or gathering public bio data. Choose this over scraping or unofficial methods for structured, paid, reliable access.

## Known failure modes

- Username does not exist — endpoint may return 404 or empty result
- User account has been suspended or deactivated
- Rate limiting or payment failure (x402) resulting in 402 Payment Required
- Incorrect username spelling returns no results
- Private or restricted accounts may return limited data

## How this service works

Fetch user profile

## Output

Returns a JSON object containing the user's numeric ID, display name, username, bio description, location, website URL, profile image URL, cover image URL, verified status, account creation timestamp, and public metrics (followers_count, following_count, tweet_count, like_count, 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",
    "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"
    },
    "profile_image_url": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-surf-cascade-fyi-1e38f4a1/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)