---
title: "Find X Communities by keyword"
method: GET
path: "/x/communities/find"
tags: ["Communities"]
---

# Find X Communities by keyword

`GET /x/communities/find`

## Request

- Base URL: `https://xquik.com/api/v1`
- URL: `https://xquik.com/api/v1/x/communities/find`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - none

Returns the communities X finds for a keyword, in X's order. Each community costs 1 credit. To search the tweets in Communities, use /x/communities/search.

## Query parameters

- `q` string, required
- `cursor` string
- `pageSize` integer
- `fields` string
- `omit` string

## Response `200`

Communities X finds for the keyword

- CommunityPage: 1 page of X Communities, in X's order.
  - `communities` Community[], required: Communities in X's order
    - `id` string, required: Unique community identifier
    - `name` string, required: Display name of the community
    - `description` string: About text for the community
    - `member_count` integer, required: Total member count
    - `moderator_count` integer: Total moderator count
    - `is_nsfw` boolean, required: Whether the community is marked sensitive
    - `primary_topic` object: Primary topic. Its id is absent when X lists the community in a keyword or topic result.
      - `id` string: Topic ID that /x/communities/popular takes
      - `name` string, required: Topic name X shows on the community
    - `created_at` string: Community creation timestamp
    - `join_policy` string: Join policy (open or restricted)
    - `invites_policy` string: Invitation policy
    - `question` string: What the community asks a user who joins
    - `rules` object[]: Community rules
      - `id` string: Rule ID
      - `name` string: Rule title
      - `description` string: What the rule asks of members
    - `searchTags` string[]: Tags X finds the community by
    - `creator` union: The creator's public profile, or the ID, username and badge alone when X sends no profile
      - UserProfile: Public X profile.
        - `id` string, required
        - `username` string, required
        - `name` string, required
        - `description` string
        - `followers` integer: Omitted when X sends no count, as for the account that first posted reused media.
        - `following` integer
        - `verified` boolean
        - `isBlueVerified` boolean: Whether X shows a blue verification badge
        - `isVerified` boolean: Whether X marks the profile as verified
        - `profilePicture` string: Profile picture at 48 px, as X sends it.
        - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image.
        - `coverPicture` string
        - `profileBannerUrl` string: Original X profile banner field when available
        - `location` string: Account owner's public profile location text
        - `accountBasedIn` AccountBasedIn: X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location.
          - `value` string, required
          - `level` 'country' | 'region', required
          - `observedAt` string, date-time, required
        - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later.
        - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate.
        - `connectedVia` string: How the account first connected to X.
        - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate.
        - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page.
        - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none.
        - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none.
          - `emails` object[]: Emails in the bio, name or location, lowercased.
            - `value` string, required: The email address.
            - `domain` string, required: The part after the @ sign.
            - `source` 'bio' | 'name' | 'location', required: Profile field that holds the email.
            - `writtenAs` string: The account's own spelling, sent when it spelled the email out.
          - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts.
            - `value` string, required: The digits, with a leading + when the account wrote a country code.
            - `source` 'bio' | 'name' | 'location' | 'url', required: Profile field that holds the number.
            - `writtenAs` string: The account's own spelling of the number.
          - `links` object[]: The profile's website & the links in its bio.
            - `url` string, required: The link, as X expands it.
            - `network` string, required: Site the link belongs to, such as `linkedin`, `github` or `telegram`. Any other site is `website`.
            - `source` 'url' | 'bio', required: `url` for the website field, `bio` for a bio link.
        - `usernameChanges` object: How often the account changed its username.
          - `count` integer, required: Whole number from 0.
          - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none.
        - `birthdate` object: The parts of the birthday the account made public.
          - `day` integer
          - `month` integer
          - `year` integer
        - `retweetedAt` string, date-time, nullable: UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed. Otherwise omitted.
        - `createdAt` string: Account creation time.
        - `statusesCount` integer
        - `mediaCount` integer
        - `protected` boolean: Whether the profile protects its posts
        - `url` string
        - `favouritesCount` integer
        - `hasCustomTimelines` boolean
        - `isTranslator` boolean
        - `withheldInCountries` string[]
        - `withheldScope` string: Whether X withholds a post or user
        - `possiblySensitive` boolean
        - `professional` PublicMetadata: Public metadata whose fields X defines.
        - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines.
        - `pinnedTweetIds` string[]
        - `isAutomated` boolean
        - `automatedBy` string
        - `unavailable` boolean
        - `unavailableReason` string
        - `verifiedType` string
        - `affiliatesHighlightedLabel` UserAffiliateLabel: Organization affiliation label shown on an X profile.
          - `badgeUrl` string
          - `description` string
          - `longDescription` PublicMetadata: Public metadata whose fields X defines.
          - `url` string
          - `urlType` string
          - `userLabelDisplayType` string
          - `userLabelType` string
        - `businessAccountAffiliatesCount` integer: Whole number from 0.
        - `creatorSubscriptionsCount` integer: Whole number from 0.
        - `hasGraduatedAccess` boolean
        - `hasHiddenSubscriptionsOnProfile` boolean
        - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata.
          - `canHighlightTweets` boolean
          - `highlightedTweets` string
        - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page.
          - `description` string
          - `isIdentityVerified` boolean: Whether the owner verified their ID with X.
          - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec.
          - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text.
        - `isProfileTranslatable` boolean
        - `parodyCommentaryFanLabel` string
        - `profileDescriptionLanguage` string
        - `profileImageShape` string
        - `profileInterstitialType` string
        - `profileSortEnabled` boolean
        - `profileTranslatorType` string
        - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself.
        - `superFollowEligible` boolean
        - `superFollowsUserProfileActive` boolean: Whether X marks the subscription profile as active.
        - `tipJar` UserTipJar: Public payment and creator-support handles shown on X.
          - `bandcampHandle` string
          - `bitcoinHandle` string
          - `cashAppHandle` string
          - `ethereumHandle` string
          - `gofundmeHandle` string
          - `isEnabled` boolean
          - `patreonHandle` string
          - `payPalHandle` string
          - `venmoHandle` string
        - `listedCount` integer: Public lists that include the profile.
        - `fastFollowersCount` integer: Followers X counts as fast followers.
        - `normalFollowersCount` integer: Followers minus fast followers.
        - `defaultProfile` boolean: Whether the profile keeps X's default theme.
        - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar.
        - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false.
        - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false.
        - `geoEnabled` boolean: Whether the profile may add a location to posts.
        - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them.
        - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads.
        - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`.
        - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none.
        - `verificationReason` object: X's text on why the profile is verified, with its links.
          - `text` string
          - `entities` object[]: Links inside the text, by character range.
            - `fromIndex` integer: Whole number from 0.
            - `toIndex` integer: Whole number from 0.
            - `url` string
            - `urlType` string
        - `communityRole` string: Community role when returned by community member reads
        - `profile_bio` PublicMetadata: Public metadata whose fields X defines.
      - object
        - `id` string, required: Numeric X user ID of the creator
        - `username` string, required: X username of the creator
        - `verified` boolean, required: Whether X shows the creator a badge
    - `admin` UserProfile: Public X profile.
      - `id` string, required
      - `username` string, required
      - `name` string, required
      - `description` string
      - `followers` integer: Omitted when X sends no count, as for the account that first posted reused media.
      - `following` integer
      - `verified` boolean
      - `isBlueVerified` boolean: Whether X shows a blue verification badge
      - `isVerified` boolean: Whether X marks the profile as verified
      - `profilePicture` string: Profile picture at 48 px, as X sends it.
      - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image.
      - `coverPicture` string
      - `profileBannerUrl` string: Original X profile banner field when available
      - `location` string: Account owner's public profile location text
      - `accountBasedIn` AccountBasedIn: X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location.
        - `value` string, required
        - `level` 'country' | 'region', required
        - `observedAt` string, date-time, required
      - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later.
      - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate.
      - `connectedVia` string: How the account first connected to X.
      - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate.
      - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page.
      - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none.
      - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none.
        - `emails` object[]: Emails in the bio, name or location, lowercased.
          - `value` string, required: The email address.
          - `domain` string, required: The part after the @ sign.
          - `source` 'bio' | 'name' | 'location', required: Profile field that holds the email.
          - `writtenAs` string: The account's own spelling, sent when it spelled the email out.
        - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts.
          - `value` string, required: The digits, with a leading + when the account wrote a country code.
          - `source` 'bio' | 'name' | 'location' | 'url', required: Profile field that holds the number.
          - `writtenAs` string: The account's own spelling of the number.
        - `links` object[]: The profile's website & the links in its bio.
          - `url` string, required: The link, as X expands it.
          - `network` string, required: Site the link belongs to, such as `linkedin`, `github` or `telegram`. Any other site is `website`.
          - `source` 'url' | 'bio', required: `url` for the website field, `bio` for a bio link.
      - `usernameChanges` object: How often the account changed its username.
        - `count` integer, required: Whole number from 0.
        - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none.
      - `birthdate` object: The parts of the birthday the account made public.
        - `day` integer
        - `month` integer
        - `year` integer
      - `retweetedAt` string, date-time, nullable: UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed. Otherwise omitted.
      - `createdAt` string: Account creation time.
      - `statusesCount` integer
      - `mediaCount` integer
      - `protected` boolean: Whether the profile protects its posts
      - `url` string
      - `favouritesCount` integer
      - `hasCustomTimelines` boolean
      - `isTranslator` boolean
      - `withheldInCountries` string[]
      - `withheldScope` string: Whether X withholds a post or user
      - `possiblySensitive` boolean
      - `professional` PublicMetadata: Public metadata whose fields X defines.
      - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines.
      - `pinnedTweetIds` string[]
      - `isAutomated` boolean
      - `automatedBy` string
      - `unavailable` boolean
      - `unavailableReason` string
      - `verifiedType` string
      - `affiliatesHighlightedLabel` UserAffiliateLabel: Organization affiliation label shown on an X profile.
        - `badgeUrl` string
        - `description` string
        - `longDescription` PublicMetadata: Public metadata whose fields X defines.
        - `url` string
        - `urlType` string
        - `userLabelDisplayType` string
        - `userLabelType` string
      - `businessAccountAffiliatesCount` integer: Whole number from 0.
      - `creatorSubscriptionsCount` integer: Whole number from 0.
      - `hasGraduatedAccess` boolean
      - `hasHiddenSubscriptionsOnProfile` boolean
      - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata.
        - `canHighlightTweets` boolean
        - `highlightedTweets` string
      - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page.
        - `description` string
        - `isIdentityVerified` boolean: Whether the owner verified their ID with X.
        - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec.
        - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text.
      - `isProfileTranslatable` boolean
      - `parodyCommentaryFanLabel` string
      - `profileDescriptionLanguage` string
      - `profileImageShape` string
      - `profileInterstitialType` string
      - `profileSortEnabled` boolean
      - `profileTranslatorType` string
      - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself.
      - `superFollowEligible` boolean
      - `superFollowsUserProfileActive` boolean: Whether X marks the subscription profile as active.
      - `tipJar` UserTipJar: Public payment and creator-support handles shown on X.
        - `bandcampHandle` string
        - `bitcoinHandle` string
        - `cashAppHandle` string
        - `ethereumHandle` string
        - `gofundmeHandle` string
        - `isEnabled` boolean
        - `patreonHandle` string
        - `payPalHandle` string
        - `venmoHandle` string
      - `listedCount` integer: Public lists that include the profile.
      - `fastFollowersCount` integer: Followers X counts as fast followers.
      - `normalFollowersCount` integer: Followers minus fast followers.
      - `defaultProfile` boolean: Whether the profile keeps X's default theme.
      - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar.
      - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false.
      - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false.
      - `geoEnabled` boolean: Whether the profile may add a location to posts.
      - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them.
      - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads.
      - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`.
      - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none.
      - `verificationReason` object: X's text on why the profile is verified, with its links.
        - `text` string
        - `entities` object[]: Links inside the text, by character range.
          - `fromIndex` integer: Whole number from 0.
          - `toIndex` integer: Whole number from 0.
          - `url` string
          - `urlType` string
      - `communityRole` string: Community role when returned by community member reads
      - `profile_bio` PublicMetadata: Public metadata whose fields X defines.
    - `membersFacepile` union[]: The members X previews beside the member count. A keyword or topic result gives each member's ID & picture only.
      - union
        - UserProfile: Public X profile.
          - `id` string, required
          - `username` string, required
          - `name` string, required
          - `description` string
          - `followers` integer: Omitted when X sends no count, as for the account that first posted reused media.
          - `following` integer
          - `verified` boolean
          - `isBlueVerified` boolean: Whether X shows a blue verification badge
          - `isVerified` boolean: Whether X marks the profile as verified
          - `profilePicture` string: Profile picture at 48 px, as X sends it.
          - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image.
          - `coverPicture` string
          - `profileBannerUrl` string: Original X profile banner field when available
          - `location` string: Account owner's public profile location text
          - `accountBasedIn` AccountBasedIn: X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location.
            - `value` string, required
            - `level` 'country' | 'region', required
            - `observedAt` string, date-time, required
          - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later.
          - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate.
          - `connectedVia` string: How the account first connected to X.
          - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate.
          - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page.
          - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none.
          - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none.
            - `emails` object[]: Emails in the bio, name or location, lowercased.
              - …
            - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts.
              - …
            - `links` object[]: The profile's website & the links in its bio.
              - …
          - `usernameChanges` object: How often the account changed its username.
            - `count` integer, required: Whole number from 0.
            - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none.
          - `birthdate` object: The parts of the birthday the account made public.
            - `day` integer
            - `month` integer
            - `year` integer
          - `retweetedAt` string, date-time, nullable: UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed. Otherwise omitted.
          - `createdAt` string: Account creation time.
          - `statusesCount` integer
          - `mediaCount` integer
          - `protected` boolean: Whether the profile protects its posts
          - `url` string
          - `favouritesCount` integer
          - `hasCustomTimelines` boolean
          - `isTranslator` boolean
          - `withheldInCountries` string[]
          - `withheldScope` string: Whether X withholds a post or user
          - `possiblySensitive` boolean
          - `professional` PublicMetadata: Public metadata whose fields X defines.
          - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines.
          - `pinnedTweetIds` string[]
          - `isAutomated` boolean
          - `automatedBy` string
          - `unavailable` boolean
          - `unavailableReason` string
          - `verifiedType` string
          - `affiliatesHighlightedLabel` UserAffiliateLabel: Organization affiliation label shown on an X profile.
            - `badgeUrl` string
            - `description` string
            - `longDescription` PublicMetadata: Public metadata whose fields X defines.
            - `url` string
            - `urlType` string
            - `userLabelDisplayType` string
            - `userLabelType` string
          - `businessAccountAffiliatesCount` integer: Whole number from 0.
          - `creatorSubscriptionsCount` integer: Whole number from 0.
          - `hasGraduatedAccess` boolean
          - `hasHiddenSubscriptionsOnProfile` boolean
          - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata.
            - `canHighlightTweets` boolean
            - `highlightedTweets` string
          - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page.
            - `description` string
            - `isIdentityVerified` boolean: Whether the owner verified their ID with X.
            - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec.
            - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text.
          - `isProfileTranslatable` boolean
          - `parodyCommentaryFanLabel` string
          - `profileDescriptionLanguage` string
          - `profileImageShape` string
          - `profileInterstitialType` string
          - `profileSortEnabled` boolean
          - `profileTranslatorType` string
          - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself.
          - `superFollowEligible` boolean
          - `superFollowsUserProfileActive` boolean: Whether X marks the subscription profile as active.
          - `tipJar` UserTipJar: Public payment and creator-support handles shown on X.
            - `bandcampHandle` string
            - `bitcoinHandle` string
            - `cashAppHandle` string
            - `ethereumHandle` string
            - `gofundmeHandle` string
            - `isEnabled` boolean
            - `patreonHandle` string
            - `payPalHandle` string
            - `venmoHandle` string
          - `listedCount` integer: Public lists that include the profile.
          - `fastFollowersCount` integer: Followers X counts as fast followers.
          - `normalFollowersCount` integer: Followers minus fast followers.
          - `defaultProfile` boolean: Whether the profile keeps X's default theme.
          - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar.
          - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false.
          - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false.
          - `geoEnabled` boolean: Whether the profile may add a location to posts.
          - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them.
          - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads.
          - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`.
          - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none.
          - `verificationReason` object: X's text on why the profile is verified, with its links.
            - `text` string
            - `entities` object[]: Links inside the text, by character range.
              - …
          - `communityRole` string: Community role when returned by community member reads
          - `profile_bio` PublicMetadata: Public metadata whose fields X defines.
        - CommunityMemberPreview: A member X previews by ID & profile picture only.
          - `id` string, required: Numeric X user ID of the member
          - `profilePicture` string: Profile picture URL of the member
          - `profilePictureOriginal` string: The member's profile picture at full size
    - `banner_url` string: Community banner image URL
    - `banner` CommunityBanner: The banner X shows for a community, with its size & colors.
      - `url` string, required: Banner image URL at its original size
      - `width` integer: Banner width in pixels
      - `height` integer: Banner height in pixels
      - `colors` object[]: Main colors of the banner, largest share first
        - `percentage` number, required: Share of the banner in this color
        - `red` integer, required: Red value of the color
        - `green` integer, required: Green value of the color
        - `blue` integer, required: Blue value of the color
      - `focus` object: Area X keeps in view when it crops the banner, in pixels from the top left
        - `left` integer: Distance from the left edge
        - `top` integer: Distance from the top edge
        - `width` integer: Width of the area
        - `height` integer: Height of the area
  - `has_next_page` boolean, required: Whether another page of communities follows
  - `next_cursor` string, required: Cursor for the next page of communities. Empty at the end.

## Other responses

- `400`: Invalid input. A value past its maxLength gets this answer, & the message names the field & its limit.
- `401`: Non-MPP paid reads require Bearer authentication. Without credentials, the answer offers a guest checkout but does not create it. Invalid credentials return a plain error. Confirm before using any offered action.
- `402`: Payment required. MPP reads include `WWW-Authenticate`. Authenticated reads include balances, plus checkout when the key can open it. A key that reads only gets the account page instead. A failed request never creates checkout. A caller on a plan gets top-up only, plus `credits_renew_at` when the plan renews. Guest keys offer top-up.
- `424`: Dependency unavailable, unauthorized, or limited. Default v1 uses 502. Best-practice responses use 424 for transparent dependency failures. Search answers 424 `search_unavailable` when X fails the query itself, or when its filters matched none of the last 3,000 posts read. The message says how far back the search read.
- `429`: Too many requests right now. Each user gets 500 reads a second. Each minute allows 120 writes & 60 deletes. `x_api_rate_limited` means X limits this read for now. Neither answer costs anything. Wait for the seconds in `Retry-After`, then retry.
- `502`: Dependency unavailable, unauthorized, or limited. Default v1 uses 502. Best-practice responses use 424 for transparent dependency failures. Search answers 424 `search_unavailable` when X fails the query itself, or when its filters matched none of the last 3,000 posts read. The message says how far back the search read.
- `503`: Retry x_api_unavailable after Retry-After. With X-Xquik-Busy, retry until your deadline.

## Changes

- **2026-10-21** `245194cd4ea7`: 14 warning
  - added the new `topup_in_progress` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `429`
  - added the new `topup_in_progress` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #2: StructuredError]/code` response property for the response status `429`
  - added the new `topup_in_progress` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `400`
  - added the new `topup_in_progress` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `424`
  - …10 more
- **2026-10-18** `d17988b4a85d`: 1 breaking, 6 info
  - added `#/components/schemas/AccountPagePaymentRequired` to the response body `oneOf` list for the response status `402`
  - the response property `oneOf[#/components/schemas/AuthenticatedPaymentRequired]/payment_options` became required for the status `402`
  - the response property `oneOf[#/components/schemas/AuthenticatedPaymentRequired]/top_up_endpoint` became required for the status `402`
  - the response property `oneOf[#/components/schemas/AuthenticatedPaymentRequired]/top_up_url` became required for the status `402`
  - …3 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/xquik-dev/apis/xquik-api/changes/x/communities/find/get.md)

---

[API](https://skmtc.dev/xquik-dev/apis/xquik-api.md) · [All operations](https://skmtc.dev/xquik-dev/apis/xquik-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xquik-dev/apis/xquik-api/revisions/ef03679f1918?raw)
