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

import requests

url = "https://scrapebadger.com/v1/twitter/communities/search"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://scrapebadger.com/v1/twitter/communities/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://scrapebadger.com/v1/twitter/communities/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://scrapebadger.com/v1/twitter/communities/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/twitter/communities/search")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://scrapebadger.com/v1/twitter/communities/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

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>"
}

{
  "error": "Invalid or missing API key"
}

{
  "error": "Insufficient credits"
}

{
  "error": "Rate limit exceeded. Please retry after a short delay."
}

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.