OpenAPI 3.1.02026-08-21127127514.8 KB

18302a60cfee

Users

List mutual followers between you and a user

List mutual followers between you and a user.

get/api/v1/x/users/{id}/followers-you-know

Path parameters

idstring required

User ID for followers-you-know lookup

Query parameters

cursorstring

Pagination cursor for followers-you-know

pageSizeinteger

Maximum user profiles requested from this page (1-200, default 200). Source, filters, or credits can return fewer profiles. Keep requesting next_cursor while has_next_page is true. Deprecated aliases remain accepted.

minFollowersinteger

Minimum follower count. Filtering happens before billing.

maxFollowersinteger

Maximum follower count. Missing counts pass this maximum.

minFollowinginteger

Profiles must follow at least this many accounts.

maxFollowinginteger

Profiles may follow at most this many accounts.

minStatusesinteger

Minimum post count. minPosts is also accepted.

maxStatusesinteger

Maximum post count. maxPosts is also accepted.

minAccountAgeDaysinteger

Minimum account age in whole days.

verifiedOnlyboolean

Only return verified profiles.

verifiedTypestring

Match the verification type exactly, ignoring case.

hasWebsiteboolean

Only return profiles with a website.

hasLocationboolean

Only return profiles with a location.

bioContainsstring

Match any comma-separated or line-separated bio term, ignoring case.

locationContainsstring

Match a location substring, ignoring case.

usernameContainsstring

Match a username substring, ignoring case.

Response

List of mutual followers

filtered_countinteger
has_next_pageboolean required
next_cursorstring required

Example response

{
  "users": [],
  "has_next_page": false,
  "next_cursor": ""
}