X community topics & subtopics: Twitter API list

{
  "topics": [
    {
      "id": "301",
      "name": "Technology",
      "subtopics": [
        {
          "id": "302",
          "name": "Artificial Intelligence"
        }
      ]
    }
  ],
  "count": 1
}

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

topics

X community topics & subtopics: Twitter API list

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

package main

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

func main() {

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

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

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

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

	fmt.Println(string(body))

}

{
  "topics": [
    {
      "id": "<string>",
      "name": "<string>",
      "subtopics": [
        {}
      ]
    }
  ],
  "count": 123,
  "message": "<string>"
}

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

curl https://xquik.com/api/v1/x/communities/topics \
  -H "x-api-key: xq_your_api_key_here" | jq

const response = await fetch("https://xquik.com/api/v1/x/communities/topics", {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
for (const topic of data.topics) {
  const subtopics = topic.subtopics.map((subtopic) => subtopic.name).join(", ");
  process.stdout.write(`${topic.id} ${topic.name}: ${subtopics}\n`);
}

import requests

response = requests.get(
    "https://xquik.com/api/v1/x/communities/topics",
    headers={"x-api-key": "xq_your_api_key_here"},
)
for topic in response.json()["topics"]:
    subtopics = ", ".join(subtopic["name"] for subtopic in topic["subtopics"])
    print(topic["id"], topic["name"], subtopics)

Use GET /x/communities/topics to list the topics X groups Communities under. Each topic carries its subtopics. Pass a topic or subtopic to Popular communities as topicId or topic. Each top-level topic costs 1 credit, its subtopics included. X changes the list rarely, so store it. An empty list costs nothing.

Query parameters

integer

Most topics to return, starting at 1. Omit it for every topic. Your credit balance can return fewer. Aliases: pageSize, 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[]

Every topic, in X’s order. Topic object fields.

string

Topic ID. Pass it as topicId to Popular communities.

string

Topic name. Popular communities also takes it as topic.

object[]

Narrower topics, each with its own id and name.

number

Top-level topics returned.

string

What to do next. Present only when X lists no topic.

{
  "topics": [
    {
      "id": "301",
      "name": "Technology",
      "subtopics": [
        { "id": "302", "name": "Artificial Intelligence" },
        { "id": "303", "name": "Software" }
      ]
    },
    { "id": "701", "name": "Gaming", "subtopics": [] }
  ],
  "count": 2
}

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.

X Community topics questions

How much does the topic list cost?

1 credit per top-level topic. Its subtopics come free. Send limit for fewer topics.

Do subtopics work with Popular communities?

Yes. Send a subtopic’s id as topicId or its name as topic.

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. Popular communities lists the top Communities of a topic.

{
  "topics": [
    {
      "id": "301",
      "name": "Technology",
      "subtopics": [
        {
          "id": "302",
          "name": "Artificial Intelligence"
        }
      ]
    }
  ],
  "count": 1
}

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

X community topics & subtopics: Twitter API list

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

package main

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

func main() {

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

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

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

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

	fmt.Println(string(body))

}

{
  "topics": [
    {
      "id": "<string>",
      "name": "<string>",
      "subtopics": [
        {}
      ]
    }
  ],
  "count": 123,
  "message": "<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

X community topics & subtopics: Twitter API list

Query parameters

Headers

Response

200 OK

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

X Community topics questions

How much does the topic list cost?

Do subtopics work with Popular communities?

Does this replace X’s official API?

​Query parameters

​Headers

​Response

​200 OK

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

​X Community topics questions

​How much does the topic list cost?

​Do subtopics work with Popular communities?

​Does this replace X’s official API?

Query parameters

Headers

Response

200 OK

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

X Community topics questions

How much does the topic list cost?

Do subtopics work with Popular communities?

Does this replace X’s official API?