Find X communities by keyword with the Twitter API

{
  "communities": [
    {
      "id": "1472105760389668865",
      "name": "Tech Twitter",
      "member_count": 121468,
      "is_nsfw": false,
      "primary_topic": {
        "name": "Technology"
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "WzM1LjUxMjQ5N10="
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

communities

find

Find X communities by keyword with the Twitter API

curl --request GET \
  --url https://xquik.com/api/v1/x/communities/find

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/communities/find"

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

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

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

	fmt.Println(string(body))

}

{
  "communities": [
    {
      "id": "<string>",
      "name": "<string>",
      "member_count": 123,
      "is_nsfw": true,
      "primary_topic": {},
      "banner_url": "<string>",
      "banner": {},
      "membersFacepile": [
        {}
      ]
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

1 credit per Community returned · All plans from $0.00012/credit

curl -G https://xquik.com/api/v1/x/communities/find \
  --data-urlencode "q=artificial intelligence" \
  -H "x-api-key: xq_your_api_key_here" | jq

const params = new URLSearchParams({ q: "artificial intelligence" });
const response = await fetch(`https://xquik.com/api/v1/x/communities/find?${params}`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
for (const community of data.communities) {
  process.stdout.write(`${community.id} ${community.name} ${community.member_count}\n`);
}

import requests

response = requests.get(
    "https://xquik.com/api/v1/x/communities/find",
    params={"q": "artificial intelligence"},
    headers={"x-api-key": "xq_your_api_key_here"},
)
for community in response.json()["communities"]:
    print(community["id"], community["name"], community["member_count"])

Use GET /x/communities/find to find the X Communities that match a keyword. Each Community costs 1 credit. A page without Communities costs nothing. To search the posts inside 1 Community, use Community tweet search.

Find a Community, then read it

Send a keyword as q, such as artificial intelligence.
Pick a Community from the list by its name and member_count.
Pass its id to Community details for its rules, creator, and admin.
Pass the same id to Community tweets or Community media.

Results keep X’s order. X may order them differently for each request. Follow next_cursor for more Communities.

Query parameters

string

required

Keyword to find Communities by, such as ai. Alias: query.

string

Pagination cursor from a previous response. Omit it for the first page. A cursor X refuses or that expired returns a free 400 invalid_cursor. Start again without it.

integer

Most Communities to return on this page. Your credit balance can return fewer. Aliases: limit, count, and max_results.

Headers

string

Send a full Xquik account API key.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

object[]

Communities that match the keyword, in X’s order. Community object fields.

string

Community ID. Pass it to the other Community endpoints.

string

Community name.

number

Total member count.

boolean

Whether X marks the Community sensitive.

object

The topic X files the Community under, with its name.

string

Banner image URL. Omitted if unavailable.

object

Banner url, width, height, main colors, and the focus area X keeps in view. Omitted if unavailable.

object[]

Members X previews beside the member count, each with its id and profilePicture.

boolean

Whether another page of Communities follows.

string

Cursor for the next page. Empty at the end.

{
  "communities": [
    {
      "id": "1724390935406981529",
      "name": "Artificial Intelligence + Tech",
      "member_count": 17092,
      "is_nsfw": false,
      "primary_topic": { "name": "Artificial Intelligence" },
      "banner_url": "https://pbs.twimg.com/community_banner_img/example.jpg",
      "membersFacepile": [
        {
          "id": "133938408",
          "profilePicture": "https://pbs.twimg.com/profile_images/example.jpg"
        }
      ]
    }
  ],
  "has_next_page": true,
  "next_cursor": "WzIwNC42OTQ3XQ=="
}

400 Missing keyword or invalid cursor

{ "error": "missing_query", "message": "Search query required. Use q." }

Send a keyword as q. A cursor X can’t read returns invalid_cursor:

{
  "error": "invalid_cursor",
  "message": "Cursor invalid or expired. Start again without cursor, then use next_cursor."
}

Start again without cursor. Both answers are free.

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

402 Payment required

Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.

502 X API unavailable

{ "error": "x_api_unavailable" }

The read failed. Retry after a short delay.

503 Service busy

Xquik is busy. Wait for Retry-After, then retry.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

Use Retry-After when present. Otherwise, use the JSON retryAfter field.

424 Dependency failed

The opt-in normalized contract returns 424 when the read fails. Send xquik-api-contract: 2026-04-29 to opt in. Default v1 returns 502.

Find X Communities questions

How do I find Twitter Communities about a topic?

Send the topic as q, such as q=web3. Or list the most popular Communities of a topic with Popular communities.

How is this different from Community tweet search?

This endpoint returns Communities. Community tweet search returns posts inside 1 Community you already know.

How much does it cost?

Each returned Community costs 1 credit. A page without Communities costs nothing.

Does this replace X’s official API?

No. This page documents Xquik, an independent third-party service. It does not document X’s official API.

Next steps. Community details reads a Community’s rules, creator, and admin by its id.

{
  "communities": [
    {
      "id": "1472105760389668865",
      "name": "Tech Twitter",
      "member_count": 121468,
      "is_nsfw": false,
      "primary_topic": {
        "name": "Technology"
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "WzM1LjUxMjQ5N10="
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

Find X communities by keyword with the Twitter API

curl --request GET \
  --url https://xquik.com/api/v1/x/communities/find

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/communities/find"

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

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

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

	fmt.Println(string(body))

}

{
  "communities": [
    {
      "id": "<string>",
      "name": "<string>",
      "member_count": 123,
      "is_nsfw": true,
      "primary_topic": {},
      "banner_url": "<string>",
      "banner": {},
      "membersFacepile": [
        {}
      ]
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Find X communities by keyword with the Twitter API

Find a Community, then read it

Query parameters

Headers

Response

200 OK

400 Missing keyword or invalid cursor

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Find X Communities questions

How do I find Twitter Communities about a topic?

How is this different from Community tweet search?

How much does it cost?

Does this replace X’s official API?

​Find a Community, then read it

​Query parameters

​Headers

​Response

​200 OK

​400 Missing keyword or invalid cursor

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

​Find X Communities questions

​How do I find Twitter Communities about a topic?

​How is this different from Community tweet search?

​How much does it cost?

​Does this replace X’s official API?

Find a Community, then read it

Query parameters

Headers

Response

200 OK

400 Missing keyword or invalid cursor

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Find X Communities questions

How do I find Twitter Communities about a topic?

How is this different from Community tweet search?

How much does it cost?

Does this replace X’s official API?