---
title: "Quote Tweets"
method: POST
path: "/quotes"
tags: ["Tweets"]
---

# Quote Tweets

`POST /quotes`

Returns a paginated list of tweets that quoted the specified tweet. Up to 20 results per page. Each quote tweet includes the added commentary text, creation date, engagement metrics, and the quoting user's profile.

## Request body

- TweetsQuotesReq
  - `next_cursor` string — Pagination cursor from a previous response.
  - `tweet_link` string — Full URL of the tweet (e.g. `https://x.com/user/status/123`) or just the tweet ID.

## 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

---

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