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
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringX profile to look up. Accepts a username, @handle, or profile URL.
Examples:
elonmusk@example-userhttps://x.com/example-userNotes:
- Legacy
twitter.comURLs are supported. - Rejected (400): search URLs, status/tweet URLs, invalid handles.
- X Search is not supported by this API.
return_page_source?booleanWhen true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
url?stringname?stringuser_id?stringlocation?unknownusername?stringverified?booleancreated_at?stringdescription?stringtweet_count?integerfollowers_count?integerfollowing_count?integerprofile_image_url?stringprofile_banner_url?stringprofile_image_url_normal?stringcurl -X GET 'https://api.piloterr.com/v2/x/profile/info?query=string'{ "url": "https://x.com/example-user", "name": "Alex Martin", "user_id": "00000000", "location": null, "username": "example-user", "verified": true, "created_at": "2009-06-02T20:12:29.000Z", "description": "Example profile.", "tweet_count": 104989, "followers_count": 240609640, "following_count": 1366, "profile_image_url": "https://pbs.twimg.com/placeholder/example-user.jpg", "profile_banner_url": "https://pbs.twimg.com/placeholder/example-user.jpg", "profile_image_url_normal": "https://pbs.twimg.com/placeholder/example-user.jpg"}