Popular X communities by topic: Twitter API list

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

popular

Popular X communities by topic: Twitter API list

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

package main

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

func main() {

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

	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/popular \
  --data-urlencode "topic=Technology" \
  -H "x-api-key: xq_your_api_key_here" | jq

const params = new URLSearchParams({ topic: "Technology" });
const response = await fetch(`https://xquik.com/api/v1/x/communities/popular?${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/popular",
    params={"topic": "Technology"},
    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/popular to list the Communities X ranks highest under a topic. Name the topic by topicId, or by topic name in any case. Subtopics work too, such as Artificial Intelligence. Each Community costs 1 credit.

Pick a topic

Community topics lists every topic and subtopic with its ID. Send a name, such as topic=gaming, or an ID, such as topicId=701. topicId wins when you send both. A missing or unknown topic returns 400 invalid_community_topic. Its message lists the topic names to send. It costs nothing.

Query parameters

string

Topic or subtopic ID from Community topics, such as 301. Wins over topic.

string

Topic or subtopic name in any case, such as technology. Send this or topicId.

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[]

The topic’s most popular Communities, 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": "1472105760389668865",
      "name": "Tech Twitter",
      "member_count": 121468,
      "is_nsfw": false,
      "primary_topic": { "name": "Technology" },
      "banner_url": "https://pbs.twimg.com/community_banner_img/example.jpg"
    }
  ],
  "has_next_page": true,
  "next_cursor": "WzM1LjUxMjQ5N10="
}

400 Invalid community topic or cursor

{
  "error": "invalid_community_topic",
  "message": "Unknown topic. Use 1 of these or a subtopic from GET /x/communities/topics: Sports, Technology, Art."
}

The real message lists every topic name. 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.

Popular X Communities questions

Which topics can I send?

Every topic and subtopic that Community topics lists, by name or ID.

Are the results the same for everyone?

X ranks them, so the list can change between requests.

How much does it cost?

Each returned Community costs 1 credit. An unknown topic 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."
}

Popular X communities by topic: Twitter API list

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

package main

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

func main() {

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

	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

Popular X communities by topic: Twitter API list

Pick a topic

Query parameters

Headers

Response

200 OK

400 Invalid community topic or cursor

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Popular X Communities questions

Which topics can I send?

Are the results the same for everyone?

How much does it cost?

Does this replace X’s official API?

​Pick a topic

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid community topic or cursor

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

​Popular X Communities questions

​Which topics can I send?

​Are the results the same for everyone?

​How much does it cost?

​Does this replace X’s official API?

Pick a topic

Query parameters

Headers

Response

200 OK

400 Invalid community topic or cursor

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Popular X Communities questions

Which topics can I send?

Are the results the same for everyone?

How much does it cost?

Does this replace X’s official API?