{
  "openapi": "3.1.0",
  "info": {
    "title": "Twitter API",
    "version": "1.0.0",
    "description": "Twitter/X scraping endpoints exposed through FetchLayer."
  },
  "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": {
    "/search": {
      "post": {
        "operationId": "search",
        "tags": [
          "Search"
        ],
        "summary": "Search X/Twitter by keyword",
        "description": "Search X by keyword, hashtag or phrase on one of its tabs, narrowed by author, date range, language, minimum engagement, media, replies and reposts if you like. Top, Latest, Media and Lists return tweets in tweets, each with its text, author and counts; People returns the matching accounts in profiles, with tweets empty.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "query": {
                    "type": "string",
                    "description": "Search text: a keyword, hashtag or phrase. Required unless at least one filter below is given. A date limit typed into the text itself (until:2026-10-15) also returns posts from that day; the until parameter cuts off at 00:00 UTC."
                  },
                  "product": {
                    "type": "string",
                    "description": "The tab to search: Top, Latest, People, Media or Lists. People returns accounts (profiles); the others return tweets.",
                    "example": "Top"
                  },
                  "count": {
                    "type": "integer",
                    "description": "Results per page, at most 20: a higher value still returns 20. Use nextCursor for more.",
                    "example": "25"
                  },
                  "cursor": {
                    "type": "string",
                    "description": "A previous response’s nextCursor, with the same other parameters, for the next page."
                  },
                  "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."
                  },
                  "from": {
                    "type": "string",
                    "description": "Only posts by this handle (with or without @)."
                  },
                  "to": {
                    "type": "string",
                    "description": "Only replies to this handle."
                  },
                  "mentioning": {
                    "type": "string",
                    "description": "Only posts mentioning this handle."
                  },
                  "since": {
                    "type": "string",
                    "description": "Only posts from this moment on: a date YYYY-MM-DD (00:00 UTC that day) or an ISO 8601 time with a zone, e.g. 2026-10-01T12:00:00Z."
                  },
                  "until": {
                    "type": "string",
                    "description": "Only posts before this moment (exclusive), in the same forms as since. Must be later than since."
                  },
                  "sinceTime": {
                    "type": "integer",
                    "description": "Only posts from this Unix time (seconds) on."
                  },
                  "untilTime": {
                    "type": "integer",
                    "description": "Only posts before this Unix time (seconds). Must be later than sinceTime."
                  },
                  "lang": {
                    "type": "string",
                    "description": "Only posts in this language: a two-letter ISO 639-1 code, e.g. en."
                  },
                  "minLikes": {
                    "type": "integer",
                    "description": "Only posts with at least this many likes. Counts can lag slightly behind the live post, so a result may show a little under the minimum."
                  },
                  "minRetweets": {
                    "type": "integer",
                    "description": "Only posts with at least this many reposts. Counts can lag slightly behind the live post, so a result may show a little under the minimum."
                  },
                  "minReplies": {
                    "type": "integer",
                    "description": "Only posts with at least this many replies. Counts can lag slightly behind the live post, so a result may show a little under the minimum."
                  },
                  "hasMedia": {
                    "type": "boolean",
                    "description": "true: only posts with media; false: only posts without."
                  },
                  "hasImages": {
                    "type": "boolean",
                    "description": "true: only posts with images; false: only posts without."
                  },
                  "hasVideos": {
                    "type": "boolean",
                    "description": "true: only posts with video; false: only posts without."
                  },
                  "hasLinks": {
                    "type": "boolean",
                    "description": "true: only posts with links; false: only posts without."
                  },
                  "verifiedOnly": {
                    "type": "boolean",
                    "description": "true: only posts by verified accounts."
                  },
                  "excludeReplies": {
                    "type": "boolean",
                    "description": "true: leave replies out."
                  },
                  "excludeRetweets": {
                    "type": "boolean",
                    "description": "true: leave reposts out."
                  },
                  "sinceId": {
                    "type": "string",
                    "description": "Only posts newer than this post id."
                  },
                  "maxId": {
                    "type": "string",
                    "description": "Only posts up to and including this post id."
                  },
                  "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
              },
              "examples": {
                "default": {
                  "value": {
                    "query": "artemis",
                    "product": "Latest",
                    "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."
                    },
                    "query": {
                      "type": "string",
                      "description": "The query text you sent; \"\" when you sent filters only."
                    },
                    "effectiveQuery": {
                      "type": "string",
                      "description": "With filters: the search we ran, your query and filters combined. Absent without filters."
                    },
                    "product": {
                      "type": "string",
                      "description": "The tab searched: Top, Latest, People, Media or Lists."
                    },
                    "tweets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true,
                        "properties": {
                          "id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Tweet id, as a string (it does not fit a JavaScript number)."
                          },
                          "conversationId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the thread’s first tweet."
                          },
                          "createdAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "When it was posted, as X writes it: \"Fri Oct 23 23:37:56 +0000 2026\" (UTC)."
                          },
                          "text": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Full tweet text, complete for a long post too (2026-11-13: for a post over 280 characters it used to stop at about 280). Links appear as t.co short links."
                          },
                          "lang": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Language X detected for the text (BCP 47, e.g. en), or null."
                          },
                          "source": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The posting client, when X says; usually null."
                          },
                          "inReplyToStatusId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the id of the tweet it answers; null otherwise."
                          },
                          "inReplyToUserId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the account id of the author it answers; null otherwise."
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Link to the tweet: https://x.com/<handle>/status/<id>, or https://x.com/i/status/<id> when the author is missing (x.com redirects it). Null only when the tweet has no id."
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Who posted it.",
                            "properties": {
                              "id": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The author’s numeric account id, as a string."
                              },
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Display name."
                              },
                              "handle": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Handle without the @."
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Bio text, or null when the account has none."
                              },
                              "followersCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Followers of the author; null only when X leaves it out."
                              },
                              "followingCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Accounts the author follows; null only when X leaves it out."
                              },
                              "verified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Whether the account carries a verification checkmark."
                              },
                              "avatarUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Profile image URL (48x48)."
                              },
                              "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."
                              }
                            }
                          },
                          "counts": {
                            "type": "object",
                            "properties": {
                              "replies": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Replies."
                              },
                              "reposts": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Reposts (retweets)."
                              },
                              "likes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Likes."
                              },
                              "quotes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Quote posts."
                              },
                              "bookmarks": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Bookmarks."
                              },
                              "views": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Views, or null when X shows none."
                              }
                            },
                            "additionalProperties": true
                          },
                          "media": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Image URL; for a video, its preview frame."
                                },
                                "expandedUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Link to the media on x.com."
                                }
                              }
                            },
                            "description": "Attached photos, videos and GIFs; empty when there are none."
                          },
                          "fullText": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The complete text, with &amp;, &lt; and &gt; unescaped. For a long post it equals text, which carries the whole post."
                          },
                          "isLongPost": {
                            "type": "boolean",
                            "description": "True for a post in X’s long-post format. text carries all of it; fullText is the same text with &amp;, &lt; and &gt; unescaped."
                          },
                          "isQuote": {
                            "type": "boolean",
                            "description": "True when the post quotes another post."
                          },
                          "quotedTweetId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the quoted post, also when that post is no longer available."
                          },
                          "quotedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The quoted post, with the same fields as this one, one level deep (its own quotedTweet and retweetedTweet are null). Null when nothing is quoted or the quoted post is unavailable."
                          },
                          "isRetweet": {
                            "type": "boolean",
                            "description": "True when the post is a repost."
                          },
                          "retweetedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The reposted post, one level deep like quotedTweet; null otherwise."
                          },
                          "mediaDetails": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The media id."
                                },
                                "altText": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The alt text the author wrote; null when none."
                                },
                                "width": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Width of the original upload, in pixels."
                                },
                                "height": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Height of the original upload, in pixels."
                                },
                                "video": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "additionalProperties": true,
                                  "description": "For a video or GIF: durationMs (null for a GIF), aspectRatio as [width, height], and variants[] of MP4 files with url, contentType and bitrate. Null for a photo."
                                }
                              }
                            },
                            "description": "One entry per media item, in the same order: id, alt text, size and video files."
                          },
                          "entities": {
                            "type": "object",
                            "additionalProperties": true,
                            "description": "What the text links to; for a long post, of fullText.",
                            "properties": {
                              "urls": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Links in the text, expanded (url, expandedUrl, displayUrl). Media links are in media instead."
                              },
                              "hashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Hashtags, without the #."
                              },
                              "mentions": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Accounts mentioned: handle, id and name."
                              },
                              "cashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Cashtags, without the $."
                              }
                            }
                          },
                          "card": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The link preview: name (the card type, e.g. summary_large_image), url, title, description, domain and imageUrl. Null when there is none."
                          },
                          "poll": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "For a poll: choices[] (label and votes so far as count), endsAt (ISO 8601), isFinal (true once closed) and durationMinutes. Null otherwise."
                          },
                          "editControl": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Edit history: editTweetIds (every version, oldest first; one id when never edited), isEditEligible, editableUntil (ISO 8601) and editsRemaining."
                          },
                          "possiblySensitive": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "X’s sensitive-media flag on the post."
                          },
                          "communityNote": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The community note shown on the post: id, title (e.g. \"Readers added context\", it changes as the note is rated), text, language, url and urls[]. Null when there is none."
                          },
                          "isPromoted": {
                            "type": "boolean",
                            "description": "True for an ad X placed in the list. It is kept in place, only labelled."
                          }
                        }
                      },
                      "description": "The tweets found, on every tab but People; empty on People."
                    },
                    "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 found, on the People tab only; empty on every other tab. Same shape as the follower lists’ profiles."
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "listingType": "twitter-search",
                      "query": "artemis",
                      "product": "Latest",
                      "itemCount": 1,
                      "nextCursor": "DAADDAABCgABHVf6hGP__z8KAAIdV_ZnL5ag",
                      "tweets": [
                        {
                          "id": "2113776971603689874",
                          "conversationId": "2113776971603689874",
                          "createdAt": "Fri Oct 23 23:37:56 +0000 2026",
                          "text": "We are not slowing down. 🚀 Our Artemis II crew is training for their trip around the Moon.",
                          "lang": "en",
                          "source": null,
                          "inReplyToStatusId": null,
                          "inReplyToUserId": null,
                          "url": "https://x.com/NASA/status/2113776971603689874",
                          "author": {
                            "id": "11348282",
                            "name": "NASA",
                            "handle": "NASA",
                            "description": "Making the seemingly impossible, possible. ✨",
                            "followersCount": 92312272,
                            "followingCount": 115,
                            "verified": true
                          },
                          "counts": {
                            "replies": 339,
                            "reposts": 970,
                            "likes": 7439,
                            "quotes": 83,
                            "bookmarks": 341,
                            "views": 1273965
                          },
                          "media": [
                            {
                              "type": "video",
                              "mediaUrl": "https://pbs.twimg.com/media/HVWk812WIAAg_hz.jpg",
                              "expandedUrl": "https://x.com/NASA/status/2113776971603689874/video/1"
                            }
                          ]
                        }
                      ],
                      "profiles": [],
                      "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": []
          }
        ]
      }
    },
    "/tweet-detail": {
      "post": {
        "operationId": "tweet-detail",
        "tags": [
          "Content"
        ],
        "summary": "Fetch a tweet by ID",
        "description": "Retrieve detailed metadata for a specific tweet by ID including full text, media, engagement stats, and thread context. A post that does not exist or was deleted is a 404 tweet_not_found, final, not retryable and not billed (2026-11-13; before, it was a 200 with an empty result).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tweetId": {
                    "type": "string",
                    "description": "Tweet ID."
                  },
                  "screenName": {
                    "type": "string",
                    "description": "Optional screen name context for URL construction."
                  },
                  "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": [
                  "tweetId"
                ]
              },
              "examples": {
                "default": {
                  "value": {
                    "tweetId": "2113776971603689874"
                  }
                }
              }
            }
          }
        },
        "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\"."
                    },
                    "entityType": {
                      "type": "string",
                      "description": "Always twitter-tweet-detail."
                    },
                    "cached": {
                      "type": "boolean",
                      "description": "Present (true) only when the answer is a recent copy rather than a fresh read; scrapedAt then says when it was read. Only for a post at least 7 days old, and at most an hour old: counts and replies may lag by up to an hour."
                    },
                    "tweet": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true,
                      "description": "The tweet; null when it could not be found.",
                      "properties": {
                        "id": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Tweet id, as a string (it does not fit a JavaScript number)."
                        },
                        "conversationId": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Id of the thread’s first tweet."
                        },
                        "createdAt": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "When it was posted, as X writes it: \"Fri Oct 23 23:37:56 +0000 2026\" (UTC)."
                        },
                        "text": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Full tweet text, complete for a long post too (2026-11-13: for a post over 280 characters it used to stop at about 280). Links appear as t.co short links."
                        },
                        "lang": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Language X detected for the text (BCP 47, e.g. en), or null."
                        },
                        "source": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The posting client, when X says; usually null."
                        },
                        "inReplyToStatusId": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "For a reply, the id of the tweet it answers; null otherwise."
                        },
                        "inReplyToUserId": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "For a reply, the account id of the author it answers; null otherwise."
                        },
                        "url": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Link to the tweet: https://x.com/<handle>/status/<id>, or https://x.com/i/status/<id> when the author is missing (x.com redirects it). Null only when the tweet has no id."
                        },
                        "author": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "Who posted it.",
                          "properties": {
                            "id": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The author’s numeric account id, as a string."
                            },
                            "name": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Display name."
                            },
                            "handle": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Handle without the @."
                            },
                            "description": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Bio text, or null when the account has none."
                            },
                            "followersCount": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Followers of the author; null only when X leaves it out."
                            },
                            "followingCount": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Accounts the author follows; null only when X leaves it out."
                            },
                            "verified": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "Whether the account carries a verification checkmark."
                            },
                            "avatarUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Profile image URL (48x48)."
                            },
                            "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."
                            }
                          }
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "replies": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Replies."
                            },
                            "reposts": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Reposts (retweets)."
                            },
                            "likes": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Likes."
                            },
                            "quotes": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Quote posts."
                            },
                            "bookmarks": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Bookmarks."
                            },
                            "views": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Views, or null when X shows none."
                            }
                          },
                          "additionalProperties": true
                        },
                        "media": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "properties": {
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "photo, video or animated_gif."
                              },
                              "mediaUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Image URL; for a video, its preview frame."
                              },
                              "expandedUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Link to the media on x.com."
                              }
                            }
                          },
                          "description": "Attached photos, videos and GIFs; empty when there are none."
                        },
                        "fullText": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The complete text, with &amp;, &lt; and &gt; unescaped. For a long post it equals text, which carries the whole post."
                        },
                        "isLongPost": {
                          "type": "boolean",
                          "description": "True for a post in X’s long-post format. text carries all of it; fullText is the same text with &amp;, &lt; and &gt; unescaped."
                        },
                        "isQuote": {
                          "type": "boolean",
                          "description": "True when the post quotes another post."
                        },
                        "quotedTweetId": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Id of the quoted post, also when that post is no longer available."
                        },
                        "quotedTweet": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The quoted post, with the same fields as this one, one level deep (its own quotedTweet and retweetedTweet are null). Null when nothing is quoted or the quoted post is unavailable."
                        },
                        "isRetweet": {
                          "type": "boolean",
                          "description": "True when the post is a repost."
                        },
                        "retweetedTweet": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The reposted post, one level deep like quotedTweet; null otherwise."
                        },
                        "mediaDetails": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "properties": {
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "photo, video or animated_gif."
                              },
                              "mediaId": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The media id."
                              },
                              "altText": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The alt text the author wrote; null when none."
                              },
                              "width": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Width of the original upload, in pixels."
                              },
                              "height": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Height of the original upload, in pixels."
                              },
                              "video": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "additionalProperties": true,
                                "description": "For a video or GIF: durationMs (null for a GIF), aspectRatio as [width, height], and variants[] of MP4 files with url, contentType and bitrate. Null for a photo."
                              }
                            }
                          },
                          "description": "One entry per media item, in the same order: id, alt text, size and video files."
                        },
                        "entities": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "What the text links to; for a long post, of fullText.",
                          "properties": {
                            "urls": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "additionalProperties": true
                              },
                              "description": "Links in the text, expanded (url, expandedUrl, displayUrl). Media links are in media instead."
                            },
                            "hashtags": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "Hashtags, without the #."
                            },
                            "mentions": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "additionalProperties": true
                              },
                              "description": "Accounts mentioned: handle, id and name."
                            },
                            "cashtags": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "Cashtags, without the $."
                            }
                          }
                        },
                        "card": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The link preview: name (the card type, e.g. summary_large_image), url, title, description, domain and imageUrl. Null when there is none."
                        },
                        "poll": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "For a poll: choices[] (label and votes so far as count), endsAt (ISO 8601), isFinal (true once closed) and durationMinutes. Null otherwise."
                        },
                        "editControl": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "Edit history: editTweetIds (every version, oldest first; one id when never edited), isEditEligible, editableUntil (ISO 8601) and editsRemaining."
                        },
                        "possiblySensitive": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "X’s sensitive-media flag on the post."
                        },
                        "communityNote": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The community note shown on the post: id, title (e.g. \"Readers added context\", it changes as the note is rated), text, language, url and urls[]. Null when there is none."
                        },
                        "isPromoted": {
                          "type": "boolean",
                          "description": "True for an ad X placed in the list. It is kept in place, only labelled."
                        }
                      }
                    },
                    "conversation": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true,
                        "properties": {
                          "id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Tweet id, as a string (it does not fit a JavaScript number)."
                          },
                          "conversationId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the thread’s first tweet."
                          },
                          "createdAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "When it was posted, as X writes it: \"Fri Oct 23 23:37:56 +0000 2026\" (UTC)."
                          },
                          "text": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Full tweet text, complete for a long post too (2026-11-13: for a post over 280 characters it used to stop at about 280). Links appear as t.co short links."
                          },
                          "lang": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Language X detected for the text (BCP 47, e.g. en), or null."
                          },
                          "source": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The posting client, when X says; usually null."
                          },
                          "inReplyToStatusId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the id of the tweet it answers; null otherwise."
                          },
                          "inReplyToUserId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the account id of the author it answers; null otherwise."
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Link to the tweet: https://x.com/<handle>/status/<id>, or https://x.com/i/status/<id> when the author is missing (x.com redirects it). Null only when the tweet has no id."
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Who posted it.",
                            "properties": {
                              "id": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The author’s numeric account id, as a string."
                              },
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Display name."
                              },
                              "handle": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Handle without the @."
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Bio text, or null when the account has none."
                              },
                              "followersCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Followers of the author; null only when X leaves it out."
                              },
                              "followingCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Accounts the author follows; null only when X leaves it out."
                              },
                              "verified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Whether the account carries a verification checkmark."
                              },
                              "avatarUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Profile image URL (48x48)."
                              },
                              "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."
                              }
                            }
                          },
                          "counts": {
                            "type": "object",
                            "properties": {
                              "replies": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Replies."
                              },
                              "reposts": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Reposts (retweets)."
                              },
                              "likes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Likes."
                              },
                              "quotes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Quote posts."
                              },
                              "bookmarks": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Bookmarks."
                              },
                              "views": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Views, or null when X shows none."
                              }
                            },
                            "additionalProperties": true
                          },
                          "media": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Image URL; for a video, its preview frame."
                                },
                                "expandedUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Link to the media on x.com."
                                }
                              }
                            },
                            "description": "Attached photos, videos and GIFs; empty when there are none."
                          },
                          "fullText": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The complete text, with &amp;, &lt; and &gt; unescaped. For a long post it equals text, which carries the whole post."
                          },
                          "isLongPost": {
                            "type": "boolean",
                            "description": "True for a post in X’s long-post format. text carries all of it; fullText is the same text with &amp;, &lt; and &gt; unescaped."
                          },
                          "isQuote": {
                            "type": "boolean",
                            "description": "True when the post quotes another post."
                          },
                          "quotedTweetId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the quoted post, also when that post is no longer available."
                          },
                          "quotedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The quoted post, with the same fields as this one, one level deep (its own quotedTweet and retweetedTweet are null). Null when nothing is quoted or the quoted post is unavailable."
                          },
                          "isRetweet": {
                            "type": "boolean",
                            "description": "True when the post is a repost."
                          },
                          "retweetedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The reposted post, one level deep like quotedTweet; null otherwise."
                          },
                          "mediaDetails": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The media id."
                                },
                                "altText": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The alt text the author wrote; null when none."
                                },
                                "width": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Width of the original upload, in pixels."
                                },
                                "height": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Height of the original upload, in pixels."
                                },
                                "video": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "additionalProperties": true,
                                  "description": "For a video or GIF: durationMs (null for a GIF), aspectRatio as [width, height], and variants[] of MP4 files with url, contentType and bitrate. Null for a photo."
                                }
                              }
                            },
                            "description": "One entry per media item, in the same order: id, alt text, size and video files."
                          },
                          "entities": {
                            "type": "object",
                            "additionalProperties": true,
                            "description": "What the text links to; for a long post, of fullText.",
                            "properties": {
                              "urls": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Links in the text, expanded (url, expandedUrl, displayUrl). Media links are in media instead."
                              },
                              "hashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Hashtags, without the #."
                              },
                              "mentions": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Accounts mentioned: handle, id and name."
                              },
                              "cashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Cashtags, without the $."
                              }
                            }
                          },
                          "card": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The link preview: name (the card type, e.g. summary_large_image), url, title, description, domain and imageUrl. Null when there is none."
                          },
                          "poll": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "For a poll: choices[] (label and votes so far as count), endsAt (ISO 8601), isFinal (true once closed) and durationMinutes. Null otherwise."
                          },
                          "editControl": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Edit history: editTweetIds (every version, oldest first; one id when never edited), isEditEligible, editableUntil (ISO 8601) and editsRemaining."
                          },
                          "possiblySensitive": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "X’s sensitive-media flag on the post."
                          },
                          "communityNote": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The community note shown on the post: id, title (e.g. \"Readers added context\", it changes as the note is rated), text, language, url and urls[]. Null when there is none."
                          },
                          "isPromoted": {
                            "type": "boolean",
                            "description": "True for an ad X placed in the list. It is kept in place, only labelled."
                          }
                        }
                      },
                      "description": "Other tweets of the thread shown with it, each with the same fields as tweet."
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "entityType": "twitter-tweet-detail",
                      "tweet": {
                        "id": "2113776971603689874",
                        "conversationId": "2113776971603689874",
                        "createdAt": "Fri Oct 23 23:37:56 +0000 2026",
                        "text": "We are not slowing down. 🚀 Our Artemis II crew is training for their trip around the Moon.",
                        "lang": "en",
                        "source": null,
                        "inReplyToStatusId": null,
                        "inReplyToUserId": null,
                        "url": "https://x.com/NASA/status/2113776971603689874",
                        "author": {
                          "id": "11348282",
                          "name": "NASA",
                          "handle": "NASA",
                          "description": "Making the seemingly impossible, possible. ✨",
                          "followersCount": 92312272,
                          "followingCount": 115,
                          "verified": true
                        },
                        "counts": {
                          "replies": 339,
                          "reposts": 970,
                          "likes": 7439,
                          "quotes": 83,
                          "bookmarks": 341,
                          "views": 1273965
                        },
                        "media": [
                          {
                            "type": "video",
                            "mediaUrl": "https://pbs.twimg.com/media/HVWk812WIAAg_hz.jpg",
                            "expandedUrl": "https://x.com/NASA/status/2113776971603689874/video/1"
                          }
                        ]
                      },
                      "conversation": [],
                      "scrapedAt": "2026-10-25T19:10:02.112Z",
                      "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": []
          }
        ]
      }
    },
    "/tweet-replies": {
      "post": {
        "operationId": "tweet-replies",
        "tags": [
          "Content"
        ],
        "summary": "Fetch replies for a tweet",
        "description": "Retrieve reply tweets and continuation cursors for a specific tweet. Each reply includes the same fields as a tweet result. On the first page, a post that does not exist or was deleted is a 404 tweet_not_found, final, not retryable and not billed (2026-11-13).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tweetId": {
                    "type": "string",
                    "description": "Tweet ID."
                  },
                  "screenName": {
                    "type": "string",
                    "description": "Optional screen name context."
                  },
                  "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": [
                  "tweetId"
                ]
              },
              "examples": {
                "default": {
                  "value": {
                    "tweetId": "2113776971603689874"
                  }
                }
              }
            }
          }
        },
        "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."
                    },
                    "tweetId": {
                      "type": "string",
                      "description": "The tweet whose replies these are."
                    },
                    "replies": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true,
                        "properties": {
                          "id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Tweet id, as a string (it does not fit a JavaScript number)."
                          },
                          "conversationId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the thread’s first tweet."
                          },
                          "createdAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "When it was posted, as X writes it: \"Fri Oct 23 23:37:56 +0000 2026\" (UTC)."
                          },
                          "text": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Full tweet text, complete for a long post too (2026-11-13: for a post over 280 characters it used to stop at about 280). Links appear as t.co short links."
                          },
                          "lang": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Language X detected for the text (BCP 47, e.g. en), or null."
                          },
                          "source": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The posting client, when X says; usually null."
                          },
                          "inReplyToStatusId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the id of the tweet it answers; null otherwise."
                          },
                          "inReplyToUserId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the account id of the author it answers; null otherwise."
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Link to the tweet: https://x.com/<handle>/status/<id>, or https://x.com/i/status/<id> when the author is missing (x.com redirects it). Null only when the tweet has no id."
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Who posted it.",
                            "properties": {
                              "id": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The author’s numeric account id, as a string."
                              },
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Display name."
                              },
                              "handle": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Handle without the @."
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Bio text, or null when the account has none."
                              },
                              "followersCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Followers of the author; null only when X leaves it out."
                              },
                              "followingCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Accounts the author follows; null only when X leaves it out."
                              },
                              "verified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Whether the account carries a verification checkmark."
                              },
                              "avatarUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Profile image URL (48x48)."
                              },
                              "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."
                              }
                            }
                          },
                          "counts": {
                            "type": "object",
                            "properties": {
                              "replies": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Replies."
                              },
                              "reposts": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Reposts (retweets)."
                              },
                              "likes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Likes."
                              },
                              "quotes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Quote posts."
                              },
                              "bookmarks": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Bookmarks."
                              },
                              "views": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Views, or null when X shows none."
                              }
                            },
                            "additionalProperties": true
                          },
                          "media": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Image URL; for a video, its preview frame."
                                },
                                "expandedUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Link to the media on x.com."
                                }
                              }
                            },
                            "description": "Attached photos, videos and GIFs; empty when there are none."
                          },
                          "fullText": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The complete text, with &amp;, &lt; and &gt; unescaped. For a long post it equals text, which carries the whole post."
                          },
                          "isLongPost": {
                            "type": "boolean",
                            "description": "True for a post in X’s long-post format. text carries all of it; fullText is the same text with &amp;, &lt; and &gt; unescaped."
                          },
                          "isQuote": {
                            "type": "boolean",
                            "description": "True when the post quotes another post."
                          },
                          "quotedTweetId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the quoted post, also when that post is no longer available."
                          },
                          "quotedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The quoted post, with the same fields as this one, one level deep (its own quotedTweet and retweetedTweet are null). Null when nothing is quoted or the quoted post is unavailable."
                          },
                          "isRetweet": {
                            "type": "boolean",
                            "description": "True when the post is a repost."
                          },
                          "retweetedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The reposted post, one level deep like quotedTweet; null otherwise."
                          },
                          "mediaDetails": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The media id."
                                },
                                "altText": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The alt text the author wrote; null when none."
                                },
                                "width": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Width of the original upload, in pixels."
                                },
                                "height": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Height of the original upload, in pixels."
                                },
                                "video": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "additionalProperties": true,
                                  "description": "For a video or GIF: durationMs (null for a GIF), aspectRatio as [width, height], and variants[] of MP4 files with url, contentType and bitrate. Null for a photo."
                                }
                              }
                            },
                            "description": "One entry per media item, in the same order: id, alt text, size and video files."
                          },
                          "entities": {
                            "type": "object",
                            "additionalProperties": true,
                            "description": "What the text links to; for a long post, of fullText.",
                            "properties": {
                              "urls": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Links in the text, expanded (url, expandedUrl, displayUrl). Media links are in media instead."
                              },
                              "hashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Hashtags, without the #."
                              },
                              "mentions": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Accounts mentioned: handle, id and name."
                              },
                              "cashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Cashtags, without the $."
                              }
                            }
                          },
                          "card": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The link preview: name (the card type, e.g. summary_large_image), url, title, description, domain and imageUrl. Null when there is none."
                          },
                          "poll": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "For a poll: choices[] (label and votes so far as count), endsAt (ISO 8601), isFinal (true once closed) and durationMinutes. Null otherwise."
                          },
                          "editControl": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Edit history: editTweetIds (every version, oldest first; one id when never edited), isEditEligible, editableUntil (ISO 8601) and editsRemaining."
                          },
                          "possiblySensitive": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "X’s sensitive-media flag on the post."
                          },
                          "communityNote": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The community note shown on the post: id, title (e.g. \"Readers added context\", it changes as the note is rated), text, language, url and urls[]. Null when there is none."
                          },
                          "isPromoted": {
                            "type": "boolean",
                            "description": "True for an ad X placed in the list. It is kept in place, only labelled."
                          }
                        }
                      },
                      "description": "The replies, each with the same fields as a tweet."
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "listingType": "twitter-tweet-replies",
                      "tweetId": "2113776971603689874",
                      "itemCount": 1,
                      "nextCursor": "PAAAAPAtPDwhGVxL",
                      "replies": [
                        {
                          "id": "2113779102938471820",
                          "conversationId": "2113776971603689874",
                          "createdAt": "Fri Oct 23 23:46:24 +0000 2026",
                          "text": "@NASA Go Artemis! 🚀",
                          "lang": "en",
                          "source": null,
                          "inReplyToStatusId": "2113776971603689874",
                          "inReplyToUserId": "11348282",
                          "url": "https://x.com/spacefan/status/2113779102938471820",
                          "author": {
                            "id": "1520000000000000000",
                            "name": "Space Fan",
                            "handle": "spacefan",
                            "description": null,
                            "followersCount": 312,
                            "followingCount": 280,
                            "verified": false
                          },
                          "counts": {
                            "replies": 0,
                            "reposts": 0,
                            "likes": 12,
                            "quotes": 0,
                            "bookmarks": 0,
                            "views": 840
                          },
                          "media": []
                        }
                      ],
                      "scrapedAt": "2026-10-25T19:12:40.000Z",
                      "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": []
          }
        ]
      }
    },
    "/tweet-quotes": {
      "post": {
        "operationId": "tweet-quotes",
        "tags": [
          "Content"
        ],
        "summary": "Get the posts that quote a post",
        "description": "Get the posts that quote a given post on X, newest first by default (product Top for the most engaged). Each result carries the post it quotes in quotedTweet. Every search filter narrows the results; there is no query, the route sets the search. A post that does not exist, or that nobody quoted, answers 200 with itemCount 0 and a note.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tweetId": {
                    "type": "string",
                    "description": "Numeric id of the quoted post (1-19 digits)."
                  },
                  "product": {
                    "type": "string",
                    "description": "Latest (newest first) or Top (most engaged first).",
                    "example": "Latest"
                  },
                  "count": {
                    "type": "integer",
                    "description": "Results per page, at most 20. Use nextCursor or maxItems for more.",
                    "example": "25"
                  },
                  "cursor": {
                    "type": "string",
                    "description": "A previous response’s nextCursor, with the same other parameters, for the next page."
                  },
                  "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."
                  },
                  "from": {
                    "type": "string",
                    "description": "Only posts by this handle (with or without @)."
                  },
                  "to": {
                    "type": "string",
                    "description": "Only replies to this handle."
                  },
                  "mentioning": {
                    "type": "string",
                    "description": "Only posts mentioning this handle."
                  },
                  "since": {
                    "type": "string",
                    "description": "Only posts from this moment on: a date YYYY-MM-DD (00:00 UTC that day) or an ISO 8601 time with a zone, e.g. 2026-10-01T12:00:00Z."
                  },
                  "until": {
                    "type": "string",
                    "description": "Only posts before this moment (exclusive), in the same forms as since. Must be later than since."
                  },
                  "sinceTime": {
                    "type": "integer",
                    "description": "Only posts from this Unix time (seconds) on."
                  },
                  "untilTime": {
                    "type": "integer",
                    "description": "Only posts before this Unix time (seconds). Must be later than sinceTime."
                  },
                  "lang": {
                    "type": "string",
                    "description": "Only posts in this language: a two-letter ISO 639-1 code, e.g. en."
                  },
                  "minLikes": {
                    "type": "integer",
                    "description": "Only posts with at least this many likes. Counts can lag slightly behind the live post, so a result may show a little under the minimum."
                  },
                  "minRetweets": {
                    "type": "integer",
                    "description": "Only posts with at least this many reposts. Counts can lag slightly behind the live post, so a result may show a little under the minimum."
                  },
                  "minReplies": {
                    "type": "integer",
                    "description": "Only posts with at least this many replies. Counts can lag slightly behind the live post, so a result may show a little under the minimum."
                  },
                  "hasMedia": {
                    "type": "boolean",
                    "description": "true: only posts with media; false: only posts without."
                  },
                  "hasImages": {
                    "type": "boolean",
                    "description": "true: only posts with images; false: only posts without."
                  },
                  "hasVideos": {
                    "type": "boolean",
                    "description": "true: only posts with video; false: only posts without."
                  },
                  "hasLinks": {
                    "type": "boolean",
                    "description": "true: only posts with links; false: only posts without."
                  },
                  "verifiedOnly": {
                    "type": "boolean",
                    "description": "true: only posts by verified accounts."
                  },
                  "excludeReplies": {
                    "type": "boolean",
                    "description": "true: leave replies out."
                  },
                  "excludeRetweets": {
                    "type": "boolean",
                    "description": "true: leave reposts out."
                  },
                  "sinceId": {
                    "type": "string",
                    "description": "Only posts newer than this post id."
                  },
                  "maxId": {
                    "type": "string",
                    "description": "Only posts up to and including this post id."
                  },
                  "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": [
                  "tweetId"
                ]
              },
              "examples": {
                "default": {
                  "value": {
                    "tweetId": "2113776971603689874",
                    "product": "Latest"
                  }
                }
              }
            }
          }
        },
        "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": "Always twitter-tweet-quotes."
                    },
                    "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."
                    },
                    "quotedTweetId": {
                      "type": "string",
                      "description": "The post whose quotes these are."
                    },
                    "product": {
                      "type": "string",
                      "description": "Latest or Top."
                    },
                    "query": {
                      "type": "string",
                      "description": "The search we ran for the quotes, without your filters."
                    },
                    "effectiveQuery": {
                      "type": "string",
                      "description": "The search we ran, with your filters. Always present."
                    },
                    "tweets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true,
                        "properties": {
                          "id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Tweet id, as a string (it does not fit a JavaScript number)."
                          },
                          "conversationId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the thread’s first tweet."
                          },
                          "createdAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "When it was posted, as X writes it: \"Fri Oct 23 23:37:56 +0000 2026\" (UTC)."
                          },
                          "text": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Full tweet text, complete for a long post too (2026-11-13: for a post over 280 characters it used to stop at about 280). Links appear as t.co short links."
                          },
                          "lang": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Language X detected for the text (BCP 47, e.g. en), or null."
                          },
                          "source": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The posting client, when X says; usually null."
                          },
                          "inReplyToStatusId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the id of the tweet it answers; null otherwise."
                          },
                          "inReplyToUserId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the account id of the author it answers; null otherwise."
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Link to the tweet: https://x.com/<handle>/status/<id>, or https://x.com/i/status/<id> when the author is missing (x.com redirects it). Null only when the tweet has no id."
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Who posted it.",
                            "properties": {
                              "id": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The author’s numeric account id, as a string."
                              },
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Display name."
                              },
                              "handle": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Handle without the @."
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Bio text, or null when the account has none."
                              },
                              "followersCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Followers of the author; null only when X leaves it out."
                              },
                              "followingCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Accounts the author follows; null only when X leaves it out."
                              },
                              "verified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Whether the account carries a verification checkmark."
                              },
                              "avatarUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Profile image URL (48x48)."
                              },
                              "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."
                              }
                            }
                          },
                          "counts": {
                            "type": "object",
                            "properties": {
                              "replies": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Replies."
                              },
                              "reposts": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Reposts (retweets)."
                              },
                              "likes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Likes."
                              },
                              "quotes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Quote posts."
                              },
                              "bookmarks": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Bookmarks."
                              },
                              "views": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Views, or null when X shows none."
                              }
                            },
                            "additionalProperties": true
                          },
                          "media": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Image URL; for a video, its preview frame."
                                },
                                "expandedUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Link to the media on x.com."
                                }
                              }
                            },
                            "description": "Attached photos, videos and GIFs; empty when there are none."
                          },
                          "fullText": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The complete text, with &amp;, &lt; and &gt; unescaped. For a long post it equals text, which carries the whole post."
                          },
                          "isLongPost": {
                            "type": "boolean",
                            "description": "True for a post in X’s long-post format. text carries all of it; fullText is the same text with &amp;, &lt; and &gt; unescaped."
                          },
                          "isQuote": {
                            "type": "boolean",
                            "description": "True when the post quotes another post."
                          },
                          "quotedTweetId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the quoted post, also when that post is no longer available."
                          },
                          "quotedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The quoted post, with the same fields as this one, one level deep (its own quotedTweet and retweetedTweet are null). Null when nothing is quoted or the quoted post is unavailable."
                          },
                          "isRetweet": {
                            "type": "boolean",
                            "description": "True when the post is a repost."
                          },
                          "retweetedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The reposted post, one level deep like quotedTweet; null otherwise."
                          },
                          "mediaDetails": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The media id."
                                },
                                "altText": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The alt text the author wrote; null when none."
                                },
                                "width": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Width of the original upload, in pixels."
                                },
                                "height": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Height of the original upload, in pixels."
                                },
                                "video": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "additionalProperties": true,
                                  "description": "For a video or GIF: durationMs (null for a GIF), aspectRatio as [width, height], and variants[] of MP4 files with url, contentType and bitrate. Null for a photo."
                                }
                              }
                            },
                            "description": "One entry per media item, in the same order: id, alt text, size and video files."
                          },
                          "entities": {
                            "type": "object",
                            "additionalProperties": true,
                            "description": "What the text links to; for a long post, of fullText.",
                            "properties": {
                              "urls": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Links in the text, expanded (url, expandedUrl, displayUrl). Media links are in media instead."
                              },
                              "hashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Hashtags, without the #."
                              },
                              "mentions": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Accounts mentioned: handle, id and name."
                              },
                              "cashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Cashtags, without the $."
                              }
                            }
                          },
                          "card": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The link preview: name (the card type, e.g. summary_large_image), url, title, description, domain and imageUrl. Null when there is none."
                          },
                          "poll": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "For a poll: choices[] (label and votes so far as count), endsAt (ISO 8601), isFinal (true once closed) and durationMinutes. Null otherwise."
                          },
                          "editControl": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Edit history: editTweetIds (every version, oldest first; one id when never edited), isEditEligible, editableUntil (ISO 8601) and editsRemaining."
                          },
                          "possiblySensitive": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "X’s sensitive-media flag on the post."
                          },
                          "communityNote": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The community note shown on the post: id, title (e.g. \"Readers added context\", it changes as the note is rated), text, language, url and urls[]. Null when there is none."
                          },
                          "isPromoted": {
                            "type": "boolean",
                            "description": "True for an ad X placed in the list. It is kept in place, only labelled."
                          }
                        }
                      },
                      "description": "The quoting posts; each has isQuote true and the quoted post in quotedTweet."
                    },
                    "profiles": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      },
                      "description": "Always empty on this route."
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "listingType": "twitter-tweet-quotes",
                      "quotedTweetId": "2113776971603689874",
                      "product": "Latest",
                      "query": "quoted_tweet_id:2113776971603689874",
                      "effectiveQuery": "quoted_tweet_id:2113776971603689874",
                      "itemCount": 17,
                      "nextCursor": "DAADDAABCgABHWCqp7yXYQAKAAIdVaZLPpewEQAIAAIAAAACCAADAAAAAAgABAAAAAAKAAUdaLBTBAAnEAoABh1osFMD_9jwCwAHAAAA0EVtUEM2d0FBQWZRL2dHSk4wdkdwL0FBQUFCRWRWbUs3Q0ZjZ2FSMVd3WnR1bWtFNkhWYkpsRlFhRWFVZFlLcW52SmRoQUIxVnpjS2VHNUhKSFZZeE1vMGFVVDRkVmFaTFBwZXdFUjFYUUcxWVd1R0JIVldudHZsV2NRZ2RWZkExTWR2QVRoMVdOZ0Y1bTVBK0hWYmJaME1iY1djZFZ0T09lWmJRaXgxV2ZPL3oya0VzSFZZZlU1OWFRQWNkVmFyV1Y5ZlJpaDFWN0g3QVdxR04AAA",
                      "tweets": [
                        {
                          "id": "2113790412873064448",
                          "createdAt": "Sat Oct 24 00:39:41 +0000 2026",
                          "text": "Watching this crew train is the best thing on my feed this week. Go Artemis II!",
                          "url": "https://x.com/spacefan/status/2113790412873064448",
                          "author": {
                            "id": "1520000000000000000",
                            "name": "Space Fan",
                            "handle": "spacefan"
                          },
                          "counts": {
                            "replies": 2,
                            "reposts": 1,
                            "likes": 14,
                            "quotes": 0,
                            "bookmarks": 0,
                            "views": 812
                          },
                          "isQuote": true,
                          "quotedTweetId": "2113776971603689874"
                        }
                      ],
                      "profiles": [],
                      "scrapedAt": "2026-11-07T18:38:47.483Z",
                      "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": []
          }
        ]
      }
    },
    "/tweet-thread": {
      "post": {
        "operationId": "tweet-thread",
        "tags": [
          "Content"
        ],
        "summary": "Get a whole thread from any post in it",
        "description": "Get a thread an author posted as a chain of their own replies: every post of it in order from the first, whichever post of the thread you pass. isComplete says whether the whole thread came back; a long one continues with nextCursor, or in one call with maxItems. A post that is not part of a thread returns a thread of just itself. A post that does not exist is a 404 with code tweet_not_found.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tweetId": {
                    "type": "string",
                    "description": "Numeric id of any post in the thread (1-19 digits). Status URLs are rejected."
                  },
                  "screenName": {
                    "type": "string",
                    "description": "Optional handle of the post's author; only used to build post URLs."
                  },
                  "cursor": {
                    "type": "string",
                    "description": "A previous response’s nextCursor, to continue a thread that did not fit in one response."
                  },
                  "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": [
                  "tweetId"
                ]
              },
              "examples": {
                "default": {
                  "value": {
                    "tweetId": "1641976925064245249"
                  }
                }
              }
            }
          }
        },
        "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": "Always twitter-tweet-thread."
                    },
                    "tweetId": {
                      "type": "string",
                      "description": "The post id you asked for."
                    },
                    "tweet": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true,
                      "description": "The post you asked for, with the same fields as each thread post; null on a later page that does not carry it.",
                      "properties": {
                        "id": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Tweet id, as a string (it does not fit a JavaScript number)."
                        },
                        "conversationId": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Id of the thread’s first tweet."
                        },
                        "createdAt": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "When it was posted, as X writes it: \"Fri Oct 23 23:37:56 +0000 2026\" (UTC)."
                        },
                        "text": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Full tweet text, complete for a long post too (2026-11-13: for a post over 280 characters it used to stop at about 280). Links appear as t.co short links."
                        },
                        "lang": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Language X detected for the text (BCP 47, e.g. en), or null."
                        },
                        "source": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The posting client, when X says; usually null."
                        },
                        "inReplyToStatusId": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "For a reply, the id of the tweet it answers; null otherwise."
                        },
                        "inReplyToUserId": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "For a reply, the account id of the author it answers; null otherwise."
                        },
                        "url": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Link to the tweet: https://x.com/<handle>/status/<id>, or https://x.com/i/status/<id> when the author is missing (x.com redirects it). Null only when the tweet has no id."
                        },
                        "author": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "Who posted it.",
                          "properties": {
                            "id": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The author’s numeric account id, as a string."
                            },
                            "name": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Display name."
                            },
                            "handle": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Handle without the @."
                            },
                            "description": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Bio text, or null when the account has none."
                            },
                            "followersCount": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Followers of the author; null only when X leaves it out."
                            },
                            "followingCount": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Accounts the author follows; null only when X leaves it out."
                            },
                            "verified": {
                              "type": [
                                "boolean",
                                "null"
                              ],
                              "description": "Whether the account carries a verification checkmark."
                            },
                            "avatarUrl": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Profile image URL (48x48)."
                            },
                            "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."
                            }
                          }
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "replies": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Replies."
                            },
                            "reposts": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Reposts (retweets)."
                            },
                            "likes": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Likes."
                            },
                            "quotes": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Quote posts."
                            },
                            "bookmarks": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Bookmarks."
                            },
                            "views": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Views, or null when X shows none."
                            }
                          },
                          "additionalProperties": true
                        },
                        "media": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "properties": {
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "photo, video or animated_gif."
                              },
                              "mediaUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Image URL; for a video, its preview frame."
                              },
                              "expandedUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Link to the media on x.com."
                              }
                            }
                          },
                          "description": "Attached photos, videos and GIFs; empty when there are none."
                        },
                        "fullText": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The complete text, with &amp;, &lt; and &gt; unescaped. For a long post it equals text, which carries the whole post."
                        },
                        "isLongPost": {
                          "type": "boolean",
                          "description": "True for a post in X’s long-post format. text carries all of it; fullText is the same text with &amp;, &lt; and &gt; unescaped."
                        },
                        "isQuote": {
                          "type": "boolean",
                          "description": "True when the post quotes another post."
                        },
                        "quotedTweetId": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Id of the quoted post, also when that post is no longer available."
                        },
                        "quotedTweet": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The quoted post, with the same fields as this one, one level deep (its own quotedTweet and retweetedTweet are null). Null when nothing is quoted or the quoted post is unavailable."
                        },
                        "isRetweet": {
                          "type": "boolean",
                          "description": "True when the post is a repost."
                        },
                        "retweetedTweet": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The reposted post, one level deep like quotedTweet; null otherwise."
                        },
                        "mediaDetails": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "properties": {
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "photo, video or animated_gif."
                              },
                              "mediaId": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The media id."
                              },
                              "altText": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The alt text the author wrote; null when none."
                              },
                              "width": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Width of the original upload, in pixels."
                              },
                              "height": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Height of the original upload, in pixels."
                              },
                              "video": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "additionalProperties": true,
                                "description": "For a video or GIF: durationMs (null for a GIF), aspectRatio as [width, height], and variants[] of MP4 files with url, contentType and bitrate. Null for a photo."
                              }
                            }
                          },
                          "description": "One entry per media item, in the same order: id, alt text, size and video files."
                        },
                        "entities": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "What the text links to; for a long post, of fullText.",
                          "properties": {
                            "urls": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "additionalProperties": true
                              },
                              "description": "Links in the text, expanded (url, expandedUrl, displayUrl). Media links are in media instead."
                            },
                            "hashtags": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "Hashtags, without the #."
                            },
                            "mentions": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "additionalProperties": true
                              },
                              "description": "Accounts mentioned: handle, id and name."
                            },
                            "cashtags": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "Cashtags, without the $."
                            }
                          }
                        },
                        "card": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The link preview: name (the card type, e.g. summary_large_image), url, title, description, domain and imageUrl. Null when there is none."
                        },
                        "poll": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "For a poll: choices[] (label and votes so far as count), endsAt (ISO 8601), isFinal (true once closed) and durationMinutes. Null otherwise."
                        },
                        "editControl": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "Edit history: editTweetIds (every version, oldest first; one id when never edited), isEditEligible, editableUntil (ISO 8601) and editsRemaining."
                        },
                        "possiblySensitive": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "X’s sensitive-media flag on the post."
                        },
                        "communityNote": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "The community note shown on the post: id, title (e.g. \"Readers added context\", it changes as the note is rated), text, language, url and urls[]. Null when there is none."
                        },
                        "isPromoted": {
                          "type": "boolean",
                          "description": "True for an ad X placed in the list. It is kept in place, only labelled."
                        }
                      }
                    },
                    "thread": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true,
                        "properties": {
                          "id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Tweet id, as a string (it does not fit a JavaScript number)."
                          },
                          "conversationId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the thread’s first tweet."
                          },
                          "createdAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "When it was posted, as X writes it: \"Fri Oct 23 23:37:56 +0000 2026\" (UTC)."
                          },
                          "text": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Full tweet text, complete for a long post too (2026-11-13: for a post over 280 characters it used to stop at about 280). Links appear as t.co short links."
                          },
                          "lang": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Language X detected for the text (BCP 47, e.g. en), or null."
                          },
                          "source": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The posting client, when X says; usually null."
                          },
                          "inReplyToStatusId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the id of the tweet it answers; null otherwise."
                          },
                          "inReplyToUserId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the account id of the author it answers; null otherwise."
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Link to the tweet: https://x.com/<handle>/status/<id>, or https://x.com/i/status/<id> when the author is missing (x.com redirects it). Null only when the tweet has no id."
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Who posted it.",
                            "properties": {
                              "id": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The author’s numeric account id, as a string."
                              },
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Display name."
                              },
                              "handle": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Handle without the @."
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Bio text, or null when the account has none."
                              },
                              "followersCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Followers of the author; null only when X leaves it out."
                              },
                              "followingCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Accounts the author follows; null only when X leaves it out."
                              },
                              "verified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Whether the account carries a verification checkmark."
                              },
                              "avatarUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Profile image URL (48x48)."
                              },
                              "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."
                              }
                            }
                          },
                          "counts": {
                            "type": "object",
                            "properties": {
                              "replies": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Replies."
                              },
                              "reposts": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Reposts (retweets)."
                              },
                              "likes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Likes."
                              },
                              "quotes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Quote posts."
                              },
                              "bookmarks": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Bookmarks."
                              },
                              "views": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Views, or null when X shows none."
                              }
                            },
                            "additionalProperties": true
                          },
                          "media": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Image URL; for a video, its preview frame."
                                },
                                "expandedUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Link to the media on x.com."
                                }
                              }
                            },
                            "description": "Attached photos, videos and GIFs; empty when there are none."
                          },
                          "fullText": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The complete text, with &amp;, &lt; and &gt; unescaped. For a long post it equals text, which carries the whole post."
                          },
                          "isLongPost": {
                            "type": "boolean",
                            "description": "True for a post in X’s long-post format. text carries all of it; fullText is the same text with &amp;, &lt; and &gt; unescaped."
                          },
                          "isQuote": {
                            "type": "boolean",
                            "description": "True when the post quotes another post."
                          },
                          "quotedTweetId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the quoted post, also when that post is no longer available."
                          },
                          "quotedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The quoted post, with the same fields as this one, one level deep (its own quotedTweet and retweetedTweet are null). Null when nothing is quoted or the quoted post is unavailable."
                          },
                          "isRetweet": {
                            "type": "boolean",
                            "description": "True when the post is a repost."
                          },
                          "retweetedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The reposted post, one level deep like quotedTweet; null otherwise."
                          },
                          "mediaDetails": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The media id."
                                },
                                "altText": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The alt text the author wrote; null when none."
                                },
                                "width": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Width of the original upload, in pixels."
                                },
                                "height": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Height of the original upload, in pixels."
                                },
                                "video": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "additionalProperties": true,
                                  "description": "For a video or GIF: durationMs (null for a GIF), aspectRatio as [width, height], and variants[] of MP4 files with url, contentType and bitrate. Null for a photo."
                                }
                              }
                            },
                            "description": "One entry per media item, in the same order: id, alt text, size and video files."
                          },
                          "entities": {
                            "type": "object",
                            "additionalProperties": true,
                            "description": "What the text links to; for a long post, of fullText.",
                            "properties": {
                              "urls": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Links in the text, expanded (url, expandedUrl, displayUrl). Media links are in media instead."
                              },
                              "hashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Hashtags, without the #."
                              },
                              "mentions": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Accounts mentioned: handle, id and name."
                              },
                              "cashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Cashtags, without the $."
                              }
                            }
                          },
                          "card": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The link preview: name (the card type, e.g. summary_large_image), url, title, description, domain and imageUrl. Null when there is none."
                          },
                          "poll": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "For a poll: choices[] (label and votes so far as count), endsAt (ISO 8601), isFinal (true once closed) and durationMinutes. Null otherwise."
                          },
                          "editControl": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Edit history: editTweetIds (every version, oldest first; one id when never edited), isEditEligible, editableUntil (ISO 8601) and editsRemaining."
                          },
                          "possiblySensitive": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "X’s sensitive-media flag on the post."
                          },
                          "communityNote": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The community note shown on the post: id, title (e.g. \"Readers added context\", it changes as the note is rated), text, language, url and urls[]. Null when there is none."
                          },
                          "isPromoted": {
                            "type": "boolean",
                            "description": "True for an ad X placed in the list. It is kept in place, only labelled."
                          }
                        }
                      },
                      "description": "The author’s posts in the thread, oldest first; the post you asked for is among them on the first page."
                    },
                    "itemCount": {
                      "type": "integer",
                      "description": "Number of posts in thread."
                    },
                    "isComplete": {
                      "type": "boolean",
                      "description": "True when the thread starts with the first post returned and nothing more follows: you have all of it."
                    },
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Pass as cursor to continue a long thread; null when there is no more."
                    },
                    "hasMore": {
                      "type": "boolean",
                      "description": "Whether more posts of the thread follow: continue with cursor set to nextCursor while it is true."
                    },
                    "pagesFetched": {
                      "type": "integer",
                      "description": "The pages of results in this response, one credit each (1 for a thread that fits in one page)."
                    },
                    "note": {
                      "type": "string",
                      "description": "With maxItems, why the call stopped before maxItems."
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "listingType": "twitter-tweet-thread",
                      "tweetId": "1641976925064245249",
                      "tweet": {
                        "id": "1641976925064245249",
                        "conversationId": "1641976869460275201",
                        "createdAt": "Sat Apr 01 01:33:00 +0000 2023",
                        "text": "6. Misinformation is highly down-ranked\n\nAnything that is categorized as misinformation gets the rug pulled out from und",
                        "url": "https://x.com/aakashgupta/status/1641976925064245249",
                        "author": {
                          "id": "101805159",
                          "name": "Aakash Gupta",
                          "handle": "aakashgupta"
                        }
                      },
                      "itemCount": 22,
                      "thread": [
                        {
                          "id": "1641976869460275201",
                          "conversationId": "1641976869460275201",
                          "createdAt": "Sat Apr 01 01:32:46 +0000 2023",
                          "text": "Twitter revealed its algorithm to the world. \n\nBut what does it mean for you?\n\nI spent the evening analyzing it.\n\nHere’s",
                          "url": "https://x.com/aakashgupta/status/1641976869460275201",
                          "author": {
                            "id": "101805159",
                            "name": "Aakash Gupta",
                            "handle": "aakashgupta"
                          }
                        }
                      ],
                      "isComplete": true,
                      "nextCursor": null,
                      "hasMore": false,
                      "pagesFetched": 1,
                      "scrapedAt": "2026-11-07T14:13:43.108Z",
                      "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": []
          }
        ]
      }
    },
    "/video-transcript": {
      "post": {
        "operationId": "video-transcript",
        "tags": [
          "Content"
        ],
        "summary": "Get a post’s video transcript",
        "description": "The captions X publishes for the video attached to a post, as one block of text plus time-coded segments. Read the coverage figure before you build on this: of 770 videos measured, 17.5% carried captions — but the average on its own misleads in both directions, so here is the spread. 41% of higher-engagement video has them, 27.5% of clips between one and three minutes, and 2.6% of clips under ten seconds. Some large accounts return nothing at all while others are near-complete, so sample the accounts you care about rather than budgeting off the average. It is not a generation delay — the same misses were re-probed 25 and 90 minutes later and were still empty — and it is not English-only: the languages X returned across the captioned set were en, pt, de, es, fr, en-US, tr, ar, he, ja, te, el, ru and it-IT. A video with no captions is a normal 200, not an error — a real one, for post 2094884934510956691, comes back as `\"transcript\": {\"available\": false, \"originalLanguage\": null, \"durationSeconds\": 191.8, \"tracks\": []}` with `pagesFetched: 0`. The duration is still filled in, so a miss still tells you the clip length. Do not retry it: the captions are not coming. When a transcript does exist, `tracks` holds exactly one entry — X does not translate, and none of the 770 videos declared more than one track. `transcript.originalLanguage` is inferred rather than declared, because X marks no track as the original: an auto-generated track anchors it, then the track X marks DEFAULT, then a sole track; with several uploader-supplied tracks and no DEFAULT it is null rather than a guess. Do not substitute the post’s own `lang` field for it — that describes the written text of the post and disagreed with the caption language in 28 of 92 measured cases. Billing: 1 credit.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tweetId": {
                    "type": "string",
                    "description": "Numeric tweet id. Status URLs and non-numeric ids are rejected with a 400."
                  },
                  "screenName": {
                    "type": "string",
                    "description": "Optional handle of the post’s author. Used only to build the post URL in the response."
                  },
                  "language": {
                    "type": "string",
                    "description": "A BCP-47 tag to filter tracks by, e.g. en, pt or en-US. It filters rather than picks: en returns every en-* track that exists, and an exact tag wins over the broader subtag sweep. Matching is case-insensitive and falls back to the primary subtag, so de also matches a de-DE track. No translation is performed."
                  },
                  "format": {
                    "type": "string",
                    "description": "json or markdown, in any case; any other value is a 400. Over MCP, markdown returns the result rendered as text; the REST API accepts it and returns JSON.",
                    "example": "json"
                  },
                  "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": [
                  "tweetId"
                ]
              },
              "examples": {
                "default": {
                  "value": {
                    "tweetId": "2070270274872738258"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "pagesFetched": {
                      "type": "number",
                      "description": "Billing unit. 1 when a transcript came back, 0 when the video has none — the one credit every request claims is charged either way."
                    },
                    "video": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "The post id the video belongs to."
                        },
                        "url": {
                          "type": "string",
                          "description": "Canonical link to the post."
                        },
                        "durationMs": {
                          "type": "number",
                          "description": "Length of the video in milliseconds, or null."
                        }
                      },
                      "additionalProperties": true
                    },
                    "transcript": {
                      "type": "object",
                      "properties": {
                        "available": {
                          "type": "boolean",
                          "description": "Whether a transcript came back. False is a normal 200, not a failure."
                        },
                        "originalLanguage": {
                          "type": "string",
                          "description": "BCP-47 tag for the language spoken in the video, or null. Inferred, not declared — see the description. Conventionally cased (language lowercase, script Titlecase, region UPPERCASE), so EN from X is normalized to en while en-US and it-IT are left alone. Compare it case-insensitively anyway."
                        },
                        "durationSeconds": {
                          "type": "number",
                          "description": "Length of the video in seconds. Filled in even when available is false."
                        },
                        "tracks": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "properties": {
                              "language": {
                                "type": "string",
                                "description": "BCP-47 tag for this track, or \"und\" when X declares a track without naming its language. X is inconsistent about case — 4 of the 135 captioned videos measured came back as EN or FR — so this is normalized before you see it, and you should still compare case-insensitively."
                              },
                              "isOriginalLanguage": {
                                "type": "boolean",
                                "description": "Whether this track is in the language actually spoken in the video."
                              },
                              "isAutoGenerated": {
                                "type": "boolean",
                                "description": "True when X generated the captions rather than the account supplying them."
                              },
                              "source": {
                                "type": "string",
                                "description": "How the text was obtained. Always \"captions\" on X."
                              },
                              "text": {
                                "type": "string",
                                "description": "The whole track, one caption line per newline."
                              },
                              "segments": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Time-coded lines, each with start, end and text, in seconds. null when a track carries no timings; X always has them, and its per-word timing data makes them unusually precise."
                              }
                            }
                          },
                          "description": "One entry per caption track. Exactly one when a transcript exists, and empty otherwise — X publishes no translations, so this never held more than one entry across 770 measured videos."
                        }
                      },
                      "additionalProperties": true
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "scrapedAt": "2026-09-16T19:13:57.396Z",
                      "rawIncluded": false,
                      "resultType": "video-transcript",
                      "pagesFetched": 1,
                      "video": {
                        "id": "2070270274872738258",
                        "url": "https://x.com/i/status/2070270274872738258",
                        "durationMs": 44372
                      },
                      "transcript": {
                        "available": true,
                        "originalLanguage": "en",
                        "durationSeconds": 44.4,
                        "tracks": [
                          {
                            "language": "en",
                            "isOriginalLanguage": true,
                            "isAutoGenerated": true,
                            "source": "captions",
                            "text": "In 1776, our founding fathers met in Philadelphia and changed the world forever.\nThe thing called the Declaration of Independence.\nTonight as we stand on the edge of our 250th year of independence\n…",
                            "segments": [
                              {
                                "start": 0,
                                "end": 6.419,
                                "text": "In 1776, our founding fathers met in Philadelphia and changed the world forever."
                              },
                              {
                                "start": 6.7,
                                "end": 10.4,
                                "text": "The thing called the Declaration of Independence."
                              },
                              {
                                "start": 10.9,
                                "end": 15.22,
                                "text": "Tonight as we stand on the edge of our 250th year of independence"
                              }
                            ]
                          }
                        ]
                      },
                      "raw": null
                    }
                  }
                }
              }
            }
          },
          "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": []
          }
        ]
      }
    },
    "/user-profile-details": {
      "post": {
        "operationId": "user-profile-details",
        "tags": [
          "Profile"
        ],
        "summary": "Fetch a user profile by handle",
        "description": "Retrieve a Twitter user profile and top-level account metadata by handle. Includes bio, follower/following counts, join date, and verification status. 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 @."
                  },
                  "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"
                  }
                }
              }
            }
          }
        },
        "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\"."
                    },
                    "entityType": {
                      "type": "string",
                      "description": "Always twitter-user-profile-details."
                    },
                    "cached": {
                      "type": "boolean",
                      "description": "Present (true) only when the answer is a recent copy rather than a fresh read; scrapedAt then says when it was read. Only for a public profile, and at most 10 minutes old."
                    },
                    "profile": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true,
                      "description": "The account; null when it could not be found.",
                      "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."
                            }
                          }
                        }
                      }
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "entityType": "twitter-user-profile-details",
                      "profile": {
                        "id": "11348282",
                        "name": "NASA",
                        "handle": "NASA",
                        "description": "Making the seemingly impossible, possible. ✨",
                        "location": "Pale Blue Dot",
                        "followersCount": 92312272,
                        "followingCount": 115,
                        "tweetsCount": 74455,
                        "mediaCount": 28207,
                        "verified": true,
                        "avatarUrl": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg",
                        "bannerUrl": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
                        "createdAt": "Wed Dec 19 20:20:32 +0000 2007",
                        "favoritesCount": 17049,
                        "listedCount": null,
                        "pinnedTweetIds": [],
                        "profileLabel": null,
                        "verification": {
                          "blue": true,
                          "verified": false,
                          "identityVerified": false,
                          "reason": "This account is verified because it is a government or multilateral organization account."
                        }
                      },
                      "scrapedAt": "2026-10-25T19:14:00.000Z",
                      "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": []
          }
        ]
      }
    },
    "/about-profile": {
      "post": {
        "operationId": "about-profile",
        "tags": [
          "Profile"
        ],
        "summary": "Fetch “about this profile” metadata",
        "description": "Retrieve extended profile context for a Twitter account including professional category, and any linked entities. 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 @."
                  },
                  "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"
                  }
                }
              }
            }
          }
        },
        "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\"."
                    },
                    "entityType": {
                      "type": "string",
                      "description": "Always twitter-about-profile."
                    },
                    "profile": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true,
                      "description": "The account in full, 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."
                            }
                          }
                        }
                      }
                    },
                    "aboutProfile": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "additionalProperties": true,
                      "description": "X’s “About this account” panel; null when X shows none.",
                      "properties": {
                        "accountBasedIn": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The country X says the account is based in."
                        },
                        "locationAccurate": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "Whether X considers that location accurate."
                        },
                        "createdCountryAccurate": {
                          "type": [
                            "boolean",
                            "null"
                          ],
                          "description": "Whether X considers the country the account was created in accurate."
                        },
                        "source": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "How the account connected to X, as the panel says (e.g. an app store)."
                        },
                        "affiliateUsername": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The organisation the account is affiliated with, when it has one."
                        },
                        "usernameChanges": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true,
                          "description": "How often the handle has changed.",
                          "properties": {
                            "count": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "description": "Number of handle changes."
                            },
                            "lastChangedAtMsec": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "When the handle last changed, in milliseconds since the epoch (as a string); null when it never has."
                            }
                          }
                        },
                        "learnMoreUrl": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "X’s page explaining the panel."
                        }
                      }
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "entityType": "twitter-about-profile",
                      "profile": {
                        "id": "11348282",
                        "name": "NASA",
                        "handle": "NASA",
                        "followersCount": 92312272,
                        "verified": true
                      },
                      "aboutProfile": {
                        "accountBasedIn": "United States",
                        "locationAccurate": true,
                        "createdCountryAccurate": true,
                        "source": null,
                        "affiliateUsername": null,
                        "usernameChanges": {
                          "count": 0,
                          "lastChangedAtMsec": null
                        },
                        "learnMoreUrl": "https://help.x.com/managing-your-account/about-twitter-verified-accounts"
                      },
                      "scrapedAt": "2026-10-25T19:15:00.000Z",
                      "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": []
          }
        ]
      }
    },
    "/user-tweets": {
      "post": {
        "operationId": "user-tweets",
        "tags": [
          "Content"
        ],
        "summary": "Fetch tweets for a user",
        "description": "Retrieve timeline tweets for a user handle with full engagement data and pagination support. If the account is protected, you get the profile with protected: true, an empty list (itemCount 0, nextCursor null) and a note that only approved followers can see its posts; the call is free. 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 20 to 30 tweets per page. Use nextCursor for more.",
                    "example": "25"
                  },
                  "cursor": {
                    "type": "string",
                    "description": "A previous response’s nextCursor, with the same other parameters, for the next page."
                  },
                  "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, 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."
                            }
                          }
                        }
                      }
                    },
                    "tweets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true,
                        "properties": {
                          "id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Tweet id, as a string (it does not fit a JavaScript number)."
                          },
                          "conversationId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the thread’s first tweet."
                          },
                          "createdAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "When it was posted, as X writes it: \"Fri Oct 23 23:37:56 +0000 2026\" (UTC)."
                          },
                          "text": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Full tweet text, complete for a long post too (2026-11-13: for a post over 280 characters it used to stop at about 280). Links appear as t.co short links."
                          },
                          "lang": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Language X detected for the text (BCP 47, e.g. en), or null."
                          },
                          "source": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The posting client, when X says; usually null."
                          },
                          "inReplyToStatusId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the id of the tweet it answers; null otherwise."
                          },
                          "inReplyToUserId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the account id of the author it answers; null otherwise."
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Link to the tweet: https://x.com/<handle>/status/<id>, or https://x.com/i/status/<id> when the author is missing (x.com redirects it). Null only when the tweet has no id."
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Who posted it.",
                            "properties": {
                              "id": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The author’s numeric account id, as a string."
                              },
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Display name."
                              },
                              "handle": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Handle without the @."
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Bio text, or null when the account has none."
                              },
                              "followersCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Followers of the author; null only when X leaves it out."
                              },
                              "followingCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Accounts the author follows; null only when X leaves it out."
                              },
                              "verified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Whether the account carries a verification checkmark."
                              },
                              "avatarUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Profile image URL (48x48)."
                              },
                              "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."
                              }
                            }
                          },
                          "counts": {
                            "type": "object",
                            "properties": {
                              "replies": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Replies."
                              },
                              "reposts": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Reposts (retweets)."
                              },
                              "likes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Likes."
                              },
                              "quotes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Quote posts."
                              },
                              "bookmarks": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Bookmarks."
                              },
                              "views": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Views, or null when X shows none."
                              }
                            },
                            "additionalProperties": true
                          },
                          "media": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Image URL; for a video, its preview frame."
                                },
                                "expandedUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Link to the media on x.com."
                                }
                              }
                            },
                            "description": "Attached photos, videos and GIFs; empty when there are none."
                          },
                          "fullText": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The complete text, with &amp;, &lt; and &gt; unescaped. For a long post it equals text, which carries the whole post."
                          },
                          "isLongPost": {
                            "type": "boolean",
                            "description": "True for a post in X’s long-post format. text carries all of it; fullText is the same text with &amp;, &lt; and &gt; unescaped."
                          },
                          "isQuote": {
                            "type": "boolean",
                            "description": "True when the post quotes another post."
                          },
                          "quotedTweetId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the quoted post, also when that post is no longer available."
                          },
                          "quotedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The quoted post, with the same fields as this one, one level deep (its own quotedTweet and retweetedTweet are null). Null when nothing is quoted or the quoted post is unavailable."
                          },
                          "isRetweet": {
                            "type": "boolean",
                            "description": "True when the post is a repost."
                          },
                          "retweetedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The reposted post, one level deep like quotedTweet; null otherwise."
                          },
                          "mediaDetails": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The media id."
                                },
                                "altText": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The alt text the author wrote; null when none."
                                },
                                "width": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Width of the original upload, in pixels."
                                },
                                "height": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Height of the original upload, in pixels."
                                },
                                "video": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "additionalProperties": true,
                                  "description": "For a video or GIF: durationMs (null for a GIF), aspectRatio as [width, height], and variants[] of MP4 files with url, contentType and bitrate. Null for a photo."
                                }
                              }
                            },
                            "description": "One entry per media item, in the same order: id, alt text, size and video files."
                          },
                          "entities": {
                            "type": "object",
                            "additionalProperties": true,
                            "description": "What the text links to; for a long post, of fullText.",
                            "properties": {
                              "urls": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Links in the text, expanded (url, expandedUrl, displayUrl). Media links are in media instead."
                              },
                              "hashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Hashtags, without the #."
                              },
                              "mentions": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Accounts mentioned: handle, id and name."
                              },
                              "cashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Cashtags, without the $."
                              }
                            }
                          },
                          "card": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The link preview: name (the card type, e.g. summary_large_image), url, title, description, domain and imageUrl. Null when there is none."
                          },
                          "poll": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "For a poll: choices[] (label and votes so far as count), endsAt (ISO 8601), isFinal (true once closed) and durationMinutes. Null otherwise."
                          },
                          "editControl": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Edit history: editTweetIds (every version, oldest first; one id when never edited), isEditEligible, editableUntil (ISO 8601) and editsRemaining."
                          },
                          "possiblySensitive": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "X’s sensitive-media flag on the post."
                          },
                          "communityNote": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The community note shown on the post: id, title (e.g. \"Readers added context\", it changes as the note is rated), text, language, url and urls[]. Null when there is none."
                          },
                          "isPromoted": {
                            "type": "boolean",
                            "description": "True for an ad X placed in the list. It is kept in place, only labelled."
                          }
                        }
                      },
                      "description": "The account’s posts, newest first, each with the same fields as a tweet."
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "listingType": "twitter-user-tweets",
                      "user": {
                        "id": "11348282",
                        "name": "NASA",
                        "handle": "NASA",
                        "followersCount": 92312272,
                        "verified": true
                      },
                      "itemCount": 1,
                      "nextCursor": "DAABCgABHVf6hGP__z8KAAIdV_ZnL5ag",
                      "tweets": [
                        {
                          "id": "2113776971603689874",
                          "conversationId": "2113776971603689874",
                          "createdAt": "Fri Oct 23 23:37:56 +0000 2026",
                          "text": "We are not slowing down. 🚀 Our Artemis II crew is training for their trip around the Moon.",
                          "lang": "en",
                          "source": null,
                          "inReplyToStatusId": null,
                          "inReplyToUserId": null,
                          "url": "https://x.com/NASA/status/2113776971603689874",
                          "author": {
                            "id": "11348282",
                            "name": "NASA",
                            "handle": "NASA",
                            "description": "Making the seemingly impossible, possible. ✨",
                            "followersCount": 92312272,
                            "followingCount": 115,
                            "verified": true
                          },
                          "counts": {
                            "replies": 339,
                            "reposts": 970,
                            "likes": 7439,
                            "quotes": 83,
                            "bookmarks": 341,
                            "views": 1273965
                          },
                          "media": [
                            {
                              "type": "video",
                              "mediaUrl": "https://pbs.twimg.com/media/HVWk812WIAAg_hz.jpg",
                              "expandedUrl": "https://x.com/NASA/status/2113776971603689874/video/1"
                            }
                          ]
                        }
                      ],
                      "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": []
          }
        ]
      }
    },
    "/user-replies": {
      "post": {
        "operationId": "user-replies",
        "tags": [
          "Content"
        ],
        "summary": "Fetch replies by a user",
        "description": "Retrieve recent replies authored by a user handle across different tweet threads. If the account is protected, you get the profile with protected: true, an empty list (itemCount 0, nextCursor null) and a note that only approved followers can see its posts; the call is free. 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 20 to 50 replies 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, 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."
                            }
                          }
                        }
                      }
                    },
                    "tweets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true,
                        "properties": {
                          "id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Tweet id, as a string (it does not fit a JavaScript number)."
                          },
                          "conversationId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the thread’s first tweet."
                          },
                          "createdAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "When it was posted, as X writes it: \"Fri Oct 23 23:37:56 +0000 2026\" (UTC)."
                          },
                          "text": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Full tweet text, complete for a long post too (2026-11-13: for a post over 280 characters it used to stop at about 280). Links appear as t.co short links."
                          },
                          "lang": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Language X detected for the text (BCP 47, e.g. en), or null."
                          },
                          "source": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The posting client, when X says; usually null."
                          },
                          "inReplyToStatusId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the id of the tweet it answers; null otherwise."
                          },
                          "inReplyToUserId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "For a reply, the account id of the author it answers; null otherwise."
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Link to the tweet: https://x.com/<handle>/status/<id>, or https://x.com/i/status/<id> when the author is missing (x.com redirects it). Null only when the tweet has no id."
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Who posted it.",
                            "properties": {
                              "id": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The author’s numeric account id, as a string."
                              },
                              "name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Display name."
                              },
                              "handle": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Handle without the @."
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Bio text, or null when the account has none."
                              },
                              "followersCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Followers of the author; null only when X leaves it out."
                              },
                              "followingCount": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Accounts the author follows; null only when X leaves it out."
                              },
                              "verified": {
                                "type": [
                                  "boolean",
                                  "null"
                                ],
                                "description": "Whether the account carries a verification checkmark."
                              },
                              "avatarUrl": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Profile image URL (48x48)."
                              },
                              "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."
                              }
                            }
                          },
                          "counts": {
                            "type": "object",
                            "properties": {
                              "replies": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Replies."
                              },
                              "reposts": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Reposts (retweets)."
                              },
                              "likes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Likes."
                              },
                              "quotes": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Quote posts."
                              },
                              "bookmarks": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Bookmarks."
                              },
                              "views": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Views, or null when X shows none."
                              }
                            },
                            "additionalProperties": true
                          },
                          "media": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Image URL; for a video, its preview frame."
                                },
                                "expandedUrl": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Link to the media on x.com."
                                }
                              }
                            },
                            "description": "Attached photos, videos and GIFs; empty when there are none."
                          },
                          "fullText": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The complete text, with &amp;, &lt; and &gt; unescaped. For a long post it equals text, which carries the whole post."
                          },
                          "isLongPost": {
                            "type": "boolean",
                            "description": "True for a post in X’s long-post format. text carries all of it; fullText is the same text with &amp;, &lt; and &gt; unescaped."
                          },
                          "isQuote": {
                            "type": "boolean",
                            "description": "True when the post quotes another post."
                          },
                          "quotedTweetId": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the quoted post, also when that post is no longer available."
                          },
                          "quotedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The quoted post, with the same fields as this one, one level deep (its own quotedTweet and retweetedTweet are null). Null when nothing is quoted or the quoted post is unavailable."
                          },
                          "isRetweet": {
                            "type": "boolean",
                            "description": "True when the post is a repost."
                          },
                          "retweetedTweet": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The reposted post, one level deep like quotedTweet; null otherwise."
                          },
                          "mediaDetails": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": true,
                              "properties": {
                                "type": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "photo, video or animated_gif."
                                },
                                "mediaId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The media id."
                                },
                                "altText": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The alt text the author wrote; null when none."
                                },
                                "width": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Width of the original upload, in pixels."
                                },
                                "height": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Height of the original upload, in pixels."
                                },
                                "video": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "additionalProperties": true,
                                  "description": "For a video or GIF: durationMs (null for a GIF), aspectRatio as [width, height], and variants[] of MP4 files with url, contentType and bitrate. Null for a photo."
                                }
                              }
                            },
                            "description": "One entry per media item, in the same order: id, alt text, size and video files."
                          },
                          "entities": {
                            "type": "object",
                            "additionalProperties": true,
                            "description": "What the text links to; for a long post, of fullText.",
                            "properties": {
                              "urls": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Links in the text, expanded (url, expandedUrl, displayUrl). Media links are in media instead."
                              },
                              "hashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Hashtags, without the #."
                              },
                              "mentions": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                "description": "Accounts mentioned: handle, id and name."
                              },
                              "cashtags": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Cashtags, without the $."
                              }
                            }
                          },
                          "card": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The link preview: name (the card type, e.g. summary_large_image), url, title, description, domain and imageUrl. Null when there is none."
                          },
                          "poll": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "For a poll: choices[] (label and votes so far as count), endsAt (ISO 8601), isFinal (true once closed) and durationMinutes. Null otherwise."
                          },
                          "editControl": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "Edit history: editTweetIds (every version, oldest first; one id when never edited), isEditEligible, editableUntil (ISO 8601) and editsRemaining."
                          },
                          "possiblySensitive": {
                            "type": [
                              "boolean",
                              "null"
                            ],
                            "description": "X’s sensitive-media flag on the post."
                          },
                          "communityNote": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "additionalProperties": true,
                            "description": "The community note shown on the post: id, title (e.g. \"Readers added context\", it changes as the note is rated), text, language, url and urls[]. Null when there is none."
                          },
                          "isPromoted": {
                            "type": "boolean",
                            "description": "True for an ad X placed in the list. It is kept in place, only labelled."
                          }
                        }
                      },
                      "description": "The account’s replies, newest first, each with the same fields as a tweet; inReplyToStatusId says what each answers."
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "default": {
                    "value": {
                      "listingType": "twitter-user-replies",
                      "user": {
                        "id": "11348282",
                        "name": "NASA",
                        "handle": "NASA",
                        "followersCount": 92312272,
                        "verified": true
                      },
                      "itemCount": 1,
                      "nextCursor": "DAABCgABHVf6hGP__z8KAAIdV_ZnL5ag",
                      "tweets": [
                        {
                          "id": "2113776971603689874",
                          "conversationId": "2113776971603689874",
                          "createdAt": "Fri Oct 23 23:37:56 +0000 2026",
                          "text": "We are not slowing down. 🚀 Our Artemis II crew is training for their trip around the Moon.",
                          "lang": "en",
                          "source": null,
                          "inReplyToStatusId": null,
                          "inReplyToUserId": null,
                          "url": "https://x.com/NASA/status/2113776971603689874",
                          "author": {
                            "id": "11348282",
                            "name": "NASA",
                            "handle": "NASA",
                            "description": "Making the seemingly impossible, possible. ✨",
                            "followersCount": 92312272,
                            "followingCount": 115,
                            "verified": true
                          },
                          "counts": {
                            "replies": 339,
                            "reposts": 970,
                            "likes": 7439,
                            "quotes": 83,
                            "bookmarks": 341,
                            "views": 1273965
                          },
                          "media": [
                            {
                              "type": "video",
                              "mediaUrl": "https://pbs.twimg.com/media/HVWk812WIAAg_hz.jpg",
                              "expandedUrl": "https://x.com/NASA/status/2113776971603689874/video/1"
                            }
                          ]
                        }
                      ],
                      "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": []
          }
        ]
      }
    },
    "/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": []
          }
        ]
      }
    }
  }
}