API referenceX
X comments
Replies to a Twitter/X post.
Served from X's search index, which returns the whole conversation tree, all
nesting levels, not just direct replies. Index coverage decays with post age;
the response's coverage block reports what could not be reached.
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 4.8s.
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-comments" \ -H "Content-Type: application/json" \ -d '{ "url": "https://x.com/NASA/status/2089668789218521591" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "comments": [ { "author_follower_count": 2, "author_id": "2071134637028769792", "author_name": "alves antoine", "author_profile_image": "https://pbs.twimg.com/profile_images/2071134794680020992/YRDCVDmB.jpg", "author_profile_url": "https://x.com/alvesantoidasg", "author_username": "alvesantoidasg", "author_verification_status": false, "comment_id": "2091034412821663784", "comment_images": [], "comment_text": "Wow, watching astronauts replace antennas feels like a sci‑fi upgrade. Space vibes.", "comment_url": "https://x.com/alvesantoidasg/status/2091034412821663784", "is_creator": false, "is_reply": false, "like_count": 0, "mentions": [], "parent_comment_id": null, "pinned_status": null, "published_date": 1787376428, "published_time_text": null, "replies": [], "reply_count": 0, "reply_pagination": null }, { "author_follower_count": 61, "author_id": "1604566198762471424", "author_name": "👁️Gizli İktidar19👁️", "author_profile_image": "https://pbs.twimg.com/profile_images/1839302640301387779/A_a6FEWK.jpg", "author_profile_url": "https://x.com/Gizli_iktidar19", "author_username": "Gizli_iktidar19", "author_verification_status": true, "comment_id": "2090705643057418458", "comment_images": [], "comment_text": "Hello! I finally managed to solve that mysterious puzzle. Admit it—I achieved the impossible. Believe it or not, I’m in space right now, watching Earth from a satellite. What would you like me to do? ;)", "comment_url": "https://x.com/Gizli_iktidar19/status/2090705643057418458", "is_creator": false, "is_reply": false, "like_count": 0, "mentions": [], "parent_comment_id": null, "pinned_status": null, "published_date": 1787298043, "published_time_text": null, "replies": [], "reply_count": 0, "reply_pagination": null }, "… 18 more items in the full response" ], "coverage": { "completeness": "partial", "reason": "search_index_partial", "total_reported": 352 }, "pagination": { "cursor": "c1.eyJhIjoiTkFTQSIsImMiOiJEQUFEREFBQkNnQUJIUVRZdUQxYVVDZ0tBQUlkQUxvcjlwdFE5Z0FJQUFJQUFBQUNDQUFEQUFBQUFBZ0FCQUFBQUFBS0FBVWRCbnpSQ1FBbkVBb0FCaDBHZk5FSV85andDd0FIQUFBQThFVnRVRU0yZDBGQlFXWlJMMmRIU2s0d2RrZHdMMEZCUVVGQ1VXUkJUMFZzWTFKMlFrMUNNRUprTUdJd1ZtcERiVWhSUlRSUk4xVlhhMVZqWkVFMk1qQnJSbVZSTW1nd1FYcE9WWFZHZVVOblNGRkVWa1pWY… (+389 chars)", "has_more": true }, "total": 352 }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "twitter-comments", "billable": true, "duration_ms": 4097 }}