---
title: "/community-search-tweets"
method: POST
path: "/community-search-tweets"
tags: ["Community"]
---

# /community-search-tweets

`POST /community-search-tweets`

Searches for tweets inside a specific Twitter/X Community using a text query. You must provide the community\_id and a query parameter. The endpoint returns up to 20 matching tweets per request from that community. Each result includes the tweet text, creation date, engagement metrics, conversation details, and basic author information. Results can be sorted by popular or latest. If more results are available, a next\_cursor is returned to load the next page.

Use cases:

Analytics platforms tracking keywords inside niche communities; marketing teams monitoring brand mentions within a specific community; research tools collecting topic-based discussions from selected communities; community dashboards adding keyword filtering; developers building in-community search with cursor pagination.

## Request body

- CommunitySearchCommunityTweetsReq
  - `community_link` string, required
  - `next_cursor` string
  - `order_by` 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/versions/3554485cbc56/schema)