x/
user-replies

The X User Replies API collects the replies an X account has written from its username, newest first, each with the post it answers: that post's text, author, link and time in the same row.

X User Replies API

Username input
Replies the account wrote
Answered post included
0.7 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
usernameRequiredThe X username whose replies to collect, with or without the leading @.
results_limitOptionalHow 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.

  1. POST {"username": "elonmusk", "results_limit": 20} to /v1/x/user-replies.
  2. Poll GET /v1/tasks/{task_id} until status changes to succeeded.
  3. 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.

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.

Explore other platforms

Combine X data with public data from other supported social platforms.

X User Replies API — FAQ

X User Replies API is a programmatic interface for collecting the replies an X account has written, read from its Replies tab by username. It returns each reply's text, engagement, media and conversation IDs, together with the post it answers in in_reply_to.

Submit their username and set results_limit to the number of replies you want. The replies arrive newest first, and you continue with next_cursor while has_more is true.

X User Replies API returns replies written by one account, wherever it posted them. X Post Replies API returns the replies other people left under the post URLs you submit.

Yes. in_reply_to gives that post's id, url and publish time, and adds its text and author when the post is publicly visible.

From 1 to 1,000 replies for one username, with 20 as the default. To cover several accounts, send one request per username.