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