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

# User Tweets

`POST /user-tweets`

Returns a list of tweets posted by a specific user. You provide the user’s profile link, and the endpoint returns tweet data such as text, post time, engagement counts, view count, and basic context like replies, quotes, and retweets (with nested tweet/user info when available).

With each request returning up to 20 tweets. If there are more results, you will also receive a next\_cursor to load the next page.

Use cases:

SaaS dashboards showing a user’s latest posts; analytics tools collecting tweets for engagement tracking and content analysis; marketing teams reviewing a creator’s recent posts before outreach; moderation or compliance tools checking recent activity for specific keywords; developers building infinite scroll or batch processing using next\_cursor.

## Request body

- TweetsUserTweetsReq
  - `link` string
  - `next_cursor` string
  - `user_id` string

## Response `200`

OK

- CommonTweetsResponse
  - `next_cursor` string
  - `tweets` CommonTweet[]
    - `bookmark_count` integer
    - `conversation_id_str` string
    - `created_at` string
    - `entities` CommonTweetEntity[]
      - `link` string
      - `preview` string
      - `type` string
    - `full_text` string
    - `id` string
    - `in_reply_to_tweet_id` string
    - `in_reply_to_username` string
    - `is_quote_status` boolean
    - `is_replies_limited` boolean
    - `is_reply` boolean
    - `lang` string
    - `likes_count` integer
    - `quote_count` integer
    - `quoted_status` CommonTweet — recursive
    - `reply_count` integer
    - `retweet_count` integer
    - `retweeted_status` CommonTweet — recursive
    - `user` CommonUser
      - `bio_urls` string[]
      - `can_dm` boolean
      - `created_at` string
      - `description` string
      - `display_name` string
      - `favourites_count` integer
      - `followers_count` integer
      - `followings_count` integer
      - `id` string
      - `location` string
      - `media_count` integer
      - `pinned_tweet_ids` string[]
      - `possibly_sensitive` boolean
      - `profile_background_image_url` string
      - `profile_image_url` string
      - `protected` boolean
      - `tweets_count` integer
      - `username` string
      - `verified` boolean
    - `view_count` integer

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/sorsa/apis/api-sorsa-io-2.md) · [All operations](https://skmtc.net/sorsa/apis/api-sorsa-io-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sorsa/api-sorsa-io-2/revisions/3d7215317ba1/schema)
