Search Communities

Search for Twitter communities by name, description, or keywords. Returns matching communities with comprehensive information including member count, join policy, and description. Useful for discovering communities related to specific topics.

GET /v1/twitter/communities/search

Search communities

cURL

curl --request GET \
  --url https://scrapebadger.com/v1/twitter/communities/search \
  --header 'x-api-key: <api-key>'

200

{
  "data": [
    {
      "id": "1234567890",
      "name": "Web Developers",
      "description": "<string>",
      "member_count": 123,
      "is_member": true,
      "is_nsfw": true,
      "invites_policy": "<string>",
      "created_at": 123,
      "created_at_datetime": "<string>",
      "banner": {
        "url": "<string>",
        "width": 123,
        "height": 123
      },
      "creator_id": "<string>",
      "creator_username": "<string>",
      "creator_name": "<string>",
      "admin_id": "<string>",
      "admin_username": "<string>",
      "admin_name": "<string>",
      "rules": [
        {
          "name": "<string>",
          "description": "<string>"
        }
      ]
    }
  ],
  "next_cursor": "<string>"
}

Authorizations

x-api-key · string · header · required

Your ScrapeBadger API key. You can find this in your dashboard at https://scrapebadger.com/dashboard/api-keys.

Query Parameters

query · string · required

Search query to match against community names and descriptions.

Example:

"web development"

cursor · string

Pagination cursor for fetching the next page of results.

Response

200

application/json

Successfully retrieved communities.

Paginated list of communities.

data · object[] | null

Array of community objects.

Show child attributes

next_cursor · string | null

Cursor for fetching the next page. Null if no more results.