API referenceX
Profile and timeline
A profile with its recent posts, paged with a cursor.
A profile's identity and counts, together with a page of its recent posts.
This endpoint is also registered as twitter-profile-v4. Both names take
the same parameters and return the same response, so use whichever your
account was set up with.
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 6.7s.
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" \ -H "Content-Type: application/json" \ -d '{ "username": "levelsio" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "additional": { "profile_demographics": { "created_at": "Mon Jul 08 09:31:59 +0000 2013", "description": "💸https://t.co/sQ0aiU7v02\n📸https://t.co/lAyoqmSBRX $80K/m\n🎮https://t.co/tF49atJ396 $44K/m\n🏡https://t.co/1oqUgfD6CZ $23K/m\n👙@X $20K/m\n🌍https://t.co/UXK5AFqCaQ $15K/m\n💾https://t.co/T74ZwJ1F0C\n🏩https://t.co/4p4dzTDVN6\n📝https://t.co/8VnHmB3uah", "favourites_count": 180922, "followers_count": 935522, "friends_count": 3181, "is_blue_verified": true, "listed_count": 9902, "location": "📕My book $7K/m 👉", "media_count": 19498, "name": "@levelsio", "profile_banner_url": "https://pbs.twimg.com/profile_banners/1577241403/1665964220", "profile_image_url_https": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau.jpg", "protected": false, "screen_name": "levelsio", "statuses_count": 178772, "url": "https://t.co/6RM0RsUXfe", "verified": false, "verified_type": "" } }, "main": [ { "caption": "The more dysfunctional public services are the more you force people to go private and fend for themselves\n\nThis moves you into the direction of Brazilification\n\nRich people will pay for their own walled condos with private security, bulletproof cars, private healthcare, and everything will be high quality but only for… (+967 chars)", "comment_count": 19, "creator_handle": "levelsio", "hashtags": [], "in_reply_to_handle": null, "in_reply_to_post_id": null, "is_quote": true, "is_reply": false, "is_repost": false, "like_count": 228, "post_id": "2091478785031848075", "post_url": "https://x.com/levelsio/status/2091478785031848075", "profile_picture_url": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau.jpg", "quoted_post": { "caption": "I think most high skilled Europeans are happy to pay (even high) taxes\n\nThat is, if the government does a great job like Singapore or Dubai or Korea or Japan and most things work well\n\nYou pay the government for a service and you get safe cities, great public services and great healthcare back\n\nOh and letting people ju… (+420 chars)", "comment_count": 37, "creator_handle": "levelsio", "creator_name": "@levelsio", "like_count": 364, "post_id": "2091476185876254816", "post_url": "https://x.com/levelsio/status/2091476185876254816", "share_count": 22, "upload_timestamp": 1787481755, "view_count": 52770 }, "reposted_post": null, "save_count": 37, "share_count": 19, "thumbnail_url": null, "upload_timestamp": 1787482374, "video_url": null, "video_urls_by_quality": { "high": null, "low": null, "medium": null, "watermarked": null }, "view_count": 21459 }, { "caption": "I think most high skilled Europeans are happy to pay (even high) taxes\n\nThat is, if the government does a great job like Singapore or Dubai or Korea or Japan and most things work well\n\nYou pay the government for a service and you get safe cities, great public services and great healthcare back\n\nOh and letting people ju… (+420 chars)", "comment_count": 37, "creator_handle": "levelsio", "hashtags": [], "in_reply_to_handle": null, "in_reply_to_post_id": null, "is_quote": true, "is_reply": false, "is_repost": false, "like_count": 364, "post_id": "2091476185876254816", "post_url": "https://x.com/levelsio/status/2091476185876254816", "profile_picture_url": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau.jpg", "quoted_post": { "caption": "This is very interesting and expected\n\nEuropean governments and thus the EU too is losing lots of tax income from Europeans fleeing\n\nNext on the agenda is the European Exit Tax and after that I think they will try to add Worldwide Income Tax (like the US already has) meaning it doesn't matter where you live in the worl… (+455 chars)", "comment_count": 27, "creator_handle": "levelsio", "creator_name": "@levelsio", "like_count": 581, "post_id": "2091474481554334169", "post_url": "https://x.com/levelsio/status/2091474481554334169", "share_count": 38, "upload_timestamp": 1787481348, "view_count": 80403 }, "reposted_post": null, "save_count": 29, "share_count": 22, "thumbnail_url": null, "upload_timestamp": 1787481755, "video_url": null, "video_urls_by_quality": { "high": null, "low": null, "medium": null, "watermarked": null }, "view_count": 52770 }, "… 18 more items in the full response" ] }, "hasMore": true, "nextCursor": "s:DAADDAABCgABHQZs37UWwIsKAAIdA9bxUhcR4wAIAAIAAAACCAADAAAAAAgABAAAAAAKAAUdBnzTYwAnEAoABh0GfNNi_9jwCwAHAAAA8EVtUEM2d0FBQWZRL2dHSk4wdkdwL0FBQUFCUWRBOWJ4VWhjUjR4MEVKai9BMTFBN0hRVTdVSGxXRVZJZEJtcUNpMWZRWUIwRUpPaDlWbEN4SFFVUlZodlhFREVkQkJoL3lWWVE3aDBFWkFSV1Y1QjhIUVpvOWJuWElka2RCSGJGS0JkZ3pSMEZvN0w4VmtHc0hRUVlXelJYc1pnZEEvMm… (+110 chars)" }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "twitter-profile", "billable": true, "duration_ms": 5999 }}