# X API

Public X profiles, tweets, and post stats.

Auth: `Authorization: Bearer <SOCIFY_KEY>`  
HTML: https://trysocify.com/docs/api/twitter  
Platform file: https://trysocify.com/llms-twitter.txt  
OpenAPI: https://trysocify.com/openapi.json

## Endpoints (3)

- [Profile](#profile) — `GET /api/v1/twitter/profile` (2 credits per request)
- [X User Tweets](#x-user-tweets) — `GET /api/v1/twitter/tweets` (4 credits per request)
- [X Post Info](#x-post-info) — `GET /api/v1/twitter/post` (2 credits per request)

### Profile

`GET /api/v1/twitter/profile`

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

Credits: 2 credits per request

**Parameters**

- `username` (required) — Username without @. Example: `elonmusk`.

**Docs:** [https://trysocify.com/docs/api/twitter/profile.md](https://trysocify.com/docs/api/twitter/profile.md) · HTML: https://trysocify.com/docs/api/twitter/profile

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

### X User Tweets

`GET /api/v1/twitter/tweets`

Fetch recent public tweets for a user id (from User Info). Best coverage on verified accounts. Response is a compact tweet list (not raw GraphQL).

Credits: 4 credits per request

**Parameters**

- `id` (required) — Numeric user id from User Info (id). Example: `44196397`.

**Docs:** [https://trysocify.com/docs/api/twitter/tweets.md](https://trysocify.com/docs/api/twitter/tweets.md) · HTML: https://trysocify.com/docs/api/twitter/tweets

```bash
curl -sS 'https://trysocify.com/api/v1/twitter/tweets?id=44196397' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### X Post Info

`GET /api/v1/twitter/post`

Fetch public details and stats for a tweet by id.

Credits: 2 credits per request

**Parameters**

- `id` (required) — Tweet id. Example: `1694791112567967849`.

**Docs:** [https://trysocify.com/docs/api/twitter/post.md](https://trysocify.com/docs/api/twitter/post.md) · HTML: https://trysocify.com/docs/api/twitter/post

```bash
curl -sS 'https://trysocify.com/api/v1/twitter/post?id=1694791112567967849' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```