API referenceX
X profile
A profile on X with its recent posts, paged with a cursor.
The account's header record and a page of its posts.
This endpoint is also registered as twitter-profile. Both names take
the same parameters and return the same response, so use whichever your
account was set up with.
Set include_replies to include the account's replies alongside its own
posts.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 3.4s.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/twitter-profile-v4" \ -H "Content-Type: application/json" \ -d '{ "username": "NASA" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "additional": { "profile_demographics": { "created_at": "Wed Dec 19 20:20:32 +0000 2007", "description": "Making the seemingly impossible, possible. ✨", "favourites_count": 16940, "followers_count": 92352512, "friends_count": 118, "is_blue_verified": true, "listed_count": 96997, "location": "Pale Blue Dot", "media_count": 28086, "name": "NASA", "profile_banner_url": "https://pbs.twimg.com/profile_banners/11348282/1775567134", "profile_image_url_https": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB.jpg", "protected": false, "screen_name": "NASA", "statuses_count": 74178, "url": "https://t.co/9NkQJKAVks", "verified": false, "verified_type": "Government" } }, "main": [ { "caption": ".@Artemis II commander @astro_reid speaks at the @librarycongress National Book Festival 📷: https://t.co/tHPLNYnMTj https://t.co/v7ZZiVTCXv", "comment_count": 14, "creator_handle": "NASA", "hashtags": [], "in_reply_to_handle": null, "in_reply_to_post_id": null, "is_quote": false, "is_reply": false, "is_repost": true, "like_count": 467, "post_id": "2091271841851592920", "post_url": "https://x.com/NASA/status/2091271841851592920", "profile_picture_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB.jpg", "quoted_post": null, "reposted_post": { "caption": ".@Artemis II commander @astro_reid speaks at the @librarycongress National Book Festival 📷: https://t.co/tHPLNYnMTj https://t.co/v7ZZiVTCXv", "comment_count": 14, "creator_handle": "nasahqphoto", "creator_name": "NASA HQ PHOTO", "like_count": 467, "post_id": "2091190201578045724", "post_url": "https://x.com/nasahqphoto/status/2091190201578045724", "share_count": 47, "upload_timestamp": 1787413571, "view_count": 191544 }, "save_count": 24, "share_count": 47, "thumbnail_url": "https://pbs.twimg.com/media/HQVllLkWsAAhksS.jpg", "upload_timestamp": 1787433035, "video_url": null, "video_urls_by_quality": { "high": null, "low": null, "medium": null, "watermarked": null }, "view_count": 191544 }, { "caption": "From high-speed flight to the Moon, here’s what’s new in your NASA Minute:\n\n🌔 Lunar Impact\n🧑🚀 Spacewalk Repairs\n🛫 Flexible Wing Tests\n\nSee you next week! 🚀 https://t.co/tSu5z3Syyw", "comment_count": 37, "creator_handle": "NASA", "hashtags": [], "in_reply_to_handle": null, "in_reply_to_post_id": null, "is_quote": false, "is_reply": false, "is_repost": true, "like_count": 759, "post_id": "2090952103103463499", "post_url": "https://x.com/NASA/status/2090952103103463499", "profile_picture_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB.jpg", "quoted_post": null, "reposted_post": { "caption": "From high-speed flight to the Moon, here’s what’s new in your NASA Minute:\n\n🌔 Lunar Impact\n🧑🚀 Spacewalk Repairs\n🛫 Flexible Wing Tests\n\nSee you next week! 🚀 https://t.co/tSu5z3Syyw", "comment_count": 37, "creator_handle": "NASASpox", "creator_name": "Bethany Stevens", "like_count": 759, "post_id": "2090946704392483260", "post_url": "https://x.com/NASASpox/status/2090946704392483260", "share_count": 102, "upload_timestamp": 1787355516, "view_count": 192679 }, "save_count": 36, "share_count": 102, "thumbnail_url": "https://pbs.twimg.com/media/HQSIprxWoAApqyb.jpg", "upload_timestamp": 1787356804, "video_url": "https://video.twimg.com/amplify_video/2090944707954102272/vid/avc1/1080x1920/eujzPigh29Z0canP.mp4?tag=29", "video_urls_by_quality": { "high": "https://video.twimg.com/amplify_video/2090944707954102272/vid/avc1/1080x1920/eujzPigh29Z0canP.mp4?tag=29", "low": "https://video.twimg.com/amplify_video/2090944707954102272/vid/avc1/320x568/rtZm4K38goqRbJXX.mp4?tag=29", "medium": "https://video.twimg.com/amplify_video/2090944707954102272/vid/avc1/720x1280/xMbHfw4I3HIrtKoS.mp4?tag=29", "watermarked": null }, "view_count": 192679 }, "… 17 more items in the full response" ] }, "hasMore": true, "nextCursor": "DAAHCgABHQZ80PR__-8LAAIAAAATMjA4OTM2NzM0ODYwODIyNTU3NAgAAwAAAAIAAA" }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "twitter-profile-v4", "billable": true, "duration_ms": 2648 }}