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.
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 }}