{
  "openapi": "3.1.0",
  "info": {
    "title": "Twitter API — Network",
    "version": "1.0.0",
    "description": "Followers, following, and audience graph lookups."
  },
  "servers": [
    {
      "url": "https://api.fetchlayer.dev/twitter"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "description": "Every error, on every route. Branch on code and retryable rather than on the text; on a 5xx the text is generic. MCP tool errors carry the same fields in structuredContent, and as a JSON text block.",
        "properties": {
          "error": {
            "type": "string",
            "description": "What went wrong, in words. For a 400, what to change."
          },
          "status": {
            "type": "integer",
            "description": "The HTTP status, repeated in the body."
          },
          "code": {
            "type": "string",
            "description": "The kind of error, stable: invalid_input, unauthorized, insufficient_credits, forbidden, not_found, expired, quota_exceeded, cancelled, time_limit, temporarily_unavailable, posts_unavailable, store_unreachable, upstream_error, internal_error, tool_error. A platform may add its own; more may be added. Treat a code you do not recognise by its retryable flag."
          },
          "retryable": {
            "type": "boolean",
            "description": "Whether asking again can succeed."
          },
          "requestId": {
            "type": "string",
            "description": "This request’s id, also sent as the X-Request-Id header. Quote it when reporting a problem."
          },
          "missing": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "With invalid_input when the request's parameters are refused before the request runs: the parameters that were missing. Always present on those errors, empty when nothing was missing."
          }
        },
        "required": [
          "error",
          "code",
          "retryable",
          "requestId"
        ]
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Send your FetchLayer key as Authorization: Bearer ss-your-key."
      }
    }
  },
  "paths": {
    "/following": {
      "post": {
        "operationId": "following",
        "tags": [
          "Network"
        ],
        "summary": "Fetch following list",
        "description": "Retrieve accounts followed by a user with basic profile metadata per account. An account that does not exist is a 404 user_not_found (\"No X account with handle @x.\"), and so is a suspended one (the error says it is suspended); a 404 is final, not retryable, and not billed (2026-11-13; before, it was a retryable 503).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "handle": {
                    "type": "string",
                    "description": "Twitter handle without @."
                  },
                  "count": {
                    "type": "integer",
                    "description": "Accepted but has no effect: X sets the page size, about 50 to 70 accounts per page. Use nextCursor for more.",
                    "example": "25"
                  },
                  "cursor": {
                    "type": "string",
                    "description": "Pagination cursor."
                  },
                  "maxItems": {
                    "type": "integer",
                    "description": "Collect up to this many results in one call (1-500), following the pages for you. Each page of results returned bills one credit, and the last page comes back whole, so itemCount can exceed maxItems by less than a page. A call stops early at the end of the list or after about 90 seconds; hasMore and nextCursor then continue it. Leave it out for one page, billed one credit. Works with cursor and count."
                  },
                  "timeoutMs": {
                    "type": "integer",
                    "description": "Time limit for the whole request, in milliseconds (1000–120000; values outside are brought into that range). It can only shorten the time a request may take, which is about 90 seconds at most. With maxItems, a call that runs out returns the pages it has, billed for those, with hasMore and nextCursor; a call with nothing to return yet fails with a 503 you can retry. We answer at the latest about 2 seconds before timeoutMs runs out (15% of it, at least 0.75 s, for limits under 13 seconds), so you can set it to your own client’s timeout. Left out, the request takes the time it needs."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "handle"
                ]
              },
              "examples": {
                "default": {
                  "value": {
                    "handle": "NASA",
                    "count": 20
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "scrapedAt": {
                      "type": "string",
                      "description": "ISO 8601 time the result was produced."
                    },
                    "transport": {
                      "type": "string",
                      "description": "The data source: always the platform id, \"twitter\"."
                    },
                    "listingType": {
                      "type": "string",
                      "description": "Which list this is, e.g. twitter-user-tweets."
                    },
                    "itemCount": {
                      "type": "integer",
                      "description": "Number of items returned on this page."
                    },
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Pass as cursor, with the same other parameters, for the next page; null when there is none."
                    },
                    "hasMore": {
                      "type": "boolean",
                      "description": "Whether more results follow: repeat the call with cursor set to nextCursor while it is true. Always present on followers, following and verified-followers; on the other lists, present with maxItems."
                    },
                    "pagesFetched": {
                      "type": "integer",
                      "description": "With maxItems: the pages of results in this response, one credit each. Absent without maxItems (one page, one credit)."
                    },
                    "note": {
                      "type": "string",
                      "description": "With maxItems, why the call stopped before maxItems (the end of the list, or the time or page limit of one call, in which case hasMore is true and nextCursor continues). On search, also present when nothing was found."
                    },
                    "user": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true,
                      "description": "The account whose list this is, as user-profile-details returns it.",
                      "properties": {
                        "id": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Numeric account id, as a string. It stays the same when the handle changes."
                        },
                        "name": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Display name."
                        },
                        "handle": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Handle without the @."
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Bio text."
                        },
                        "location": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Location as the account wrote it."
                        },
                        "followersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Followers."
                        },
                        "followingCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Accounts followed."
                        },
                        "tweetsCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts, replies included."
                        },
                        "mediaCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts with media."
                        },
                        "verified": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "Whether the account carries a verification checkmark (see verification for which kind)."
                        },
                        "avatarUrl": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Profile image URL."
                        },
                        "bannerUrl": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Header image URL, or null."
                        },
                        "createdAt": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "When the account was created, as X writes it: \"Wed Dec 19 20:20:32 +0000 2007\" (UTC)."
                        },
                        "favoritesCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts the account has liked."
                        },
                        "listedCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Lists the account is on. Currently always null: X no longer sends it."
                        },
                        "fastFollowersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Currently always null: X no longer sends it. Use followersCount."
                        },
                        "normalFollowersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Currently always null: X no longer sends it. Use followersCount."
                        },
                        "creatorSubscriptionsCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Creator subscriptions the account has, or null when X leaves it out."
                        },
                        "pinnedTweetIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Ids of the pinned posts; empty when none."
                        },
                        "website": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The website link on the profile; null when there is none.",
                          "properties": {
                            "url": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The t.co short link."
                            },
                            "expandedUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The full address it leads to."
                            },
                            "displayUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The shortened form X displays, e.g. nasa.gov."
                            }
                          }
                        },
                        "descriptionUrls": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "properties": {
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The t.co short link."
                              },
                              "expandedUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The full address it leads to."
                              },
                              "displayUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The shortened form X displays, e.g. nasa.gov."
                              }
                            }
                          },
                          "description": "Links in the bio, expanded; empty when none."
                        },
                        "avatarUrlLarge": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The profile image at 400x400."
                        },
                        "verifiedType": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The kind of verification, e.g. Business or Government; null for none."
                        },
                        "protected": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "True when the account’s posts are visible to its followers only."
                        },
                        "profileLabel": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The affiliation badge shown next to the name (e.g. an organisation’s); null when there is none.",
                          "properties": {
                            "description": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The badge’s label, e.g. the organisation’s name."
                            },
                            "badgeUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The badge image."
                            },
                            "url": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Where the badge links to."
                            },
                            "urlType": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s link type, e.g. DeepLink."
                            },
                            "displayType": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "How X shows it, e.g. Badge."
                            },
                            "type": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s label type, e.g. BusinessLabel."
                            }
                          }
                        },
                        "verification": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "Which verification the account has.",
                          "properties": {
                            "blue": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "Verified through a subscription (the blue checkmark)."
                            },
                            "verified": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "Verified by X as notable (legacy verification)."
                            },
                            "identityVerified": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "The account holder’s identity was verified; null when X does not say."
                            },
                            "reason": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s own explanation of the checkmark, e.g. for a government account; null when it gives none."
                            }
                          }
                        }
                      }
                    },
                    "profiles": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true,
                        "properties": {
                          "id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Numeric account id, as a string. It stays the same when the handle changes."
                          },
                          "name": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Display name."
                          },
                          "handle": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Handle without the @."
                          },
                          "description": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Bio text."
                          },
                          "location": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Location as the account wrote it."
                          },
                          "followersCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Followers."
                          },
                          "followingCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Accounts followed."
                          },
                          "tweetsCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Posts, replies included."
                          },
                          "mediaCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Posts with media."
                          },
                          "verified": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "Whether the account carries a verification checkmark (see verification for which kind)."
                          },
                          "avatarUrl": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Profile image URL."
                          },
                          "bannerUrl": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Header image URL, or null."
                          },
                          "createdAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "When the account was created, as X writes it: \"Wed Dec 19 20:20:32 +0000 2007\" (UTC)."
                          },
                          "favoritesCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Posts the account has liked."
                          },
                          "listedCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Lists the account is on. Currently always null: X no longer sends it."
                          },
                          "fastFollowersCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Currently always null: X no longer sends it. Use followersCount."
                          },
                          "normalFollowersCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Currently always null: X no longer sends it. Use followersCount."
                          },
                          "creatorSubscriptionsCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Creator subscriptions the account has, or null when X leaves it out."
                          },
                          "pinnedTweetIds": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "Ids of the pinned posts; empty when none."
                          },
                          "website": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The website link on the profile; null when there is none.",
                            "properties": {
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The t.co short link."
                              },
                              "expandedUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The full address it leads to."
                              },
                              "displayUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The shortened form X displays, e.g. nasa.gov."
                              }
                            }
                          },
                          "descriptionUrls": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "url": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The t.co short link."
                                },
                                "expandedUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The full address it leads to."
                                },
                                "displayUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The shortened form X displays, e.g. nasa.gov."
                                }
                              }
                            },
                            "description": "Links in the bio, expanded; empty when none."
                          },
                          "avatarUrlLarge": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The profile image at 400x400."
                          },
                          "verifiedType": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The kind of verification, e.g. Business or Government; null for none."
                          },
                          "protected": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "True when the account’s posts are visible to its followers only."
                          },
                          "profileLabel": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The affiliation badge shown next to the name (e.g. an organisation’s); null when there is none.",
                            "properties": {
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The badge’s label, e.g. the organisation’s name."
                              },
                              "badgeUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The badge image."
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Where the badge links to."
                              },
                              "urlType": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "X’s link type, e.g. DeepLink."
                              },
                              "displayType": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "How X shows it, e.g. Badge."
                              },
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "X’s label type, e.g. BusinessLabel."
                              }
                            }
                          },
                          "verification": {
                            "type": "object",
                            "additionalProperties": true,
                            "description": "Which verification the account has.",
                            "properties": {
                              "blue": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Verified through a subscription (the blue checkmark)."
                              },
                              "verified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Verified by X as notable (legacy verification)."
                              },
                              "identityVerified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "The account holder’s identity was verified; null when X does not say."
                              },
                              "reason": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "X’s own explanation of the checkmark, e.g. for a government account; null when it gives none."
                              }
                            }
                          }
                        }
                      },
                      "description": "The accounts this account follows."
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "listingType": "twitter-following",
                      "user": {
                        "id": "11348282",
                        "name": "NASA",
                        "handle": "NASA",
                        "followersCount": 92312272,
                        "verified": true
                      },
                      "itemCount": 1,
                      "nextCursor": "1849213000000000000|2113790000000000000",
                      "profiles": [
                        {
                          "id": "783214",
                          "name": "X",
                          "handle": "X",
                          "description": "what’s happening?!",
                          "followersCount": 68400000,
                          "followingCount": 0,
                          "verified": true,
                          "avatarUrl": "https://pbs.twimg.com/profile_images/1683899100922511378/5lY42eHs_normal.jpg"
                        }
                      ],
                      "scrapedAt": "2026-10-25T19:08:43.990Z",
                      "transport": "twitter"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "invalid_input: the request needs fixing; error names the field.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "unauthorized: the API key is missing or not valid.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "insufficient_credits: no credits, trial or monthly allowance left.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "forbidden: this key or account is not allowed this request.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "quota_exceeded: a request-rate limit was reached.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "temporarily_unavailable, time_limit or (on a store route) store_unreachable: ask again (with time_limit, allow more time). Retryable.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ]
      }
    },
    "/followers": {
      "post": {
        "operationId": "followers",
        "tags": [
          "Network"
        ],
        "summary": "Fetch followers list",
        "description": "Retrieve follower accounts for a user with the same profile metadata shape as the following endpoint. An account that does not exist is a 404 user_not_found (\"No X account with handle @x.\"), and so is a suspended one (the error says it is suspended); a 404 is final, not retryable, and not billed (2026-11-13; before, it was a retryable 503).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "handle": {
                    "type": "string",
                    "description": "Twitter handle without @."
                  },
                  "count": {
                    "type": "integer",
                    "description": "Accepted but has no effect: X sets the page size, about 50 to 70 accounts per page. Use nextCursor for more.",
                    "example": "25"
                  },
                  "cursor": {
                    "type": "string",
                    "description": "Pagination cursor."
                  },
                  "maxItems": {
                    "type": "integer",
                    "description": "Collect up to this many results in one call (1-500), following the pages for you. Each page of results returned bills one credit, and the last page comes back whole, so itemCount can exceed maxItems by less than a page. A call stops early at the end of the list or after about 90 seconds; hasMore and nextCursor then continue it. Leave it out for one page, billed one credit. Works with cursor and count."
                  },
                  "timeoutMs": {
                    "type": "integer",
                    "description": "Time limit for the whole request, in milliseconds (1000–120000; values outside are brought into that range). It can only shorten the time a request may take, which is about 90 seconds at most. With maxItems, a call that runs out returns the pages it has, billed for those, with hasMore and nextCursor; a call with nothing to return yet fails with a 503 you can retry. We answer at the latest about 2 seconds before timeoutMs runs out (15% of it, at least 0.75 s, for limits under 13 seconds), so you can set it to your own client’s timeout. Left out, the request takes the time it needs."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "handle"
                ]
              },
              "examples": {
                "default": {
                  "value": {
                    "handle": "NASA",
                    "count": 20
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "scrapedAt": {
                      "type": "string",
                      "description": "ISO 8601 time the result was produced."
                    },
                    "transport": {
                      "type": "string",
                      "description": "The data source: always the platform id, \"twitter\"."
                    },
                    "listingType": {
                      "type": "string",
                      "description": "Which list this is, e.g. twitter-user-tweets."
                    },
                    "itemCount": {
                      "type": "integer",
                      "description": "Number of items returned on this page."
                    },
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Pass as cursor, with the same other parameters, for the next page; null when there is none."
                    },
                    "hasMore": {
                      "type": "boolean",
                      "description": "Whether more results follow: repeat the call with cursor set to nextCursor while it is true. Always present on followers, following and verified-followers; on the other lists, present with maxItems."
                    },
                    "pagesFetched": {
                      "type": "integer",
                      "description": "With maxItems: the pages of results in this response, one credit each. Absent without maxItems (one page, one credit)."
                    },
                    "note": {
                      "type": "string",
                      "description": "With maxItems, why the call stopped before maxItems (the end of the list, or the time or page limit of one call, in which case hasMore is true and nextCursor continues). On search, also present when nothing was found."
                    },
                    "user": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true,
                      "description": "The account whose list this is, as user-profile-details returns it.",
                      "properties": {
                        "id": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Numeric account id, as a string. It stays the same when the handle changes."
                        },
                        "name": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Display name."
                        },
                        "handle": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Handle without the @."
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Bio text."
                        },
                        "location": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Location as the account wrote it."
                        },
                        "followersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Followers."
                        },
                        "followingCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Accounts followed."
                        },
                        "tweetsCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts, replies included."
                        },
                        "mediaCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts with media."
                        },
                        "verified": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "Whether the account carries a verification checkmark (see verification for which kind)."
                        },
                        "avatarUrl": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Profile image URL."
                        },
                        "bannerUrl": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Header image URL, or null."
                        },
                        "createdAt": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "When the account was created, as X writes it: \"Wed Dec 19 20:20:32 +0000 2007\" (UTC)."
                        },
                        "favoritesCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts the account has liked."
                        },
                        "listedCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Lists the account is on. Currently always null: X no longer sends it."
                        },
                        "fastFollowersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Currently always null: X no longer sends it. Use followersCount."
                        },
                        "normalFollowersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Currently always null: X no longer sends it. Use followersCount."
                        },
                        "creatorSubscriptionsCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Creator subscriptions the account has, or null when X leaves it out."
                        },
                        "pinnedTweetIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Ids of the pinned posts; empty when none."
                        },
                        "website": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The website link on the profile; null when there is none.",
                          "properties": {
                            "url": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The t.co short link."
                            },
                            "expandedUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The full address it leads to."
                            },
                            "displayUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The shortened form X displays, e.g. nasa.gov."
                            }
                          }
                        },
                        "descriptionUrls": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "properties": {
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The t.co short link."
                              },
                              "expandedUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The full address it leads to."
                              },
                              "displayUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The shortened form X displays, e.g. nasa.gov."
                              }
                            }
                          },
                          "description": "Links in the bio, expanded; empty when none."
                        },
                        "avatarUrlLarge": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The profile image at 400x400."
                        },
                        "verifiedType": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The kind of verification, e.g. Business or Government; null for none."
                        },
                        "protected": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "True when the account’s posts are visible to its followers only."
                        },
                        "profileLabel": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The affiliation badge shown next to the name (e.g. an organisation’s); null when there is none.",
                          "properties": {
                            "description": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The badge’s label, e.g. the organisation’s name."
                            },
                            "badgeUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The badge image."
                            },
                            "url": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Where the badge links to."
                            },
                            "urlType": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s link type, e.g. DeepLink."
                            },
                            "displayType": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "How X shows it, e.g. Badge."
                            },
                            "type": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s label type, e.g. BusinessLabel."
                            }
                          }
                        },
                        "verification": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "Which verification the account has.",
                          "properties": {
                            "blue": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "Verified through a subscription (the blue checkmark)."
                            },
                            "verified": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "Verified by X as notable (legacy verification)."
                            },
                            "identityVerified": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "The account holder’s identity was verified; null when X does not say."
                            },
                            "reason": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s own explanation of the checkmark, e.g. for a government account; null when it gives none."
                            }
                          }
                        }
                      }
                    },
                    "profiles": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true,
                        "properties": {
                          "id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Numeric account id, as a string. It stays the same when the handle changes."
                          },
                          "name": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Display name."
                          },
                          "handle": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Handle without the @."
                          },
                          "description": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Bio text."
                          },
                          "location": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Location as the account wrote it."
                          },
                          "followersCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Followers."
                          },
                          "followingCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Accounts followed."
                          },
                          "tweetsCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Posts, replies included."
                          },
                          "mediaCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Posts with media."
                          },
                          "verified": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "Whether the account carries a verification checkmark (see verification for which kind)."
                          },
                          "avatarUrl": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Profile image URL."
                          },
                          "bannerUrl": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Header image URL, or null."
                          },
                          "createdAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "When the account was created, as X writes it: \"Wed Dec 19 20:20:32 +0000 2007\" (UTC)."
                          },
                          "favoritesCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Posts the account has liked."
                          },
                          "listedCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Lists the account is on. Currently always null: X no longer sends it."
                          },
                          "fastFollowersCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Currently always null: X no longer sends it. Use followersCount."
                          },
                          "normalFollowersCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Currently always null: X no longer sends it. Use followersCount."
                          },
                          "creatorSubscriptionsCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Creator subscriptions the account has, or null when X leaves it out."
                          },
                          "pinnedTweetIds": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "Ids of the pinned posts; empty when none."
                          },
                          "website": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The website link on the profile; null when there is none.",
                            "properties": {
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The t.co short link."
                              },
                              "expandedUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The full address it leads to."
                              },
                              "displayUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The shortened form X displays, e.g. nasa.gov."
                              }
                            }
                          },
                          "descriptionUrls": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "url": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The t.co short link."
                                },
                                "expandedUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The full address it leads to."
                                },
                                "displayUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The shortened form X displays, e.g. nasa.gov."
                                }
                              }
                            },
                            "description": "Links in the bio, expanded; empty when none."
                          },
                          "avatarUrlLarge": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The profile image at 400x400."
                          },
                          "verifiedType": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The kind of verification, e.g. Business or Government; null for none."
                          },
                          "protected": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "True when the account’s posts are visible to its followers only."
                          },
                          "profileLabel": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The affiliation badge shown next to the name (e.g. an organisation’s); null when there is none.",
                            "properties": {
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The badge’s label, e.g. the organisation’s name."
                              },
                              "badgeUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The badge image."
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Where the badge links to."
                              },
                              "urlType": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "X’s link type, e.g. DeepLink."
                              },
                              "displayType": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "How X shows it, e.g. Badge."
                              },
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "X’s label type, e.g. BusinessLabel."
                              }
                            }
                          },
                          "verification": {
                            "type": "object",
                            "additionalProperties": true,
                            "description": "Which verification the account has.",
                            "properties": {
                              "blue": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Verified through a subscription (the blue checkmark)."
                              },
                              "verified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Verified by X as notable (legacy verification)."
                              },
                              "identityVerified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "The account holder’s identity was verified; null when X does not say."
                              },
                              "reason": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "X’s own explanation of the checkmark, e.g. for a government account; null when it gives none."
                              }
                            }
                          }
                        }
                      },
                      "description": "The accounts following this account."
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "listingType": "twitter-followers",
                      "user": {
                        "id": "11348282",
                        "name": "NASA",
                        "handle": "NASA",
                        "followersCount": 92312272,
                        "verified": true
                      },
                      "itemCount": 1,
                      "nextCursor": "1849213000000000000|2113790000000000000",
                      "profiles": [
                        {
                          "id": "783214",
                          "name": "X",
                          "handle": "X",
                          "description": "what’s happening?!",
                          "followersCount": 68400000,
                          "followingCount": 0,
                          "verified": true,
                          "avatarUrl": "https://pbs.twimg.com/profile_images/1683899100922511378/5lY42eHs_normal.jpg"
                        }
                      ],
                      "scrapedAt": "2026-10-25T19:08:43.990Z",
                      "transport": "twitter"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "invalid_input: the request needs fixing; error names the field.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "unauthorized: the API key is missing or not valid.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "insufficient_credits: no credits, trial or monthly allowance left.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "forbidden: this key or account is not allowed this request.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "quota_exceeded: a request-rate limit was reached.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "temporarily_unavailable, time_limit or (on a store route) store_unreachable: ask again (with time_limit, allow more time). Retryable.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ]
      }
    },
    "/verified-followers": {
      "post": {
        "operationId": "verified-followers",
        "tags": [
          "Network"
        ],
        "summary": "Fetch blue-verified followers",
        "description": "Retrieve blue-verified followers for a user — useful for filtering high-signal accounts from large follower lists. Returns the same profile shape as the followers endpoint. An account that does not exist is a 404 user_not_found (\"No X account with handle @x.\"), and so is a suspended one (the error says it is suspended); a 404 is final, not retryable, and not billed (2026-11-13; before, it was a retryable 503).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "handle": {
                    "type": "string",
                    "description": "Twitter handle without @."
                  },
                  "count": {
                    "type": "integer",
                    "description": "Number of accounts (max 100).",
                    "example": "25"
                  },
                  "cursor": {
                    "type": "string",
                    "description": "Pagination cursor."
                  },
                  "maxItems": {
                    "type": "integer",
                    "description": "Collect up to this many results in one call (1-500), following the pages for you. Each page of results returned bills one credit, and the last page comes back whole, so itemCount can exceed maxItems by less than a page. A call stops early at the end of the list or after about 90 seconds; hasMore and nextCursor then continue it. Leave it out for one page, billed one credit. Works with cursor and count."
                  },
                  "timeoutMs": {
                    "type": "integer",
                    "description": "Time limit for the whole request, in milliseconds (1000–120000; values outside are brought into that range). It can only shorten the time a request may take, which is about 90 seconds at most. With maxItems, a call that runs out returns the pages it has, billed for those, with hasMore and nextCursor; a call with nothing to return yet fails with a 503 you can retry. We answer at the latest about 2 seconds before timeoutMs runs out (15% of it, at least 0.75 s, for limits under 13 seconds), so you can set it to your own client’s timeout. Left out, the request takes the time it needs."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "handle"
                ]
              },
              "examples": {
                "default": {
                  "value": {
                    "handle": "NASA",
                    "count": 20
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "scrapedAt": {
                      "type": "string",
                      "description": "ISO 8601 time the result was produced."
                    },
                    "transport": {
                      "type": "string",
                      "description": "The data source: always the platform id, \"twitter\"."
                    },
                    "listingType": {
                      "type": "string",
                      "description": "Which list this is, e.g. twitter-user-tweets."
                    },
                    "itemCount": {
                      "type": "integer",
                      "description": "Number of items returned on this page."
                    },
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Pass as cursor, with the same other parameters, for the next page; null when there is none."
                    },
                    "hasMore": {
                      "type": "boolean",
                      "description": "Whether more results follow: repeat the call with cursor set to nextCursor while it is true. Always present on followers, following and verified-followers; on the other lists, present with maxItems."
                    },
                    "pagesFetched": {
                      "type": "integer",
                      "description": "With maxItems: the pages of results in this response, one credit each. Absent without maxItems (one page, one credit)."
                    },
                    "note": {
                      "type": "string",
                      "description": "With maxItems, why the call stopped before maxItems (the end of the list, or the time or page limit of one call, in which case hasMore is true and nextCursor continues). On search, also present when nothing was found."
                    },
                    "user": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true,
                      "description": "The account whose list this is, as user-profile-details returns it.",
                      "properties": {
                        "id": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Numeric account id, as a string. It stays the same when the handle changes."
                        },
                        "name": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Display name."
                        },
                        "handle": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Handle without the @."
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Bio text."
                        },
                        "location": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Location as the account wrote it."
                        },
                        "followersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Followers."
                        },
                        "followingCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Accounts followed."
                        },
                        "tweetsCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts, replies included."
                        },
                        "mediaCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts with media."
                        },
                        "verified": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "Whether the account carries a verification checkmark (see verification for which kind)."
                        },
                        "avatarUrl": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Profile image URL."
                        },
                        "bannerUrl": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Header image URL, or null."
                        },
                        "createdAt": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "When the account was created, as X writes it: \"Wed Dec 19 20:20:32 +0000 2007\" (UTC)."
                        },
                        "favoritesCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Posts the account has liked."
                        },
                        "listedCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Lists the account is on. Currently always null: X no longer sends it."
                        },
                        "fastFollowersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Currently always null: X no longer sends it. Use followersCount."
                        },
                        "normalFollowersCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Currently always null: X no longer sends it. Use followersCount."
                        },
                        "creatorSubscriptionsCount": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "description": "Creator subscriptions the account has, or null when X leaves it out."
                        },
                        "pinnedTweetIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Ids of the pinned posts; empty when none."
                        },
                        "website": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The website link on the profile; null when there is none.",
                          "properties": {
                            "url": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The t.co short link."
                            },
                            "expandedUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The full address it leads to."
                            },
                            "displayUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The shortened form X displays, e.g. nasa.gov."
                            }
                          }
                        },
                        "descriptionUrls": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "properties": {
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The t.co short link."
                              },
                              "expandedUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The full address it leads to."
                              },
                              "displayUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The shortened form X displays, e.g. nasa.gov."
                              }
                            }
                          },
                          "description": "Links in the bio, expanded; empty when none."
                        },
                        "avatarUrlLarge": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The profile image at 400x400."
                        },
                        "verifiedType": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The kind of verification, e.g. Business or Government; null for none."
                        },
                        "protected": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "True when the account’s posts are visible to its followers only."
                        },
                        "profileLabel": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The affiliation badge shown next to the name (e.g. an organisation’s); null when there is none.",
                          "properties": {
                            "description": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The badge’s label, e.g. the organisation’s name."
                            },
                            "badgeUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The badge image."
                            },
                            "url": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Where the badge links to."
                            },
                            "urlType": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s link type, e.g. DeepLink."
                            },
                            "displayType": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "How X shows it, e.g. Badge."
                            },
                            "type": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s label type, e.g. BusinessLabel."
                            }
                          }
                        },
                        "verification": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "Which verification the account has.",
                          "properties": {
                            "blue": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "Verified through a subscription (the blue checkmark)."
                            },
                            "verified": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "Verified by X as notable (legacy verification)."
                            },
                            "identityVerified": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "The account holder’s identity was verified; null when X does not say."
                            },
                            "reason": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "X’s own explanation of the checkmark, e.g. for a government account; null when it gives none."
                            }
                          }
                        }
                      }
                    },
                    "profiles": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true,
                        "properties": {
                          "id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Numeric account id, as a string. It stays the same when the handle changes."
                          },
                          "name": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Display name."
                          },
                          "handle": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Handle without the @."
                          },
                          "description": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Bio text."
                          },
                          "location": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Location as the account wrote it."
                          },
                          "followersCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Followers."
                          },
                          "followingCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Accounts followed."
                          },
                          "tweetsCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Posts, replies included."
                          },
                          "mediaCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Posts with media."
                          },
                          "verified": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "Whether the account carries a verification checkmark (see verification for which kind)."
                          },
                          "avatarUrl": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Profile image URL."
                          },
                          "bannerUrl": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Header image URL, or null."
                          },
                          "createdAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "When the account was created, as X writes it: \"Wed Dec 19 20:20:32 +0000 2007\" (UTC)."
                          },
                          "favoritesCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Posts the account has liked."
                          },
                          "listedCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Lists the account is on. Currently always null: X no longer sends it."
                          },
                          "fastFollowersCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Currently always null: X no longer sends it. Use followersCount."
                          },
                          "normalFollowersCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Currently always null: X no longer sends it. Use followersCount."
                          },
                          "creatorSubscriptionsCount": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Creator subscriptions the account has, or null when X leaves it out."
                          },
                          "pinnedTweetIds": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "Ids of the pinned posts; empty when none."
                          },
                          "website": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The website link on the profile; null when there is none.",
                            "properties": {
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The t.co short link."
                              },
                              "expandedUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The full address it leads to."
                              },
                              "displayUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The shortened form X displays, e.g. nasa.gov."
                              }
                            }
                          },
                          "descriptionUrls": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "url": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The t.co short link."
                                },
                                "expandedUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The full address it leads to."
                                },
                                "displayUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The shortened form X displays, e.g. nasa.gov."
                                }
                              }
                            },
                            "description": "Links in the bio, expanded; empty when none."
                          },
                          "avatarUrlLarge": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The profile image at 400x400."
                          },
                          "verifiedType": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The kind of verification, e.g. Business or Government; null for none."
                          },
                          "protected": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "True when the account’s posts are visible to its followers only."
                          },
                          "profileLabel": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The affiliation badge shown next to the name (e.g. an organisation’s); null when there is none.",
                            "properties": {
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The badge’s label, e.g. the organisation’s name."
                              },
                              "badgeUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The badge image."
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Where the badge links to."
                              },
                              "urlType": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "X’s link type, e.g. DeepLink."
                              },
                              "displayType": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "How X shows it, e.g. Badge."
                              },
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "X’s label type, e.g. BusinessLabel."
                              }
                            }
                          },
                          "verification": {
                            "type": "object",
                            "additionalProperties": true,
                            "description": "Which verification the account has.",
                            "properties": {
                              "blue": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Verified through a subscription (the blue checkmark)."
                              },
                              "verified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Verified by X as notable (legacy verification)."
                              },
                              "identityVerified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "The account holder’s identity was verified; null when X does not say."
                              },
                              "reason": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "X’s own explanation of the checkmark, e.g. for a government account; null when it gives none."
                              }
                            }
                          }
                        }
                      },
                      "description": "The followers with a verification checkmark."
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "listingType": "twitter-verified-followers",
                      "user": {
                        "id": "11348282",
                        "name": "NASA",
                        "handle": "NASA",
                        "followersCount": 92312272,
                        "verified": true
                      },
                      "itemCount": 1,
                      "nextCursor": "1849213000000000000|2113790000000000000",
                      "profiles": [
                        {
                          "id": "783214",
                          "name": "X",
                          "handle": "X",
                          "description": "what’s happening?!",
                          "followersCount": 68400000,
                          "followingCount": 0,
                          "verified": true,
                          "avatarUrl": "https://pbs.twimg.com/profile_images/1683899100922511378/5lY42eHs_normal.jpg"
                        }
                      ],
                      "scrapedAt": "2026-10-25T19:08:43.990Z",
                      "transport": "twitter"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "invalid_input: the request needs fixing; error names the field.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "unauthorized: the API key is missing or not valid.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "insufficient_credits: no credits, trial or monthly allowance left.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "forbidden: this key or account is not allowed this request.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "quota_exceeded: a request-rate limit was reached.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "temporarily_unavailable, time_limit or (on a store route) store_unreachable: ask again (with time_limit, allow more time). Retryable.",
            "headers": {
              "X-Request-Id": {
                "description": "The request id, equal to requestId in the body.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ]
      }
    }
  }
}