X User Replies
The Replies tab of an X (Twitter) profile holds the replies an account has written to other tweets, newest first, each tied to a conversation and to the post it answers, along with that post's author and text. Seen side by side, replies and the posts they answer show whom an account talks to, what it says away from its main timeline and how it handles questions and criticism.
X User Replies API Features
- Replies written by one accountSend a username to the X User Replies API, the leading @ optional, and receive the replies that account posted, read from its Replies tab and ordered newest first.
- The answered post in the same rowin_reply_to carries the id, url, text, author and published_at of the post each reply responds to, so every exchange can be read straight from the result.
- Conversation and parent IDsconversation_id and in_reply_to_id tie each reply to its thread and to the exact post above it, which lets you group replies by conversation.
- Reply text, media and engagementEvery reply comes with its text, any attached images or videos, and counts of likes, comments, shares and views.
X User Replies API Parameters
| Parameters | Required | Description |
|---|---|---|
username | Required | The X username whose replies to collect, with or without the leading @. |
results_limit | Optional | How many replies to return, from 1 to 1,000. Defaults to 20. |
How to Use the X User Replies API
Submit one username to the X User Replies API and read its replies together with the posts they answer.
- POST {"username": "elonmusk", "results_limit": 20} to /v1/x/user-replies.
- Poll GET /v1/tasks/{task_id} until status changes to succeeded.
- Read replies from results.items, with the answered post in in_reply_to, and pass results.next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/x/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"elonmusk","results_limit":20}'
# in_reply_to holds the post each reply answers: its text, author, url and publish time.X User Replies API Use Cases
- Mapping whom an account talks to: Count in_reply_to.author.username across an account's replies to list the people and brands it engages with most often.
- Auditing a brand's customer-service replies: Read each reply's text next to in_reply_to.text and subtract in_reply_to.published_at from published_at to measure how quickly and how well a support account answers.
- Tracking what a public figure says in replies: Collect an executive's or politician's replies on a schedule to catch statements made inside conversations, keeping url as the source link.
- Building post-and-reply pairs for analysis: Pair in_reply_to.text with text to assemble exchange datasets for tone, stance or topic studies of how an account responds.
X User Replies API Pro Tips
- Remove the leading @handles from text before measuring sentiment or length, because a reply opens with the handle of the account it answers.
- Group replies by conversation_id to see every message the account left in one thread.
- When in_reply_to.text or its author is empty, keep the reply and store in_reply_to.url so the answered post can be looked up later.
- Use the X Post Replies API with post URLs when you need what other people replied to the account's posts; the X User Replies API covers the replies the account wrote.
Related APIs
Beyond the X User Replies API, use these APIs when you need a different type of public X data.
- Twitter Tweet Scraper API — Retrieve public post text, authors, engagement, media, hashtags, mentions, and conversation relationships from x.com or twitter.com status URLs.
- Twitter Profile Scraper API — Retrieve public account identity, biographies, avatars, cover images, account status, and visible audience statistics by username.
- Twitter User Tweets Scraper API — Collect recent public posts, authors, media, hashtags, mentions, and engagement by username with replies excluded.
- Twitter Search API — Find public posts by search expression with latest or top ordering and a configurable result limit.
- X Post Replies API — Collect public replies from X post URLs with selectable ordering, reply text, authors, visible engagement, media, and parent-post context.
- X Thread Context API — Read a post with earlier messages along its reply chain, public replies and relationship IDs.
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- Twitter Follow Checker API
- Twitter Video Transcript API