--- title: "GET /api/v1/x/users/{id}/following" method: GET path: "/api/v1/x/users/{id}/following" tags: ["Users"] --- # GET /api/v1/x/users/{id}/following `GET /api/v1/x/users/{id}/following` ## Request - Base URL: `https://xquik.com` - URL: `https://xquik.com/api/v1/x/users/{id}/following` - Auth: one of: - API key in header `x-api-key` - HTTP bearer - none Returns public profiles followed by the selected user. ## Path parameters - `id` string, required ## Query parameters - `cursor` string - `mode` 'standard' | 'coverage' - `after` string - `pageSize` integer - `maxScan` integer - `minFollowers` integer: Whole number from 0. - `maxFollowers` integer: Whole number from 0. - `minFollowing` integer: Whole number from 0. - `maxFollowing` integer: Whole number from 0. - `minStatuses` integer: Whole number from 0. - `maxStatuses` integer: Whole number from 0. - `minAccountAgeDays` integer: Whole number from 0. - `verifiedOnly` boolean - `blueVerifiedOnly` boolean - `verifiedType` string - `hasWebsite` boolean - `hasLocation` boolean - `hasEmail` boolean - `businessEmailOnly` boolean - `emailDomains` string - `bioContains` string - `locationContains` string - `usernameContains` string - `enrichProfiles` boolean - `limit` integer - `fields` string - `omit` string ## Response `200` List of following - union: A standard or terminal maximum-coverage relationship page. - UserListPage: Profile coverage preserves shape, billing, aliases, and filters. Follow next_cursor while the response reports more pages. Unprefixed cursors remain legacy. - `filtered_count` integer: Whole number from 0. - `users` UserProfile[], required - `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. - `has_next_page` boolean, required - `next_cursor` string, required: Cursor for the next page. Send it unchanged. - `scanLimit` UserListScanLimit: Present on the last page of a filtered automatic read that sent no maxScan, once the list scanned 100,000 profiles across its pages. That page is the list's last. - `limit` 100000, required: The profiles a filtered read scans of a list without maxScan. - `rowsRead` integer, required: Profiles the list read across its pages, kept or dropped by the filters. The last page may read past the limit. - `message` string, required: What stopped the list & how to read further. - UserListCoverageResponse: Profile coverage preserves shape, billing, aliases, and filters. Follow next_cursor while the response reports more pages. Unprefixed cursors remain legacy. - `filtered_count` integer: Whole number from 0. - `users` UserProfile[], required - `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. - `has_next_page` false, required - `next_cursor` '', required: Cursor for the next page. Send it unchanged. - `diagnostic` UserListCoverageDiagnostic, required: Shared maximum-coverage counts and completion state. - `complete` boolean, required: True after all active strategies exhaust their sources. An empty read of the whole search window also ends its time slices. - `cursorFailureCount` integer, required: Whole number from 0. - `deadlineReached` boolean, required - `duplicateCount` integer, required: Whole number from 0. - `failedStrategyCount` integer, required: Whole number from 0. - `malformedCount` integer, required: Whole number from 0. - `pagesFetched` integer, required: Whole number from 0. - `responseTruncated` boolean, required: True when credits or the requested limit reduce output. - `resultLimitReached` boolean, required - `stalledStrategyCount` integer, required: Whole number from 0. - `strategyCount` integer, required - `returnedUsers` integer, required - `strategies` UserListCoverageStrategy[], required - `duplicateCount` integer, required: Whole number from 0. - `pagesFetched` integer, required: Whole number from 0. - `stopReason` 'cursor_failure' | 'deadline' | 'exhausted' | 'failed' | 'page_limit' | 'result_limit' | 'stalled', required: Reason a coverage strategy stopped. - `strategy` integer, required - `uniqueAdded` integer, required: Whole number from 0. - `uniqueUsers` integer, required ## 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. - `403`: X keeps a protected account's following list private. Xquik charges nothing. - `404`: X shows no profile for the account. `reason` says why. It is `not_found` for a handle or ID no account holds, which X answers for a deactivated account too, or `suspended` with the message "X suspended this account. Choose another account." when X suspended it. - `409`: Xquik is still reading the cursor's page. Your key or session repeating the same request waits for that page instead. Wait `Retry-After` seconds, then send the same cursor again. - `410`: Restart without the `coverage_cursor_gone` cursor. A cursor sent again within 10 minutes of its page returns the same page at no charge, so only an older, expired or replaced cursor answers 410. - `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. - `500`: Unexpected error. - `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. Retry pagination_stalled once after 30 s. - `default`: Unexpected error. ## Changes - **2026-10-20** `45942c75fdc2`: 26 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 `403` - …22 more [Operation history](https://skmtc.dev/xquik-dev/apis/xquik-api/changes/api/v1/x/users/:id/following/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/45942c75fdc2?raw)