---
title: "Search Tweets Advanced"
method: POST
path: "/search-tweets"
tags: ["Search"]
---

# Search Tweets Advanced

`POST /search-tweets`

Works the same way as Advanced Search in Twitter/X.

Searches for tweets that match a given text query. You pass a query parameter, and the endpoint returns up to 20 matching tweets per request. Each result includes the tweet text, creation date, engagement metrics, conversation details, and basic author information.

Results can be sorted by popularorlatest. If more results are available, a next\_cursor is returned to load the next page.

The query syntax works the same way as Twitter/X Advanced Search. You can use operators like from:, to:, since:, until:, exact phrases, hashtags, and other filters to narrow down results if needed. For more examples of supported operators and query patterns, see: https://github.com/igorbrigadir/twitter-advanced-search

Use cases:

Analytics platforms tracking keywords and trends; marketing teams monitoring brand mentions or campaign phrases; research tools collecting filtered datasets (for example, tweets from a specific account during a date range); SaaS products building custom search dashboards; developers adding search functionality with cursor-based pagination.

## Request body

- SearchSearchTweetsReq
  - `next_cursor` string
  - `order` string
  - `query` 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)