Skip to main content
GET
/
x
/
users
/
{id}
/
replies
Get user replies timeline
curl --request GET \
  --url https://xquik.com/api/v1/x/users/{id}/replies \
  --header 'x-api-key: <api-key>'
Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page or ID list, Xquik returns fewer results. If zero paid results are affordable, it returns 402 insufficient_credits.
1 credit per tweet returned · All plans from $0.00012/credit · Accepts MPP
Get user replies timeline is the dedicated With Replies endpoint for one public X profile. Use it when replies must be included by default instead of adding includeReplies=true to GET /api/v1/x/users/{id}/tweets.
# Username With Replies timeline
curl https://xquik.com/api/v1/x/users/elonmusk/replies \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

# Numeric user ID With Replies timeline
curl https://xquik.com/api/v1/x/users/44196397/replies \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

# Include parent tweet context for reply rows
curl -G https://xquik.com/api/v1/x/users/elonmusk/replies \
  --data-urlencode "includeParentTweet=true" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

# Page 2 - pass next_cursor from the previous response
curl -G https://xquik.com/api/v1/x/users/elonmusk/replies \
  --data-urlencode "cursor=abc123" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

​
User replies handoff

Use GET /x/users/{id}/replies when a support queue, community workflow, research job, or agent needs a profile’s With Replies timeline. This endpoint accepts either a username or numeric user ID, includes replies by default, and returns one JSON page at a time. Store source_user_id_or_username, tweet_id, text, author fields, created_at, reply context, conversation_id, engagement counts, media_urls, page_cursor, has_next_page, and next_cursor. Treat next_cursor as opaque and pass it back as cursor only when has_next_page is true.

​
Build a With Replies sync

Use these checkpoints when a timeline sync needs reply rows, parent context, and resumable cursor state.

Dedicated replies route

Call GET /x/users/{id}/replies when every page should include replies by default.

Parent context

Set includeParentTweet=true when reply rows need the parent tweet for triage, moderation, or conversation joins.

Route chooser

Use Get user timeline when replies are optional. Use this route when replies are required.

Cursor checkpoint

Persist page_cursor, next_cursor, and has_next_page before requesting another page.
{
  "timeline_job_id": "profile-replies-q2",
  "timeline_route": "GET /api/v1/x/users/{id}/replies",
  "user_id_or_username": "elonmusk",
  "include_parent_tweet": true,
  "cursor_param": "cursor",
  "page_cursor": "",
  "next_cursor": "DAADDAABCgABF...",
  "has_next_page": true,
  "fallback_route": "GET /api/v1/x/users/{id}/tweets?includeReplies=true"
}

​
Which timeline endpoint?

  • Use GET /api/v1/x/users/{id}/replies for one user’s With Replies timeline. Replies are included by default.
  • Use GET /api/v1/x/users/{id}/tweets for one user’s profile timeline when replies are optional or should be excluded by default.
  • Add includeParentTweet=true when reply rows need parent tweet context.
  • Use GET /api/v1/x/users/{id}/media when every returned row should contain profile media.
  • Use GET /api/v1/x/tweets/{id}/replies for replies under one specific tweet.

​
Path parameters

​
id
string
required
X username or numeric user ID. Use a username such as elonmusk when the profile handle is known, or a numeric ID such as 44196397 when you store stable user IDs.

​
Query parameters

​
cursor
string
Pagination cursor for the With Replies timeline. Omit it for the first page, then pass the next_cursor value from the previous response to fetch the next page.
​
includeParentTweet
boolean
default:"false"
Include parent tweet context for returned replies. Defaults to false; set it to true when replies need conversation context.

​
Tweet result filters

These optional filters apply to tweets[] returned by this route. They keep the same user target and filter rows after each page is fetched, so selective filters can return fewer rows than an unfiltered page.
​
fromUser
string
Filter to tweets authored by this username. The @ prefix is optional.
​
toUser
string
Filter to replies directed to this username.
​
mentioning
string
Filter to tweets that mention this username.
​
language
string
Filter by tweet language code, such as en, tr, or es.
​
sinceDate
string
Filter to tweets created on or after this date or timestamp.
​
untilDate
string
Filter to tweets created before this date or timestamp. A YYYY-MM-DD value includes the whole day before the boundary.
​
mediaType
string
Filter by attached media or links. Values: images, videos, gifs, media, links, none.
​
minFaves
integer
Minimum like count.
​
minRetweets
integer
Minimum retweet count.
​
minReplies
integer
Minimum reply count.
​
minQuotes
integer
Minimum quote count.
​
verifiedOnly
boolean
When true, only return tweets from verified authors.
​
replies
string
Reply mode. Values: include, exclude, only.
​
retweets
string
Retweet mode. Values: include, exclude, only.
​
quotes
string
Quote mode. Values: include, exclude, only.
​
exactPhrase
string
Exact text that must appear in the tweet.
​
excludeWords
string
Words or quoted phrases to exclude from returned tweets. Separate with spaces, commas, or lines.
​
anyWords
string
Words or quoted phrases where at least 1 term must appear in the tweet. Separate with spaces, commas, or lines.
​
hashtags
string
Hashtags to match. Separate with spaces, commas, or lines. The # prefix is optional.
​
cashtags
string
Cashtags to match. Separate with spaces, commas, or lines. The $ prefix is optional.
​
url
string
URL substring or domain that must appear in tweet URL entities.
​
conversationId
string
Filter to tweets in this conversation thread.
​
inReplyToTweetId
string
Filter to replies to this tweet ID.
​
quotesOfTweetId
string
Filter to quote tweets of this tweet ID.
​
retweetsOfTweetId
string
Filter to retweets of this tweet ID.

​
Headers

​
x-api-key
string
required
Your API key. Session cookie authentication is also supported.

​
Response

​
tweets
object[]
Array of tweets from the user’s With Replies timeline.
​
has_next_page
boolean
Whether more results are available.
​
next_cursor
string
Opaque cursor for the next page. Empty string when no more results.
{
  "tweets": [
    {
      "id": "1893456789012345678",
      "text": "Reply tweet content",
      "createdAt": "2026-02-24T10:00:00.000Z",
      "isReply": true,
      "inReplyToId": "1893456000000000000",
      "conversationId": "1893456000000000000",
      "likeCount": 500,
      "retweetCount": 120,
      "replyCount": 45,
      "viewCount": 25000,
      "url": "https://x.com/elonmusk/status/1893456789012345678",
      "author": {
        "id": "44196397",
        "username": "elonmusk",
        "name": "Elon Musk",
        "followers": 150000000,
        "verified": true,
        "profilePicture": "https://pbs.twimg.com/profile_images/example.jpg"
      },
      "media": [{ "type": "photo", "mediaUrl": "https://pbs.twimg.com/media/example.jpg" }]
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAADDAABCgABF..."
}
Related: Get user timeline · Tweet replies · User media
Last modified on June 20, 2026