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; it returns no posts.

India: any public account.

Inputs

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

FieldTypeRequiredDescription
handlestringyesTwitter/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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "get_x_profile"
Over RESTPOST https://api.parel.si/v1/run with "tool": "get_x_profile"
Confirmationnot needed (the estimate is under the ₹200 threshold)

Request

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:

{
  "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

This page as Markdown: /docs/tools/get_x_profile.md. Something wrong or missing: hello@parel.si.