List accounts a Twitter profile follows

List accounts an X profile follows by handle or numeric user id.

GET/v1/twitter/profiles/{handle}/following
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
handlestringrequiredpath

X (Twitter) profile handle without the leading @, or a numeric user id.

bystringoptionalquery

Treat the path value as a handle or a numeric user id. Defaults to id when the value is all digits.

one of: id, handle

cursorstringoptionalquery

Opaque pagination cursor returned by a previous response.

min 1 chars

Response fields
41

Endpoint-specific response payload.

datalookupStatus
string

Whether the user list was resolved.

one of: found, not_found, private

Users returned for this page.

datausers[]id
string

Numeric X user id as a string.

datausers[]handle
string

X screen name (handle) without the leading @.

datausers[]displayName
stringnullable

Display name shown on the profile.

datausers[]description
stringnullable

Profile biography text.

datausers[]avatarUrl
stringnullable

Best available square avatar image URL.

datausers[]bannerUrl
stringnullable

Profile banner image URL when available.

datausers[]location
stringnullable

Location string from the profile when provided.

datausers[]website
stringnullable

Primary outbound link (expanded URL) from the profile.

datausers[]verified
boolean

Whether X marks the profile with legacy verification (not necessarily paid blue).

datausers[]isBlueVerified
boolean

Whether the account has X blue (paid) verification.

datausers[]isProtected
boolean

Whether the account is protected (private).

datausers[]followerCount
integernullable

Follower count from X when available.

≥ 0

datausers[]followingCount
integernullable

Following (friends) count from X when available.

≥ 0

datausers[]tweetCount
integernullable

Total post (status) count from X when available.

≥ 0

datausers[]listedCount
integernullable

Listed count when X provides it.

≥ 0

datausers[]createdAt
stringnullable

Account creation time (ISO-8601) when derivable.

datausers[]profileUrl
string

Canonical public profile URL on x.com (`https://x.com/<handle>`).

datausers[]profileImageShape
stringnullableoptional

Avatar crop shape reported by X, such as Circle or Square.

datausers[]verifiedType
stringnullableoptional

X verification type label when provided (for example a government or organization note).

Pinned tweet ids from X, in display order.

datausers[]pinnedTweetIds[]
stringoptional

X professional-account metadata when the account is marked professional.

datausers[]professionaltype
stringnullable

Professional account type from X, when present.

Professional category entries from X.

datausers[]professionalcategory[]
nullableoptional
datausers[]professionalrestId
stringnullable

Professional account rest id from X, when present.

Country codes where the profile is withheld.

datausers[]withheldInCountries[]
stringoptional
datausers[]favoritesCount
integernullableoptional

Total likes (favorites) on the profile when available.

≥ 0

datausers[]mediaCount
integernullableoptional

Media item count when X provides it.

≥ 0

Cursor pagination for this user list.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/twitter/profiles/nasa/following" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Accounts the profile follows.