Skip to main content
GET https://xquik.com/api/v1/x/communities/suggested
1 credit per Community returned · All plans from $0.00012/credit
Use GET /x/communities/suggested to list the Communities X (Twitter) suggests to join. Each suggestion carries the full Community record. That record holds rules, topic, creator, admin, and previewed members. Each Community costs 1 credit. An empty list costs nothing.

How X picks suggestions

X picks the suggestions for each request, so 2 calls can return different Communities. An empty answer means X suggests none right now. For a list based only on your input, use Find communities or Popular communities.

Query parameters

Choose fields

Headers

Response

200 OK

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.

Suggested X Communities questions

Why do 2 calls return different Communities?

X picks the suggestions for each request.

Does the response include my membership?

No. It holds only public Community fields.

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 tweets reads a suggested Community’s posts 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." }