X (Twitter) Community Search API. Communities matching your search.

const params = new URLSearchParams({
  query: "build in public",
});
const res = await fetch(`https://socialtap.dev/v1/x/search_communities?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);

import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/x/search_communities",
    params={"query": "build in public"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/x/search_communities")
uri.query = URI.encode_www_form('query' => 'build in public')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'query' => 'build in public',
]);
$ch = curl_init('https://socialtap.dev/v1/x/search_communities?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("query", "build in public")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/x/search_communities?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Page  json.RawMessage `json:"page"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}

curl -G 'https://socialtap.dev/v1/x/search_communities' \
  --data-urlencode 'query=build in public' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "data": [
    {
      "approximate_fields": [
        "community.title"
      ],
      "community": {
        "avatar_url": null,
        "description": null,
        "id": null,
        "metrics": {
          "member_count": null
        },
        "name": null,
        "privacy": null,
        "title": "Build in Public",
        "url": "https://x.com/i/communities/1493446837214187523"
      },
      "details": null,
      "hashtag": null,
      "matched_url": "https://x.com/i/communities/1493446837214187523",
      "place": null,
      "platform": "x",
      "platform_specific": {},
      "position": 0,
      "post": null,
      "profile": null,
      "snippet": "My goal for buildinpublic.com is to become the definitive database of all makers and their projects To that end, you can now add your projects to buildinpublic.com To verify ownership and get the verified checkmark, just add the <meta name=\"twitter:creator\" Show more",
      "sound": null,
      "title": "Build in Public Community / X",
      "type": "community",
      "unknown_fields": [],
      "url": "https://x.com/i/communities/1493446837214187523"
    },
    {
      "approximate_fields": [
        "community.description",
        "community.metrics.member_count",
        "community.title"
      ],
      "community": {
        "avatar_url": null,
        "description": "Here is a open community for Indie hackers and SaaS Founders who are building in public, come and share your daily journey.",
        "id": null,
        "metrics": {
          "member_count": 392
        },
        "name": null,
        "privacy": null,
        "title": "Build In Public - SaaS",
        "url": "https://x.com/i/communities/1828843041869713562"
      },
      "details": null,
      "hashtag": null,
      "matched_url": "https://x.com/i/communities/1828843041869713562",
      "place": null,
      "platform": "x",
      "platform_specific": {},
      "position": 1,
      "post": null,
      "profile": null,
      "snippet": "Here is a open community for Indie hackers and SaaS Founders who are building in public, come and share your daily journey.",
      "sound": null,
      "title": "Build In Public - SaaS Community on X - 392 Members",
      "type": "community",
      "unknown_fields": [],
      "url": "https://x.com/i/communities/1828843041869713562"
    },
    {
      "approximate_fields": [
        "community.description",
        "community.title"
      ],
      "community": {
        "avatar_url": null,
        "description": "The community for @BuildinPublic__ Bootstrappers, No Code/Low Code, and for Founders to share their builds & experiences 🚀",
        "id": null,
        "metrics": {
          "member_count": null
        },
        "name": null,
        "privacy": null,
        "title": "BuildinPublic",
        "url": "https://x.com/i/communities/1495042358068477955"
      },
      "details": null,
      "hashtag": null,
      "matched_url": "https://x.com/i/communities/1495042358068477955",
      "place": null,
      "platform": "x",
      "platform_specific": {},
      "position": 2,
      "post": null,
      "profile": null,
      "snippet": "The community for @BuildinPublic__ Bootstrappers, No Code/Low Code, and for Founders to share their builds & experiences 🚀",
      "sound": null,
      "title": "BuildinPublic on X",
      "type": "community",
      "unknown_fields": [],
      "url": "https://x.com/i/communities/1495042358068477955"
    }
  ],
  "page": {
    "has_more": true,
    "next_cursor": "c1.EXAMPLE_CURSOR",
    "next_cursor_expires_at": "2026-10-26T12:00:00Z",
    "end_reason": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "x",
    "source": "web_search",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 1139,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": null,
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}

import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.x.searchCommunities.list({ query: "build in public" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws Exception {
        String query = "query=" + encode("build in public");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/x/search_communities?" + query))
            .header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
        if (response.statusCode() >= 400) throw new RuntimeException(response.body());
        System.out.println(response.body());
    }

    static String encode(String value) {
        return URLEncoder.encode(value, StandardCharsets.UTF_8);
    }
}

using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));

var query = string.Join("&",
    "query=" + Uri.EscapeDataString("build in public"));
var res = await http.GetAsync("https://socialtap.dev/v1/x/search_communities?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
    var error = body.RootElement.GetProperty("error");
    throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = reqwest::blocking::Client::new()
        .get("https://socialtap.dev/v1/x/search_communities")
        .query(&[("query", "build in public")])
        .header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
        .send()?;
    let ok = res.status().is_success();
    let body: serde_json::Value = res.json()?;
    if !ok {
        return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
    }
    println!("{} {}", body["data"], body["meta"]["credits_charged"]);
    Ok(())
}