# Twitter User Profile Lookup

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

Returns public Twitter/X user profile metadata (bio, metrics, verification status, images) for a given username handle.

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/dheff711
- Price: $0.001000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-surf-cascade-fyi-97be5262
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n6q-4C2T41xvNXUPQ86MM

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-97be5262
```

Example prompt: Can you pull up the public Twitter profile for the handle 'dheff711' — I want to see their bio, follower count, verification status, and when they joined?

## When to prefer this

Use this endpoint when you need structured public profile metadata for a specific Twitter/X user by handle — especially when you need follower counts, verification status, bio text, or account age as part of an enrichment or research workflow. Prefer this over scraping or browser automation when you need clean structured JSON output and are willing to pay micro-amounts per lookup. It is NOT suitable for searching users by name (requires a handle) or fetching tweets.

## Known failure modes

- Username not found — account may be suspended, deleted, or handle misspelled
- Rate limit exceeded — too many requests to the underlying Twitter API
- Payment failure — insufficient USDC balance or unsupported payment token
- Private/protected account — public profile data unavailable
- Temporary upstream Twitter API outage causing 5xx errors

## How this service works

Returns public Twitter user profile and metadata for a given handle; paid access accepts Solana or EVM token payments.

## Output

Returns a structured data object containing the user's numeric Twitter ID, display name, username, bio description, location, verified boolean, account creation timestamp, 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",
    "name",
    "location",
    "username",
    "verified",
    "created_at",
    "description",
    "public_metrics",
    "cover_image_url",
    "pinned_tweet_ids",
    "profile_image_url"
   ],
   "properties": {
    "id": {
     "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-97be5262/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)