Piloterr

X Profile Info (twitter)

X Profile Info API — fetch public X/Twitter profile data (bio, followers, verification, avatars) from a username or URL via browser rendering.

Credit cost: 2 credits per call

GET
/v2/x/profile/info

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

X profile to look up. Accepts a username, @handle, or profile URL.

Examples:

elonmusk
@elonmusk
https://x.com/elonmusk

Notes:

  • Legacy twitter.com URLs are supported.
  • Rejected (400): search URLs, status/tweet URLs, invalid handles.
  • X Search is not supported by this API.
return_page_source?boolean

When true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/x/profile/info?query=string"
{
  "url": "https://x.com/elonmusk",
  "name": "Elon Musk",
  "user_id": "44196397",
  "location": null,
  "username": "elonmusk",
  "verified": true,
  "created_at": "2009-06-02T20:12:29.000Z",
  "description": "Starmind",
  "tweet_count": 104989,
  "followers_count": 240609640,
  "following_count": 1366,
  "profile_image_url": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_400x400.jpg",
  "profile_banner_url": "https://pbs.twimg.com/profile_banners/44196397/1774145451",
  "profile_image_url_normal": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_normal.jpg"
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}