Sign in

v

latestOpenAPI 3.1.02026-08-09127104507.8 KB
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 (20-200, default 200). Source, filters, or credits can return fewer profiles. Automatic coverage can prefetch across independent views. Response shape, page size, and per-returned-profile billing stay unchanged. Keep requesting next_cursor while has_next_page is true. Deprecated limit and count aliases remain accepted.

minFollowersinteger

Minimum follower count. Filtering happens before billing.

maxFollowersinteger

Maximum follower count. Missing counts pass this maximum.

minFollowinginteger

Minimum following count.

maxFollowinginteger

Maximum following count.

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

has_next_pageboolean required
next_cursorstring required

Example response

{
  "users": [
    {
      "id": "9876543210",
      "username": "elonmusk",
      "name": "Elon Musk"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}