Skip to main content
GET https://xquik.com/api/v1/x/communities/find
1 credit per Community returned · All plans from $0.00012/credit
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

  1. Send a keyword as q, such as artificial intelligence.
  2. Pick a Community from the list by its name and member_count.
  3. Pass its id to Community details for its rules, creator, and admin.
  4. 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

Choose fields

Headers

Response

200 OK

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

The read failed. Retry after a short delay.

503 Service busy

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

429 Rate limit exceeded

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 (Twitter) Communities questions

How do I find X (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.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.

Response examples

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required." }
  • 402 { "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." }
  • 403 { "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." }
  • 424 { "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." }
  • 429 { "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }
  • 502 { "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." }
  • 503 { "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }