# X / Profile

Fetch a public X profile by username: bio, followers, and verification.

```
GET /api/v1/twitter/profile
```

Auth: `Authorization: Bearer <SOCIFY_KEY>`  
Credits: 2 credits per request

## Parameters

| Name | Required | Description | Example |
|------|----------|-------------|---------|
| `username` | yes | Username without @. | `elonmusk` |

## Example

```bash
curl -s 'https://trysocify.com/api/v1/twitter/profile?username=elonmusk' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

## Response fields

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | Numeric user id (for Tweets). |
| `username` | string | Username without @. |
| `name` | string | Display name. |
| `bio` | string | Profile bio. |
| `avatar` | string | Avatar URL. |
| `verified` | boolean | Whether the account has a blue check. |
| `followers` | number | Follower count. |
| `following` | number | Following count. |
| `tweets` | number | Tweet count. |
| `url` | string | Profile URL. |
## Sample response

Successful lookups wrap the payload in `{ ok, platform, resource, params, data, meta }`. `data` is shown below.

```json
{
  "ok": true,
  "platform": "twitter",
  "resource": "profile",
  "params": {
    "username": "elonmusk"
  },
  "data": {
    "avatar": "https://pbs.twimg.com/profile_images/example.jpg",
    "bio": "Example bio",
    "followers": 150000000,
    "following": 500,
    "id": "44196397",
    "name": "Elon Musk",
    "tweets": 30000,
    "url": "https://x.com/elonmusk",
    "username": "elonmusk",
    "verified": true
  },
  "meta": {
    "credits_charged": 2,
    "latency_ms": 420,
    "platform": "twitter",
    "resource": "profile",
    "path": "/api/v1/twitter/profile"
  }
}
```

## Links

- HTML docs: https://trysocify.com/docs/api/twitter/profile
- SEO page: https://trysocify.com/twitter/profile
- OpenAPI: https://trysocify.com/openapi.json
- Catalog: https://trysocify.com/catalog.json