> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_x_profile

# get_x_profile

> An X (Twitter) account's public profile: followers, following, post count, bio, location, verification, join date. ₹0.13 per profile; a missing handle is ₹0.

## What it does

A public X account from its `handle` (without the @), as one object in `data`: `displayName`, `bio`, `location`, `followers`, `following`, `mediaCount`, `createdUtc`, `avatarUrl`, `pinnedPostIds` and verification. Use it to size an account before [`get_x_posts`](https://parel.si/docs/tools/get_x_posts.md); it returns no posts.

India: any public account.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `handle` | string | yes | Twitter/X handle without the leading @.. e.g. "nasa" |

## What drives the cost

Nothing: flat per profile. A handle that does not exist is `class: "ok_free"`, ₹0, so check the spelling to save the call. Usually one to two seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.13** per profile (`cost_paise: 13`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_x_profile"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_x_profile"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_x_profile","input":{"handle":"Flipkart"}}'
```

## What comes back

`data`, the profile object. A real answer recorded during the live check of 2026-10-28, trimmed:

```json
{
  "avatarUrl": "https://pbs.twimg.com/profile_images/1865298012915798016/D9ZsU8FS_normal.jpg",
  "bio": "Have queries? Send them here by clicking on this link 👇 https://t.co/USqO270bKA",
  "coverUrl": "https://pbs.twimg.com/profile_banners/57947109/1759821396",
  "createdUtc": 1247928302,
  "displayName": "Flipkart",
  "followers": 2855966,
  "following": 12,
  "handle": "Flipkart",
  "id": "57947109",
  "location": "India",
  "mediaCount": 11916,
  "pinnedPostIds": [
    "2100844809254809821"
  ],
  "private": false,
  "tweets": 40988,
  "verified": true,
  "website": "http://www.flipkart.com"
}
```

## Notes

- A handle that does not exist is no result and free for you; check the spelling first.
- Usually one to two seconds.

## Siblings

- [`get_x_posts`](https://parel.si/docs/tools/get_x_posts.md) for what the account posts.
- [`get_instagram_profile`](https://parel.si/docs/tools/get_instagram_profile.md) for the same brand on Instagram.
