SOsorsa
Community

Search Community Tweets

Changed on

Searches for tweets within a specific Twitter/X Community by keyword. Up to 20 matching tweets per page. Results can be sorted by popular or latest. Each tweet includes text, creation date, engagement metrics, and author profile. Provide community_id or community_link; community_id takes precedence. Both fields accept an ID or community URL.

post/community-search-tweets

Request

Request body

community_idstring

Community ID or URL. Takes precedence over community_link.

community_linkstring

Community URL or ID. Required when community_id is absent.

next_cursorstring

Pagination cursor from a previous response.

orderstring

Sort order: popular or latest.

querystring

Search query string.

Example request

{
  "community_id": "1966045657589813686",
  "community_link": "https://x.com/i/communities/1966045657589813686",
  "next_cursor": "123",
  "order": "popular",
  "query": "elonmusk"
}

Response

OK

next_cursorstring

Cursor for fetching the next page of results. Null or absent if no more pages.

Example response

{
  "tweets": [
    {
      "bookmark_count": 15,
      "conversation_id_str": "1782368585664626774",
      "created_at": "2024-01-15T10:30:00Z",
      "entities": [
        {
          "link": "https://t.co/example",
          "preview": "https://pbs.twimg.com/preview",
          "type": "photo"
        }
      ],
      "full_text": "Hello world",
      "id": "1782368585664626774",
      "in_reply_to_tweet_id": "1782368585664626000",
      "in_reply_to_username": "username",
      "lang": "en",
      "likes_count": 200,
      "quote_count": 5,
      "reply_count": 10,
      "retweet_count": 50,
      "user": {
        "created_at": "2009-06-02T20:12:29Z",
        "description": "Bio text",
        "display_name": "Elon Musk",
        "favourites_count": 1200,
        "followers_count": 100000,
        "followings_count": 500,
        "id": "44196397",
        "location": "Austin, TX",
        "media_count": 300,
        "profile_background_image_url": "https://pbs.twimg.com/profile_banners/44196397/123",
        "profile_image_url": "https://pbs.twimg.com/profile_images/123/photo.jpg",
        "tweets_count": 5000,
        "username": "elonmusk",
        "verified": true
      },
      "view_count": 10000
    }
  ]
}

Changes

  • c52ef80b2cb3Revision changes
    • info

      added the new optional request property

    • info

      the request property became optional