---
title: "User Replies"
method: POST
path: "/user-replies"
tags: ["Tweets"]
---

# User Replies

`POST /user-replies`

## Request

- Base URL: `https://api.sorsa.io/v3`
- URL: `https://api.sorsa.io/v3/user-replies`
- Auth: API key in header `ApiKey`
- TypeScript: <https://skmtc.dev/sorsa/apis/api-sorsa-io/docs/user-replies/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of replies posted by a specific user. Up to 20 items per page. Each tweet includes text, creation date, engagement metrics, view count, and nested data for quotes and retweets when available. Provide either `link` (profile URL), `username` or `user_id`.

## Request body

- TweetsUserTimelineReq
  - `next_cursor` string: Pagination cursor from a previous response.
  - `user_id` string: Numeric Twitter/X user ID. Provide either `link` or `user_id`.
  - `user_link` string: Full URL of the user's profile. Provide either `link` or `user_id`.
  - `username` string: Twitter/X handle of the user. Provide either `link` or `username`.

## Response `200`

OK

- CommonTweetsResponse
  - `next_cursor` string: Cursor for fetching the next page of results. Null or absent if no more pages.
  - `tweets` CommonTweet[]: Array of tweet objects.
    - `bookmark_count` integer: Number of times the tweet has been bookmarked.
    - `conversation_id_str` string: ID of the root tweet in the conversation thread.
    - `created_at` string: Tweet publication date in ISO 8601 format.
    - `entities` CommonTweetEntity[]: Media, links, and other embedded entities attached to the tweet.
      - `link` string: Direct URL of the entity.
      - `preview` string: Preview or thumbnail URL for the entity.
      - `type` string: Entity type (e.g. `photo`, `video`, `url`).
    - `full_text` string: Full text content of the tweet.
    - `id` string: Unique tweet ID.
    - `in_reply_to_tweet_id` string: ID of the tweet this tweet is replying to. Null if not a reply.
    - `in_reply_to_username` string: Username of the account this tweet is replying to.
    - `is_quote_status` boolean: Whether this tweet quotes another tweet.
    - `is_replies_limited` boolean: Whether replies to this tweet are restricted by the author.
    - `is_reply` boolean: Whether this tweet is a reply to another tweet.
    - `lang` string: Detected language code of the tweet (e.g. `en`, `es`).
    - `likes_count` integer: Number of likes on the tweet.
    - `made_with_ai` boolean: Whether the tweet was made with AI.
    - `paid_partnership` boolean: Whether the tweet is a paid partnership.
    - `quote_count` integer: Number of quote tweets.
    - `quoted_status` CommonTweet (recursive)
    - `reply_count` integer: Number of replies to the tweet.
    - `retweet_count` integer: Number of retweets.
    - `retweeted_status` CommonTweet (recursive)
    - `user` CommonUser
      - `bio_urls` string[]: URLs found in the user's bio.
      - `can_dm` boolean: Whether the account accepts direct messages.
      - `created_at` string: Account creation date in ISO 8601 format.
      - `description` string: Profile bio text.
      - `display_name` string: User's display name.
      - `favourites_count` integer: Total number of tweets this user has liked.
      - `followers_count` integer: Number of accounts following this user.
      - `followings_count` integer: Number of accounts this user follows.
      - `id` string: Unique Twitter/X user ID.
      - `location` string: Location string from the user's profile.
      - `media_count` integer: Total number of media items posted by this user.
      - `pinned_tweet_ids` string[]: IDs of the user's pinned tweets.
      - `possibly_sensitive` boolean: Whether the account is flagged as possibly containing sensitive content.
      - `profile_background_image_url` string: URL of the user's profile background image.
      - `profile_image_url` string: URL of the user's avatar image.
      - `protected` boolean: Whether the account's tweets are protected (private).
      - `tweets_count` integer: Total number of tweets posted by this user.
      - `username` string: Current Twitter/X handle (without @).
      - `verified` boolean: Whether the account has a verified badge.
    - `view_count` integer: Number of views (impressions).

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2026-10-08** `0c8d4b42892e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sorsa/apis/api-sorsa-io/changes/user-replies/post.md)

---

[API](https://skmtc.dev/sorsa/apis/api-sorsa-io.md) - [All operations](https://skmtc.dev/sorsa/apis/api-sorsa-io/llms.txt) - [OpenAPI document](https://skmtc.dev/sorsa/apis/api-sorsa-io/revisions/0c8d4b42892e?raw)