{"openapi":"3.1.0","info":{"title":"TwexAPI","description":"Public OpenAPI documentation for currently listed TwexAPI public-data endpoints.\n\nData handling\n\nTwexAPI does not maintain an archive or database of X content. We do not persist copies of public posts, X Articles, direct-message content, or AI chat content obtained through customer requests.\n\nRequests are processed in transit. We retain only limited operational information necessary for security, abuse prevention, billing, and service reliability, such as request timestamps, endpoint usage, status codes, and credit consumption. We do not sell or provide archived X-content datasets.\n\nSecurity & BYOC (Bring Your Own Cookie)\n\nTwexAPI provides stateless automation middleware. For account write actions (posts, DMs, likes), users must authenticate using their own Twitter session credentials. TwexAPI does not provide, sell, or manage third-party accounts.\n\nUser Responsibility: Calling write endpoints requires lawful authorization to operate the target account. The user assumes full responsibility for the compliance and legality of all published content.\n\nEphemeral Execution: User-supplied credentials (auth_token and session cookies) exist solely in memory during the transit lifecycle of a single HTTP proxy request and are immediately released upon execution without persistent storage.","contact":{"name":"TwexAPI Support","email":"support@twexapi.io","url":"https://twexapi.io/contact"},"license":{"name":"MIT"},"version":"1.0.0","summary":"Affordable public social data API with broad endpoint coverage.","termsOfService":"https://twexapi.io/terms"},"servers":[{"url":"https://api.twexapi.io","description":"Production API"}],"paths":{"/twitter/advanced_search":{"post":{"tags":["Search Endpoints"],"summary":"Advanced Twitter Search","description":"Perform advanced search on Twitter with multiple search terms and filters, $0.05/1000 tweets. The maximum input quantity is limited by your plan's QPS. To pass larger input quantity limits, upgrade your plan to get higher QPS.","operationId":"get_data_twitter_advanced_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchQuery"}}},"required":true},"responses":{"200":{"description":"List of tweets matching search criteria","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/advanced_search/page":{"post":{"tags":["Search Endpoints"],"summary":"Advanced Twitter Search by Page","description":"Perform advanced Twitter search with cursor-based pagination. Each page returns up to 20 tweets. Pass next_cursor from the previous response to continue. Pricing: $0.05 per 1,000 tweets. The maximum input quantity is limited by your plan's QPS. To pass larger input quantity limits, upgrade your plan to get higher QPS.","operationId":"get_data_page_twitter_advanced_search_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedSearchCursorQuery"}}},"required":true},"responses":{"200":{"description":"Current page data (up to 20 tweets) and pagination metadata (has_next_page, next_cursor).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedSearchCursorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/cashtags":{"post":{"tags":["Search Endpoints"],"summary":"Search Cashtags","description":"Search for tweets containing specific cashtags (stock symbols), $0.05/1000 tweets. The maximum input quantity is limited by your plan's QPS. To pass larger input quantity limits, upgrade your plan to get higher QPS.","operationId":"get_cashtags_twitter_cashtags_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CashtagsQuery"}}},"required":true},"responses":{"200":{"description":"List of tweets containing the specified cashtag","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/hashtags":{"post":{"tags":["Search Endpoints"],"summary":"Search Hashtags","description":"Search for tweets containing specific hashtags. The maximum input quantity is limited by your plan's QPS. To pass larger input quantity limits, upgrade your plan to get higher QPS.","operationId":"get_hashtags_twitter_hashtags_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HashtagsQuery"}}},"required":true},"responses":{"200":{"description":"List of tweets containing the specified hashtag","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/users":{"post":{"tags":["Users Endpoints"],"summary":"Get Multiple Users by Usernames","description":"Retrieve detailed profile information for multiple Twitter users by their usernames or profile URLs, $0.05/1000 users. The maximum input quantity is limited by your plan's QPS. To pass larger input quantity limits, upgrade your plan to get higher QPS.","operationId":"get_users_by_usernames_twitter_users_post","requestBody":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Usernames","description":"A list of Twitter usernames or profile URLs. Provide multiple times for multiple users (e.g., `[elonmusk,sundarpichai]`).","examples":["elonmusk","sundarpichai"]}}},"required":true},"responses":{"200":{"description":"A list of user profile objects. Unfound users are represented by `null`.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/latest-followers/{screen_name}":{"get":{"tags":["Followers & Following Endpoints"],"summary":"Get Latest Followers","description":"Get latest followers of a user, $0.05/1000 followers.","operationId":"get_latest_followers_apiendpoint_twitter_latest_followers__screen_name__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"screen_name","in":"path","required":true,"schema":{"type":"string","description":"The screen name of the user to get latest followers.","examples":["elonmusk"],"title":"Screen Name"},"description":"The screen name of the user to get latest followers."}],"responses":{"200":{"description":"A list of user info","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LatestFollowersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/latest-following/{screen_name}":{"get":{"tags":["Followers & Following Endpoints"],"summary":"Get Latest Following","description":"Get latest following of a user, $0.05/1000 following.","operationId":"get_latest_following_apiendpoint_twitter_latest_following__screen_name__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"screen_name","in":"path","required":true,"schema":{"type":"string","description":"The screen name of the user to get latest following.","examples":["elonmusk"],"title":"Screen Name"},"description":"The screen name of the user to get latest following."}],"responses":{"200":{"description":"A list of user info","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LatestFollowingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/followers/{screen_name}/{count}":{"get":{"tags":["Followers & Following Endpoints"],"summary":"Get Followers","description":"Get followers of a user, $0.05/1000 followers. When count > 5000, returns a task_id immediately (HTTP 202). Use GET /twitter/followers/task/{task_id}/status to check progress, and GET /twitter/followers/task/{task_id}/next to consume pages one by one.","operationId":"get_followers_apiendpoint_twitter_followers__screen_name___count__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"screen_name","in":"path","required":true,"schema":{"type":"string","description":"The screen name of the user to get followers.","examples":["elonmusk"],"title":"Screen Name"},"description":"The screen name of the user to get followers."},{"name":"count","in":"path","required":true,"schema":{"type":"integer","description":"The number of followers to get.","examples":[200],"title":"Count"},"description":"The number of followers to get."}],"responses":{"200":{"description":"A list of user info, or a task_id for large requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetFollowersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/followers/task/{task_id}/status":{"get":{"tags":["Followers & Following Endpoints"],"summary":"Get Followers Task Status","description":"Check progress of a large followers task. status: pending | running | done | error.","operationId":"get_followers_task_status_twitter_followers_task__task_id__status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","description":"task_id returned when submitting a large followers request","title":"Task Id"},"description":"task_id returned when submitting a large followers request"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/followers/task/{task_id}/next":{"get":{"tags":["Followers & Following Endpoints"],"summary":"Consume Next Page of Followers Task","description":"Return the next available page (~200 followers) from the task. Each page is removed after being returned. Keep polling until status=done and data=[] (all pages consumed).","operationId":"get_followers_task_next_page_twitter_followers_task__task_id__next_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","description":"task_id returned when submitting a large followers request","title":"Task Id"},"description":"task_id returned when submitting a large followers request"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/followers/page":{"post":{"tags":["Followers & Following Endpoints"],"summary":"Get Followers by Page","description":"Retrieve a paginated list of followers using cursor-based pagination. Each page returns up to 200 followers. Pass next_cursor from the previous response to continue. Pricing: $0.05 per 1,000 followers.","operationId":"get_followers_cursor_apiendpoint_twitter_followers_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetFollowersCursorQuery"}}},"required":true},"responses":{"200":{"description":"Current page data (up to 200 followers) and pagination metadata (has_next_page, next_cursor).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetFollowersCursorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/following/page":{"post":{"tags":["Followers & Following Endpoints"],"summary":"Get Following by Page","description":"Retrieve a paginated list of following users using cursor-based pagination. Each page returns up to 200 users. Pass next_cursor from the previous response to continue. Pricing: $0.05 per 1,000 following users.","operationId":"get_following_cursor_apiendpoint_twitter_following_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetFollowingCursorQuery"}}},"required":true},"responses":{"200":{"description":"Current page data (up to 200 following users) and pagination metadata (has_next_page, next_cursor).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetFollowingCursorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/following/{screen_name}/{count}":{"get":{"tags":["Followers & Following Endpoints"],"summary":"Get Following","description":"Get following of a user, $0.05/1000 following. When count > 5000, returns a task_id immediately (HTTP 202). Use GET /twitter/following/task/{task_id}/status to check progress, and GET /twitter/following/task/{task_id}/next to consume pages one by one.","operationId":"get_following_apiendpoint_twitter_following__screen_name___count__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"screen_name","in":"path","required":true,"schema":{"type":"string","description":"The screen name of the user to get following.","examples":["elonmusk"],"title":"Screen Name"},"description":"The screen name of the user to get following."},{"name":"count","in":"path","required":true,"schema":{"type":"integer","description":"The number of following to get.","examples":[200],"title":"Count"},"description":"The number of following to get."}],"responses":{"200":{"description":"A list of user info, or a task_id for large requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetFollowingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/following/task/{task_id}/status":{"get":{"tags":["Followers & Following Endpoints"],"summary":"Get Following Task Status","description":"Check progress of a large following task. status: pending | running | done | error.","operationId":"get_following_task_status_twitter_following_task__task_id__status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","description":"task_id returned when submitting a large following request","title":"Task Id"},"description":"task_id returned when submitting a large following request"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/following/task/{task_id}/next":{"get":{"tags":["Followers & Following Endpoints"],"summary":"Consume Next Page of Following Task","description":"Return the next available page (~200 following) from the task. Each page is removed after being returned. Keep polling until status=done and data=[] (all pages consumed).","operationId":"get_following_task_next_page_twitter_following_task__task_id__next_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","description":"task_id returned when submitting a large following request","title":"Task Id"},"description":"task_id returned when submitting a large following request"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v3/twitter/users/following":{"post":{"tags":["Followers & Following Endpoints"],"summary":"Get Following (v3)","description":"Get following list of a user. Page size 10-100; use cursor for more pages. $0.05/1000 users.","operationId":"following_v3_api_v3_twitter_users_following_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowersFollowingV3Query"}}},"required":true},"responses":{"200":{"description":"Following page with cursor pagination.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifiedFollowersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v3/twitter/users/followers":{"post":{"tags":["Followers & Following Endpoints"],"summary":"Get Followers (v3)","description":"Get followers of a user. Page size 10-100; use cursor for more pages. $0.05/1000 users.","operationId":"followers_v3_api_v3_twitter_users_followers_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowersFollowingV3Query"}}},"required":true},"responses":{"200":{"description":"Followers page with cursor pagination.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifiedFollowersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v3/twitter/users/verified-followers":{"post":{"tags":["Followers & Following Endpoints"],"summary":"Get Verified Followers","description":"Get blue-verified followers of a user. Page size 10-100; use cursor for more pages. $0.05/1000 users.","operationId":"verified_followers_api_v3_twitter_users_verified_followers_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowersFollowingV3Query"}}},"required":true},"responses":{"200":{"description":"Verified followers page with cursor pagination.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifiedFollowersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v3/twitter/tweets/create-thread":{"post":{"tags":["Tweet Actions Endpoints"],"summary":"Create a Tweet Thread","description":"Create a tweet thread from an ordered list of texts, $0.0005 per call.","operationId":"create_tweet_thread_api_v3_twitter_tweets_create_thread_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateThreadQuery"}}},"required":true},"responses":{"200":{"description":"Created tweet ids in thread order.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateThreadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/tweets/create":{"post":{"tags":["Tweet Actions Endpoints"],"summary":"Create a Tweet or Reply","description":"Posts a new tweet. To create a reply, provide the `reply_tweet_id`. This endpoint does not handle quote tweets,$0.0005 per call.","operationId":"create_tweet_twitter_tweets_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostTweetQuery"}}},"required":true},"responses":{"200":{"description":"The ID and user ID of the newly created tweet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostTweetResponse"}}}},"409":{"description":"A request with the same Idempotency-Key is still running. Retry later with the same key."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":255},"example":"8f14e45f-ceea-467f-a8d1-1f0b4c2a9e01","description":"Optional. A unique value for each post (1–255 visible ASCII characters, such as a UUID). Retrying with the same key and body within 24 hours returns the first successful response with the header Idempotent-Replayed: true instead of posting again, and is not charged. The same key with a different body returns 422."}]}},"/twitter/tweets/{tweet_id}/replies/page":{"post":{"tags":["Tweet Replies Endpoints"],"summary":"Get Replies by Page (Recommended)","description":"**Recommended** for fetching tweet replies. Uses cursor-based pagination and avoids timeouts on large threads. The first request (omit next_cursor) returns root_tweet plus the first batch of replies. Pass next_cursor from the previous response to fetch the next page until has_next_page is false. Pricing: $0.05 per 1,000 replies.","operationId":"get_replies_page_apiendpoint_twitter_tweets__tweet_id__replies_page_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"tweet_id","in":"path","required":true,"schema":{"type":"string","description":"The ID of the tweet to get replies for.","examples":["1803006263529541838"],"title":"Tweet Id"},"description":"The ID of the tweet to get replies for."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetRepliesPageQuery"}}}},"responses":{"200":{"description":"Current page replies, optional root_tweet on first page, and pagination metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetRepliesPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweets/{tweet_id}/replies/{count}":{"get":{"tags":["Tweet Replies Endpoints"],"summary":"Get Replies by Tweet ID (Legacy)","description":"Get replies for a specific tweet, returned as a nested Tweet object. $0.05/1000 replies. **For new integrations, use POST /twitter/tweets/{tweet_id}/replies/page instead** — it supports cursor pagination, is more reliable for large reply threads, and avoids request timeouts.","operationId":"get_replies_by_id_twitter_tweets__tweet_id__replies__count__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"tweet_id","in":"path","required":true,"schema":{"type":"string","description":"The ID of the tweet to get replies for.","examples":["1803006263529541838"],"title":"Tweet Id"},"description":"The ID of the tweet to get replies for."},{"name":"count","in":"path","required":true,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"Maximum number of replies to return.","examples":[50],"title":"Count"},"description":"Maximum number of replies to return."},{"name":"sort_by","in":"query","required":false,"schema":{"anyOf":[{"enum":["Relevance","Recency","Likes"],"type":"string"},{"type":"null"}],"description":"Sort by Relevancy or Latest or Likes","examples":["Relevance","Recency","Likes"],"default":"Recency","title":"Sort By"},"description":"Sort by Relevancy or Latest or Likes"}],"responses":{"200":{"description":"The root Tweet object with its replies.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweets/sentiment":{"post":{"tags":["Sentiment Analysis Endpoints"],"summary":"Sentiment Analysis","description":"Sentiment Analysis, 50 credits per call.","operationId":"sentiment_analysis_endpoint_twitter_tweets_sentiment_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentimentAnalysisQuery"}}},"required":true},"responses":{"200":{"description":"A sentiment object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentimentAnalysisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/users/by_ids":{"post":{"tags":["Users Endpoints"],"summary":"Users Details by ID","description":"Users Details by ID. The maximum input quantity is limited by your plan's QPS. To pass larger input quantity limits, upgrade your plan to get higher QPS.","operationId":"users_details_by_id_api_twitter_users_by_ids_post","requestBody":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"User Ids","description":"A list of Twitter user IDs. Provide multiple times for multiple users (e.g., `[44196397,1696160451770429440]`).","examples":[["44196397","1696160451770429440"]]}}},"required":true},"responses":{"200":{"description":"A list of User objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsersDetailsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/users/status":{"post":{"tags":["Users Endpoints"],"summary":"Batch Get User account status","description":"Retrieve detailed account status for multiple Twitter users by their usernames. The maximum input quantity is limited by your plan's QPS. To pass larger input quantity limits, upgrade your plan to get higher QPS.","operationId":"batch_get_user_account_status_endpoint","requestBody":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Usernames","description":"A list of usernames of the users to get information for.","examples":[["elonmusk","sundarpichai"]]}}},"required":true},"responses":{"200":{"description":"A list of user account status strings. If user is suspended return suspended, if unfound return null.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/tweets/thread_by_id":{"post":{"tags":["Tweets Endpoints"],"summary":"Get Tweet Thread by ID","description":"Retrieve all tweets in a thread by tweet ID, sorted by latest.","operationId":"tweet_thread_by_id_twitter_tweets_thread_by_id_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TweetThreadByIdBody"}}},"required":true},"responses":{"200":{"description":"A list of tweets in the thread, sorted by latest.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/tweets/{tweet_id}/similar":{"get":{"tags":["Tweets Endpoints"],"summary":"Get Similar Tweets","description":"Get similar tweets","operationId":"similar_tweets_api_twitter_tweets__tweet_id__similar_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"tweet_id","in":"path","required":true,"schema":{"type":"string","title":"Tweet Id"}}],"responses":{"200":{"description":"A list of tweet objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTweetsByIdResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/search-user/{keyword}/{target_count}":{"get":{"tags":["Users Endpoints"],"summary":"Search User","description":"Search user","operationId":"search_user_api_endpoint_twitter_search_user__keyword___target_count__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"keyword","in":"path","required":true,"schema":{"type":"string","description":"The keyword to search for.","title":"Keyword"},"description":"The keyword to search for."},{"name":"target_count","in":"path","required":true,"schema":{"type":"integer","description":"The number of users to return.","title":"Target Count"},"description":"The number of users to return."}],"responses":{"200":{"description":"A list of user objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchUserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweets/{tweet_id}/retweeters/{target_count}":{"get":{"tags":["Tweet Interaction Endpoints"],"summary":"Get Retweeters","description":"Retrieve retweeters in a single request. Automatically paginates until count is reached or no more results. Minimum 10, maximum 5000 users.","operationId":"get_retweeters_endpoint_twitter_tweets__tweet_id__retweeters__target_count__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"tweet_id","in":"path","required":true,"schema":{"type":"string","description":"The ID of the tweet to get retweeters for.","title":"Tweet Id"},"description":"The ID of the tweet to get retweeters for."},{"name":"target_count","in":"path","required":true,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"Number of retweeters to return (minimum 10, maximum 5000).","examples":[100],"title":"Target Count"},"description":"Number of retweeters to return (minimum 10, maximum 5000)."}],"responses":{"200":{"description":"A list of user objects (up to count).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchUserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweets/retweeters/page":{"post":{"tags":["Tweet Interaction Endpoints"],"summary":"Get Retweeters by Page","description":"Retrieve retweeters using cursor-based pagination. Each page returns up to 20 users. Pass next_cursor from the previous response to continue.","operationId":"get_retweeters_page_endpoint_twitter_tweets_retweeters_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetRetweetersCursorQuery"}}},"required":true},"responses":{"200":{"description":"Current page data (up to 20 users) and pagination metadata (has_next_page, next_cursor).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetRetweetersCursorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/tweets/quotes":{"post":{"tags":["Tweet Interaction Endpoints"],"summary":"Get Quote Tweets","description":"Retrieve quote tweets in a single request. Automatically paginates until count is reached or no more results. Use `Latest` for chronological order or `Top` for ranked results. Minimum 10, maximum 5000 tweets.","operationId":"get_quotes_endpoint_twitter_tweets_quotes_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetQuotesQuery"}}},"required":true},"responses":{"200":{"description":"A list of quote tweet objects (up to count).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetQuotesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/tweets/quotes/page":{"post":{"tags":["Tweet Interaction Endpoints"],"summary":"Get Quote Tweets by Page","description":"Retrieve quote tweets using cursor-based pagination. Each page returns up to 20 tweets. Use `Latest` for chronological order or `Top` for ranked results. Pass next_cursor from the previous response to continue.","operationId":"get_quotes_page_endpoint_twitter_tweets_quotes_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetQuotesCursorQuery"}}},"required":true},"responses":{"200":{"description":"Current page data (up to 20 quote tweets) and pagination metadata (has_next_page, next_cursor).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetQuotesCursorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/community/{community_id}/members/{target_count}":{"get":{"tags":["Communities Endpoints"],"summary":"Get Community Members","description":"Get community members","operationId":"get_community_members_endpoint_twitter_community__community_id__members__target_count__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"community_id","in":"path","required":true,"schema":{"type":"string","title":"Community Id"}},{"name":"target_count","in":"path","required":true,"schema":{"type":"integer","title":"Target Count"}}],"responses":{"200":{"description":"A list of user objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchUserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/community/members/page":{"post":{"tags":["Communities Endpoints"],"summary":"Get Community Members by Page","description":"Retrieve a paginated list of community members using cursor-based pagination. Each page returns up to 20 members. Pass next_cursor from the previous response to continue. Pricing: $0.05 per 1,000 members.","operationId":"get_community_members_page_endpoint_twitter_community_members_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCommunityMembersCursorQuery"}}},"required":true},"responses":{"200":{"description":"Current page data (up to 20 members) and pagination metadata (has_next_page, next_cursor).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCommunityMembersCursorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/community/{community_id}/tweets/{tweet_type}/{target_count}":{"get":{"tags":["Communities Endpoints"],"summary":"Get Community Tweets","description":"Get community tweets","operationId":"get_community_tweets_endpoint_twitter_community__community_id__tweets__tweet_type___target_count__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"community_id","in":"path","required":true,"schema":{"type":"string","title":"Community Id"}},{"name":"tweet_type","in":"path","required":true,"schema":{"enum":["Top","Latest","Media"],"type":"string","title":"Tweet Type"}},{"name":"target_count","in":"path","required":true,"schema":{"type":"integer","title":"Target Count"}}],"responses":{"200":{"description":"A list of tweet objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityTweetsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/community/tweets/page":{"post":{"tags":["Communities Endpoints"],"summary":"Get Community Tweets by Page","description":"Retrieve a paginated list of community tweets using cursor-based pagination. Each page returns up to 20 tweets. Pass next_cursor from the previous response to continue. Pricing: $0.05 per 1,000 tweets.","operationId":"get_community_tweets_page_endpoint_twitter_community_tweets_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCommunityTweetsCursorQuery"}}},"required":true},"responses":{"200":{"description":"Current page data (up to 20 tweets) and pagination metadata (has_next_page, next_cursor).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCommunityTweetsCursorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/list/{list_id}/tweets/{target_count}":{"get":{"tags":["Lists Endpoints"],"summary":"Get List Tweets","description":"Get list tweets","operationId":"get_list_tweets_endpoint_twitter_list__list_id__tweets__target_count__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","title":"List Id"}},{"name":"target_count","in":"path","required":true,"schema":{"type":"integer","title":"Target Count"}}],"responses":{"200":{"description":"A list of tweet objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListTweetsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/list/tweets/page":{"post":{"tags":["Lists Endpoints"],"summary":"Get List Tweets by Page","description":"Retrieve a paginated list of list tweets using cursor-based pagination. Each page returns up to 20 tweets. Pass next_cursor from the previous response to continue. Pricing: $0.05 per 1,000 tweets.","operationId":"get_list_tweets_page_endpoint_twitter_list_tweets_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetListTweetsCursorQuery"}}},"required":true},"responses":{"200":{"description":"Current page data (up to 20 tweets) and pagination metadata (has_next_page, next_cursor).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetListTweetsCursorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/list/{list_id}/subscribers/{target_count}":{"get":{"tags":["Lists Endpoints"],"summary":"Get List Subscribers","description":"Get list subscribers","operationId":"get_list_subscribers_endpoint_twitter_list__list_id__subscribers__target_count__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","title":"List Id"}},{"name":"target_count","in":"path","required":true,"schema":{"type":"integer","title":"Target Count"}}],"responses":{"200":{"description":"A list of user objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListSubscribersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/list/{list_id}/members/{target_count}":{"get":{"tags":["Lists Endpoints"],"summary":"Get List Members","description":"Get list members","operationId":"get_list_members_endpoint_twitter_list__list_id__members__target_count__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","title":"List Id"}},{"name":"target_count","in":"path","required":true,"schema":{"type":"integer","title":"Target Count"}}],"responses":{"200":{"description":"A list of user objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListMembersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/list/members/page":{"post":{"tags":["Lists Endpoints"],"summary":"Get List Members by Page","description":"Retrieve a paginated list of list members using cursor-based pagination. Each page returns up to 20 members. Pass next_cursor from the previous response to continue. Pricing: $0.05 per 1,000 members.","operationId":"get_list_members_page_endpoint_twitter_list_members_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetListMembersCursorQuery"}}},"required":true},"responses":{"200":{"description":"Current page data (up to 20 members) and pagination metadata (has_next_page, next_cursor).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetListMembersCursorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/list/search":{"post":{"tags":["Lists Endpoints"],"summary":"Search List","description":"Search list","operationId":"search_list_endpoint_twitter_list_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchListQuery"}}},"required":true},"responses":{"200":{"description":"A list of list objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/community/search":{"post":{"tags":["Communities Endpoints"],"summary":"Search Community","description":"Search community","operationId":"search_community_endpoint_twitter_community_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchCommunityQuery"}}},"required":true},"responses":{"200":{"description":"A list of community objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchCommunityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/community/{community_id}":{"get":{"tags":["Communities Endpoints"],"summary":"Get Community","description":"Get community","operationId":"get_community_endpoint_twitter_community__community_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"community_id","in":"path","required":true,"schema":{"type":"string","title":"Community Id"}}],"responses":{"200":{"description":"A community object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCommunityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/community/search-tweets":{"post":{"tags":["Communities Endpoints"],"summary":"Search Community Tweets","description":"Search community tweets","operationId":"search_community_tweets_endpoint_twitter_community_search_tweets_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchCommunityTweetsQuery"}}},"required":true},"responses":{"200":{"description":"A list of tweet objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityTweetsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/global-trending/countries":{"get":{"tags":["Trending Endpoints"],"summary":"List Global Trend Countries","description":"Get the supported country and global options that can be used to filter trending tweets.","operationId":"get_global_trending_countries_api_twitter_global_trending_countries_get","responses":{"200":{"description":"Country filter options for global trending tweets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/global-trending/topics":{"get":{"tags":["Trending Endpoints"],"summary":"List Global Trend Topics","description":"Get the topic categories available for filtering global trending tweets.","operationId":"get_global_trending_topics_api_twitter_global_trending_topics_get","responses":{"200":{"description":"Topic filter options for global trending tweets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/global-trending/contents":{"get":{"tags":["Trending Endpoints"],"summary":"List Global Trend Content Tags","description":"Get content tags for a selected country and topic so tweets can be filtered more precisely.","operationId":"get_global_trending_contents_api_twitter_global_trending_contents_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"country","in":"query","required":true,"schema":{"type":"string","description":"Country name or slug returned by /twitter/global-trending/countries","title":"Country"},"description":"Country name or slug returned by /twitter/global-trending/countries"},{"name":"topic","in":"query","required":true,"schema":{"type":"string","description":"Topic name or slug returned by /twitter/global-trending/topics","title":"Topic"},"description":"Topic name or slug returned by /twitter/global-trending/topics"}],"responses":{"200":{"description":"Content tag options for the selected country and topic.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/global-trending/tweets":{"get":{"tags":["Trending Endpoints"],"summary":"Get Global Trending Tweets","description":"Get trending tweets for a country, with optional topic and content tag filters.","operationId":"get_global_trending_tweets_api_twitter_global_trending_tweets_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"country","in":"query","required":true,"schema":{"type":"string","description":"Country name or slug returned by /twitter/global-trending/countries","title":"Country"},"description":"Country name or slug returned by /twitter/global-trending/countries"},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional topic name or slug returned by /twitter/global-trending/topics","title":"Topic"},"description":"Optional topic name or slug returned by /twitter/global-trending/topics"},{"name":"content","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional content tag returned by /twitter/global-trending/contents","title":"Content"},"description":"Optional content tag returned by /twitter/global-trending/contents"},{"name":"count","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of tweets to return.","default":20,"title":"Count"},"description":"Maximum number of tweets to return."}],"responses":{"200":{"description":"Trending tweets matching the selected filters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/{country}/trending":{"get":{"tags":["Trending Endpoints"],"summary":"Get Trending Topics","description":"Get X Explore trending topics for a given country. Use 'worldwide' for account-default trends or a country slug such as 'united-states'.","operationId":"get_trending_api_twitter__country__trending_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"country","in":"path","required":true,"schema":{"enum":["worldwide","algeria","argentina","australia","austria","bahrain","belarus","belgium","brazil","canada","chile","colombia","denmark","dominican-republic","ecuador","egypt","france","germany","ghana","greece","guatemala","india","indonesia","ireland","israel","italy","japan","jordan","kenya","korea","kuwait","latvia","lebanon","malaysia","mexico","netherlands","new-zealand","nigeria","norway","oman","pakistan","panama","peru","philippines","poland","portugal","qatar","russia","saudi-arabia","singapore","south-africa","spain","sweden","switzerland","thailand","turkey","ukraine","united-arab-emirates","united-kingdom","united-states","venezuela","vietnam","zimbabwe"],"type":"string","description":"Country slug or 'worldwide' for default explore trends","examples":["worldwide","united-states","japan","united-kingdom","zimbabwe"],"title":"Country"},"description":"Country slug or 'worldwide' for default explore trends"}],"responses":{"200":{"description":"Standard response with list of trending topics in data field","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/{screen_name}/tweets-replies/{count}":{"get":{"tags":["All Tweets Replies Endpoints"],"summary":"Get All Tweets and Replies by User","description":"Get all tweets and replies posted by a specific Twitter user. Returns a comprehensive list including both original tweets and reply tweets posted by the user. $0.05/1000 items.","operationId":"get_all_tweets_replies_api_twitter__screen_name__tweets_replies__count__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"screen_name","in":"path","required":true,"schema":{"type":"string","description":"The screen name (username) of the Twitter user to get all tweets and replies from.","examples":["elonmusk"],"title":"Screen Name"},"description":"The screen name (username) of the Twitter user to get all tweets and replies from."},{"name":"count","in":"path","required":true,"schema":{"type":"integer","maximum":10000000,"minimum":1,"description":"Maximum number of tweets and replies to return.","examples":[50],"title":"Count"},"description":"Maximum number of tweets and replies to return."}],"responses":{"200":{"description":"A list of all tweets and replies posted by the user, including both original tweets and reply tweets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/{screen_name}/timeline/page":{"post":{"tags":["Timeline Endpoints"],"summary":"Get User Timeline by Page","description":"Fetch a single page from a user's timeline using POST. Pass next_cursor in the body to continue.","operationId":"get_user_timeline_page_api_twitter__screen_name__timeline_page_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"screen_name","in":"path","required":true,"schema":{"type":"string","description":"Twitter screen name of the target user (with or without @).","examples":["elonmusk"],"title":"Screen Name"},"description":"Twitter screen name of the target user (with or without @)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserTimelinePageQuery"}}}},"responses":{"200":{"description":"Current page data and pagination metadata (has_next_page, next_cursor).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserTimelinePageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/{screen_name}/timeline":{"post":{"tags":["Timeline Endpoints"],"summary":"Get User Timeline and Fill Count","description":"Fetch a user's timeline across pages using POST and try to fill the requested count.","operationId":"get_user_timeline_fill_api_twitter__screen_name__timeline_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"screen_name","in":"path","required":true,"schema":{"type":"string","description":"Twitter screen name of the target user (with or without @).","examples":["elonmusk"],"title":"Screen Name"},"description":"Twitter screen name of the target user (with or without @)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserTimelineFillQuery"}}}},"responses":{"200":{"description":"All fetched tweets and pagination summary.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserTimelineResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweets-replies/page":{"post":{"tags":["All Tweets Replies Endpoints"],"summary":"Get All Tweets and Replies by User by Page","description":"Retrieve a paginated list of a user's tweets and replies using cursor-based pagination. Each page returns up to 20 items. Pass next_cursor from the previous response to continue. Pricing: $0.05 per 1,000 items.","operationId":"get_all_tweets_replies_cursor_api_twitter_tweets_replies_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAllTweetsRepliesCursorQuery"}}},"required":true},"responses":{"200":{"description":"Current page data (up to 20 items) and pagination metadata (has_next_page, next_cursor).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAllTweetsRepliesCursorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/account/based":{"post":{"tags":["Twitter Account Based in Endpoints"],"summary":"Get Twitter Account Based in","description":"Get Twitter Account Based in. The maximum input quantity is limited by your plan's QPS. To pass larger input quantity limits, upgrade your plan to get higher QPS.","operationId":"get_twitter_account_based_api_twitter_account_based_post","requestBody":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Screen Names","description":"A json list of Twitter user screen names. Provide multiple times for multiple users (e.g., `[elonmusk,sundarpichai]`).","examples":["screen_name","elonmusk"]}}},"required":true},"responses":{"200":{"description":"The Twitter Account Based in data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwitterAccountBasedStandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/twitter/{screen_name}/about":{"get":{"tags":["Twitter User About Endpoints"],"summary":"Get Twitter User About by Screen Name","description":"Get Twitter User About for a specific twitter user. get account_based_in,location_accurate","operationId":"get_twitter_user_about_by_screen_name_api_twitter__screen_name__about_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"screen_name","in":"path","required":true,"schema":{"type":"string","description":"The screen name of the twitter user to get about.","examples":"elonmusk","title":"Screen Name"},"description":"The screen name of the twitter user to get about."}],"responses":{"200":{"description":"The Twitter User About object with its information.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwitterUserAboutStandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/balance":{"get":{"tags":["Balance Endpoints"],"summary":"Get Balance","description":"Get Balance","operationId":"get_balance_api_balance_get","responses":{"200":{"description":"The balance data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"HTTPBearer":[]}]}}},"components":{"schemas":{"AdvancedSearchCursorQuery":{"properties":{"searchTerms":{"items":{"type":"string"},"type":"array","title":"Searchterms","description":"List of search terms used to build the Twitter query."},"sortBy":{"type":"string","title":"Sortby","description":"Sort mode for search results. Supported values: 'Latest' or 'Top'."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor returned by the previous page. Leave empty to fetch the first page.","examples":["1234567890"]}},"type":"object","required":["searchTerms","sortBy"],"title":"AdvancedSearchCursorQuery"},"AdvancedSearchCursorResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"items":{"anyOf":[{"$ref":"#/components/schemas/TweetModel"},{"type":"null"}]},"type":"array","title":"Data","description":"Current page tweet items."},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Use this cursor to fetch the next page when has_next_page is true.","examples":["1234567890"]}},"type":"object","required":["data","has_next_page"],"title":"AdvancedSearchCursorResponse"},"CashtagsQuery":{"properties":{"cashtags":{"items":{"type":"string"},"type":"array","title":"Cashtags","description":"Cashtag to search for (with or without $ prefix)","default":[],"example":["AAPL","TSLA"]},"startTime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Starttime","description":"Start time for search in UNIX timestamp","example":"1775726400"},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endtime","description":"End time for search in UNIX timestamp","example":"1775727300"},"sortBy":{"anyOf":[{"type":"string","enum":["Latest","Top"]},{"type":"null"}],"title":"Sortby","description":"Sort order for results","default":"Latest"},"maxItems":{"anyOf":[{"type":"integer","maximum":1000,"minimum":1},{"type":"null"}],"title":"Maxitems","description":"Maximum number of tweets to return","default":20},"mininumLikes":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Mininumlikes","description":"Minimum number of likes required","default":0},"mininumRetweets":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Mininumretweets","description":"Minimum number of retweets required","default":0},"mininumReplies":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Mininumreplies","description":"Minimum number of replies required","default":0},"blueVerified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Blueverified","description":"Filter for blue verified accounts only"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","description":"Filter for verified accounts only"},"language":{"anyOf":[{"type":"string","enum":["am","ar","bg","bn","bo","ca","ch","cs","da","de","dv","el","en","es","et","fa","fi","fr","gu","hi","ht","hu","hy","in","is","it","iu","iw","ja","ka","km","kn","ko","lo","lt","lv","ml","my","ne","nl","no","or","pa","pl","pt","ro","ru","si","sk","sl","sv","ta","te","th","tl","tr","uk","ur","vi","zh"]},{"type":"null"}],"title":"Language","description":"Language filter for tweets","example":"en"},"onlyImage":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Onlyimage","description":"Filter for images only"},"onlyVideo":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Onlyvideo","description":"Filter for videos only"},"onlyQuote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Onlyquote","description":"Filter for quotes only"},"onlyReply":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Onlyreply","description":"Filter for replies only"}},"type":"object","title":"CashtagsQuery","description":"Query parameters for searching cashtags (stock symbols)"},"CommunityModel":{"properties":{"id":{"type":"string","title":"Id","description":"The ID of the community"},"name":{"type":"string","title":"Name","description":"The name of the community"},"description":{"type":"string","title":"Description","description":"The description of the community"},"member_count":{"type":"integer","title":"Member Count","description":"The number of members in the community"},"is_nsfw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Nsfw","description":"Indicates if the community is NSFW."},"members_facepile_results":{"items":{"type":"string"},"type":"array","title":"Members Facepile Results","description":"The profile image URLs of members."},"banner":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Banner","description":"The banner information of the community."},"is_member":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Member","description":"Indicates if the user is a member of the community."},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","description":"The role of the user in the community."},"admin":{"anyOf":[{"$ref":"#/components/schemas/UserModel"},{"type":"null"}],"description":"The admin of the community."},"join_policy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Join Policy","description":"The join policy of the community."},"created_at":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Created At","description":"The timestamp of the community's creation."},"invites_policy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invites Policy","description":"The invites policy of the community."},"is_pinned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Pinned","description":"Indicates if the community is pinned."}},"type":"object","required":["id","name","description","member_count"],"title":"CommunityModel"},"CommunityTweetsResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/TweetModel"},"type":"array","title":"Data","description":"A list of tweet objects."}},"type":"object","required":["code","msg","data"],"title":"CommunityTweetsResponse"},"CreateThreadData":{"properties":{"tweets":{"items":{"$ref":"#/components/schemas/CreateThreadTweetItem"},"type":"array","title":"Tweets","description":"Created tweets in thread order","example":[{"id":"1234567890123456789"}]}},"type":"object","required":["tweets"],"title":"CreateThreadData","description":"Create thread response data"},"CreateThreadQuery":{"properties":{"items":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Items","description":"JSON array of tweet texts, e.g. [\"1/ hello\",\"2/ world\"].","example":["1/ hello","2/ world"]},"cookie":{"type":"string","title":"Cookie","description":"The user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).","example":"ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7"},"proxy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proxy","description":"Optional HTTP proxy. Example: http://username:password@ip:port","example":"http://username:password@ip:port"}},"type":"object","required":["items","cookie"],"title":"CreateThreadQuery","description":"Parameters for creating a tweet thread"},"CreateThreadResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"Response code","example":200},"msg":{"type":"string","title":"Msg","description":"Response message","example":"success"},"data":{"anyOf":[{"$ref":"#/components/schemas/CreateThreadData"},{"type":"null"}],"description":"Created thread tweets"}},"type":"object","required":["code","msg"],"title":"CreateThreadResponse","description":"Response for creating a tweet thread"},"CreateThreadTweetItem":{"properties":{"id":{"type":"string","title":"Id","description":"Created tweet ID","example":"1234567890123456789"}},"type":"object","required":["id"],"title":"CreateThreadTweetItem","description":"Created tweet id in a thread"},"FollowersFollowingV3Query":{"properties":{"username":{"type":"string","title":"Username","description":"Twitter username (with or without @).","example":"elonmusk"},"count":{"anyOf":[{"type":"integer","maximum":100,"minimum":10},{"type":"null"}],"title":"Count","description":"Number of users to return per page (min 10, max 100).","default":20,"example":20},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor","description":"Cursor from previous next_cursor to fetch the next page.","example":"1870681402093130182|2076960004551737340"}},"type":"object","required":["username"],"title":"FollowersFollowingV3Query","description":"Parameters for getting followers / following / verified-followers (v3, no cookie required)"},"FriendshipTaskData":{"properties":{"task_id":{"type":"string","title":"Task Id","description":"Task ID for polling status/next endpoints"},"reused":{"type":"boolean","title":"Reused","description":"True if an in-flight task was reused"}},"type":"object","required":["task_id","reused"],"title":"FriendshipTaskData","description":"Async friendship fetch task handle"},"GetAllTweetsRepliesCursorQuery":{"properties":{"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor returned by the previous page. Leave empty to fetch the first page.","examples":["1234567890"]},"screen_name":{"type":"string","title":"Screen Name","description":"Twitter screen name of the target user (with or without @).","examples":["elonmusk"]}},"type":"object","required":["screen_name"],"title":"GetAllTweetsRepliesCursorQuery"},"GetAllTweetsRepliesCursorResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"items":{"anyOf":[{"$ref":"#/components/schemas/TweetModel"},{"type":"null"}]},"type":"array","title":"Data","description":"Current page items (tweets and replies)."},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Use this cursor to fetch the next page when has_next_page is true.","examples":["1234567890"]}},"type":"object","required":["data","has_next_page"],"title":"GetAllTweetsRepliesCursorResponse"},"GetCommunityMembersCursorQuery":{"properties":{"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor returned by the previous page. Leave empty to fetch the first page.","examples":["1234567890"]},"community_id":{"type":"string","title":"Community Id","description":"The ID of the community to get members from."}},"type":"object","required":["community_id"],"title":"GetCommunityMembersCursorQuery"},"GetCommunityMembersCursorResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/UserModel"},"type":"array","title":"Data","description":"A list of user objects."},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"The next cursor of the members to get.","examples":["1234567890"]}},"type":"object","required":["code","msg","data","has_next_page"],"title":"GetCommunityMembersCursorResponse"},"GetCommunityResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"anyOf":[{"$ref":"#/components/schemas/CommunityModel"},{"type":"null"}],"description":"A community object."}},"type":"object","required":["code","msg"],"title":"GetCommunityResponse"},"GetCommunityTweetsCursorQuery":{"properties":{"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor returned by the previous page. Leave empty to fetch the first page.","examples":["1234567890"]},"community_id":{"type":"string","title":"Community Id","description":"The ID of the community to get tweets from."},"tweet_type":{"type":"string","enum":["Top","Latest","Media"],"title":"Tweet Type","description":"The type of tweets to get."}},"type":"object","required":["community_id","tweet_type"],"title":"GetCommunityTweetsCursorQuery"},"GetCommunityTweetsCursorResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/TweetModel"},"type":"array","title":"Data","description":"A list of tweet objects."},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"The next cursor of the tweets to get.","examples":["1234567890"]}},"type":"object","required":["code","msg","data","has_next_page"],"title":"GetCommunityTweetsCursorResponse"},"GetFollowersCursorQuery":{"properties":{"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor returned by the previous page. Leave empty to fetch the first page.","examples":["1234567890"]},"screen_name":{"type":"string","title":"Screen Name","description":"Twitter screen name of the target user (with or without @).","examples":["elonmusk"]}},"type":"object","required":["screen_name"],"title":"GetFollowersCursorQuery"},"GetFollowersCursorResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"items":{"anyOf":[{"$ref":"#/components/schemas/UserInfo"},{"type":"null"}]},"type":"array","title":"Data","description":"Current page follower items."},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Use this cursor to fetch the next page when has_next_page is true.","examples":["1234567890"]}},"type":"object","required":["data","has_next_page"],"title":"GetFollowersCursorResponse"},"GetFollowersResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/UserInfo"},{"type":"null"}]},"type":"array"},{"$ref":"#/components/schemas/FriendshipTaskData"}],"title":"Data","description":"List of user info, or task handle when count exceeds async threshold"}},"type":"object","required":["data"],"title":"GetFollowersResponse","description":"get followers API response"},"GetFollowingCursorQuery":{"properties":{"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor returned by the previous page. Leave empty to fetch the first page.","examples":["1234567890"]},"screen_name":{"type":"string","title":"Screen Name","description":"Twitter screen name of the target user (with or without @).","examples":["elonmusk"]}},"type":"object","required":["screen_name"],"title":"GetFollowingCursorQuery"},"GetFollowingCursorResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"items":{"anyOf":[{"$ref":"#/components/schemas/UserInfo"},{"type":"null"}]},"type":"array","title":"Data","description":"Current page following items."},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Use this cursor to fetch the next page when has_next_page is true.","examples":["1234567890"]}},"type":"object","required":["data","has_next_page"],"title":"GetFollowingCursorResponse"},"GetFollowingResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/UserInfo"},{"type":"null"}]},"type":"array"},{"$ref":"#/components/schemas/FriendshipTaskData"}],"title":"Data","description":"List of user info, or task handle when count exceeds async threshold"}},"type":"object","required":["data"],"title":"GetFollowingResponse","description":"get following API response"},"GetListMembersCursorQuery":{"properties":{"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor returned by the previous page. Leave empty to fetch the first page.","examples":["1234567890"]},"list_id":{"type":"string","title":"List Id","description":"The ID of the list to get members from."}},"type":"object","required":["list_id"],"title":"GetListMembersCursorQuery"},"GetListMembersCursorResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/UserModel"},"type":"array","title":"Data","description":"A list of user objects."},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"The next cursor of the members to get.","examples":["1234567890"]}},"type":"object","required":["code","msg","data","has_next_page"],"title":"GetListMembersCursorResponse"},"GetListTweetsCursorQuery":{"properties":{"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor returned by the previous page. Leave empty to fetch the first page.","examples":["1234567890"]},"list_id":{"type":"string","title":"List Id","description":"The ID of the list to get tweets from."}},"type":"object","required":["list_id"],"title":"GetListTweetsCursorQuery"},"GetListTweetsCursorResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/TweetModel"},"type":"array","title":"Data","description":"A list of tweet objects."},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"The next cursor of the tweets to get.","examples":["1234567890"]}},"type":"object","required":["code","msg","data","has_next_page"],"title":"GetListTweetsCursorResponse"},"GetQuotesCursorQuery":{"properties":{"tweet_id":{"type":"string","title":"Tweet Id","description":"The ID of the tweet to get quote tweets for."},"sort_by":{"type":"string","enum":["Top","Latest"],"title":"Sort By","description":"Sort order for quote tweets. `Latest` for chronological order or `Top` for ranked results.","default":"Top"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor returned by the previous page. Leave empty to fetch the first page.","examples":["scroll:thGQYTMwMjU5NDA4ODc4ODc6MjU5NDA4ODc4ODc6"]}},"type":"object","required":["tweet_id"],"title":"GetQuotesCursorQuery"},"GetQuotesCursorResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/TweetModel"},"type":"array","title":"Data","description":"A list of quote tweet objects for the current page."},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Use this cursor to fetch the next page when has_next_page is true.","examples":["scroll:thGQYTMwMjU5NDA4ODc4ODc6MjU5NDA4ODc4ODc6"]}},"type":"object","required":["code","msg","data","has_next_page"],"title":"GetQuotesCursorResponse"},"GetQuotesQuery":{"properties":{"tweet_id":{"type":"string","title":"Tweet Id","description":"The ID of the tweet to get quote tweets for."},"count":{"type":"integer","maximum":5000,"minimum":1,"title":"Count","description":"Number of quote tweets to return (minimum 10, maximum 5000).","examples":[100]},"sort_by":{"type":"string","enum":["Top","Latest"],"title":"Sort By","description":"Sort order for quote tweets. `Latest` for chronological order or `Top` for ranked results.","default":"Top"}},"type":"object","required":["tweet_id","count"],"title":"GetQuotesQuery"},"GetQuotesResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/TweetModel"},"type":"array","title":"Data","description":"A list of quote tweet objects."}},"type":"object","required":["code","msg","data"],"title":"GetQuotesResponse"},"GetRepliesPageQuery":{"properties":{"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor returned by the previous page. Leave empty to fetch the first page."},"sort_by":{"type":"string","enum":["Relevance","Recency","Likes"],"title":"Sort By","description":"Sort replies by Relevance, Recency, or Likes.","default":"Recency","examples":["Recency"]}},"type":"object","title":"GetRepliesPageQuery"},"GetRepliesPageResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"root_tweet":{"anyOf":[{"$ref":"#/components/schemas/TweetModel"},{"type":"null"}],"description":"The focal tweet. Only present on the first page (when next_cursor is omitted)."},"data":{"items":{"$ref":"#/components/schemas/TweetModel"},"type":"array","title":"Data","description":"Replies on the current page."},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Use this cursor to fetch the next page when has_next_page is true."}},"type":"object","required":["data","has_next_page"],"title":"GetRepliesPageResponse"},"GetRetweetersCursorQuery":{"properties":{"tweet_id":{"type":"string","title":"Tweet Id","description":"The ID of the tweet to get retweeters for."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor returned by the previous page. Leave empty to fetch the first page.","examples":["eyJpZCI6IjIwNjAwNTE1Mzg3OTQ0Mzg2NzciLCJmbG9ja0N1cnNvciI6IjQ2MTE2ODYwMTg2Mjg5ODcxNzkiLCJvcmlnaW5hbERpcmVjdGlvbiI6IkRlc2NlbmRpbmcifQ==-999995"]}},"type":"object","required":["tweet_id"],"title":"GetRetweetersCursorQuery"},"GetRetweetersCursorResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/UserModel"},"type":"array","title":"Data","description":"A list of user objects for the current page."},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Use this cursor to fetch the next page when has_next_page is true.","examples":["eyJpZCI6IjIwNjAwNTE1Mzg3OTQ0Mzg2NzciLCJmbG9ja0N1cnNvciI6IjQ2MTE2ODYwMTg2Mjg5ODcxNzkiLCJvcmlnaW5hbERpcmVjdGlvbiI6IkRlc2NlbmRpbmcifQ==-999995"]}},"type":"object","required":["code","msg","data","has_next_page"],"title":"GetRetweetersCursorResponse"},"GetTweetsByIdResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"anyOf":[{"items":{"$ref":"#/components/schemas/TweetModel"},"type":"array"},{"type":"null"}],"title":"Data","description":"Tweet data"}},"type":"object","title":"GetTweetsByIdResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HashtagsQuery":{"properties":{"hashtags":{"items":{"type":"string"},"type":"array","title":"Hashtags","description":"Hashtag to search for (with or without # prefix)","default":[],"example":["btc","eth"]},"startTime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Starttime","description":"Start time for search in UNIX timestamp","example":"1775726400"},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endtime","description":"End time for search in UNIX timestamp","example":"1775727300"},"sortBy":{"anyOf":[{"type":"string","enum":["Latest","Top"]},{"type":"null"}],"title":"Sortby","description":"Sort order for results","default":"Latest"},"maxItems":{"anyOf":[{"type":"integer","maximum":1000,"minimum":1},{"type":"null"}],"title":"Maxitems","description":"Maximum number of tweets to return","default":20},"mininumLikes":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Mininumlikes","description":"Minimum number of likes required","default":0},"mininumRetweets":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Mininumretweets","description":"Minimum number of retweets required","default":0},"mininumReplies":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Mininumreplies","description":"Minimum number of replies required","default":0},"blueVerified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Blueverified","description":"Filter for blue verified accounts only"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified","description":"Filter for verified accounts only"},"language":{"anyOf":[{"type":"string","enum":["am","ar","bg","bn","bo","ca","ch","cs","da","de","dv","el","en","es","et","fa","fi","fr","gu","hi","ht","hu","hy","in","is","it","iu","iw","ja","ka","km","kn","ko","lo","lt","lv","ml","my","ne","nl","no","or","pa","pl","pt","ro","ru","si","sk","sl","sv","ta","te","th","tl","tr","uk","ur","vi","zh"]},{"type":"null"}],"title":"Language","description":"Language filter for tweets","example":"en"},"onlyImage":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Onlyimage","description":"Filter for images only"},"onlyVideo":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Onlyvideo","description":"Filter for videos only"},"onlyQuote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Onlyquote","description":"Filter for quotes only"},"onlyReply":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Onlyreply","description":"Filter for replies only"}},"type":"object","title":"HashtagsQuery","description":"Query parameters for searching hashtags"},"LatestFollowersResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"items":{"anyOf":[{"$ref":"#/components/schemas/UserInfo"},{"type":"null"}]},"type":"array","title":"Data","description":"List of user info"}},"type":"object","required":["data"],"title":"LatestFollowersResponse","description":"latest followers API response"},"LatestFollowingsResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"items":{"anyOf":[{"$ref":"#/components/schemas/UserInfo"},{"type":"null"}]},"type":"array","title":"Data","description":"List of user info"}},"type":"object","required":["data"],"title":"LatestFollowingsResponse","description":"latest followings API response"},"ListMembersResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/UserModel"},"type":"array","title":"Data","description":"A list of user objects."}},"type":"object","required":["code","msg","data"],"title":"ListMembersResponse"},"ListModel":{"properties":{"id":{"type":"string","title":"Id","description":"The ID of the list"},"name":{"type":"string","title":"Name","description":"The name of the list"},"description":{"type":"string","title":"Description","description":"The description of the list"},"is_private":{"type":"boolean","title":"Is Private","description":"Whether the list is private"},"member_count":{"type":"integer","title":"Member Count","description":"The number of members in the list"},"subscriber_count":{"type":"integer","title":"Subscriber Count","description":"The number of subscribers in the list"}},"type":"object","required":["id","name","description","is_private","member_count","subscriber_count"],"title":"ListModel"},"ListSubscribersResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/UserModel"},"type":"array","title":"Data","description":"A list of user objects."}},"type":"object","required":["code","msg","data"],"title":"ListSubscribersResponse"},"ListTweetsResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/TweetModel"},"type":"array","title":"Data","description":"A list of tweet objects."}},"type":"object","required":["code","msg","data"],"title":"ListTweetsResponse"},"MediaModel":{"properties":{"id":{"type":"string","title":"Id","description":"Media ID","example":"1802991873836883968"},"type":{"type":"string","title":"Type","description":"Type of media (e.g., photo, video)","example":"photo"},"display_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Url","description":"URL of the media to display","example":"pic.twitter.com/..."},"expanded_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expanded Url","description":"Expanded URL for the media"},"media_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Url","description":"Direct URL to the media file"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"t.co URL for the media"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","description":"Height of the media in pixels","example":1080},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width","description":"Width of the media in pixels","example":1920},"features":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Features","description":"Features of the media"},"original_info":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Original Info","description":"Original information about the media"},"sizes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sizes","description":"Available sizes of the media"},"source_status_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Status Id","description":"Source tweet ID if the media is a retweet"},"source_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source User Id","description":"Source user ID if the media is a retweet"},"duration_millis":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Millis","description":"Duration of the video in milliseconds"},"aspect_ratio":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Aspect Ratio","description":"Aspect ratio of the video","example":[16,9]},"video_info":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Video Info","description":"Detailed video information"},"streams":{"items":{"$ref":"#/components/schemas/StreamModel"},"type":"array","title":"Streams","description":"List of available video streams","default":[]}},"type":"object","required":["id","type"],"title":"MediaModel"},"PostTweetData":{"properties":{"tweet_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tweet Id","description":"Posted tweet ID","example":"1234567890123456789"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"User ID who posted","example":"1234567890"},"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200}},"type":"object","title":"PostTweetData","description":"Post tweet response data"},"PostTweetQuery":{"properties":{"media_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Url","description":"Single media URL: image, GIF, or video. Prefer media_urls for multiple images.","example":"https://example.com/image.jpg"},"media_urls":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":4},{"type":"null"}],"title":"Media Urls","description":"Media URLs to attach (max 4 images, or 1 GIF, or 1 video). Cannot mix GIF/video with other media.","example":["https://example.com/image1.jpg","https://example.com/image2.jpg"]},"tweet_content":{"type":"string","title":"Tweet Content","description":"Content of the tweet to post","example":"Hello, Twitter! 🐦"},"delegated_account_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delegated Account Username","description":"delegated account username","example":"elonmusk"},"schedule":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule","description":"Schedule time for the tweet in ISO format","example":"2024-01-01T12:00:00Z"},"reply_tweet_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply Tweet Id","description":"ID of tweet to reply to","example":"1234567890123456789"},"cookie":{"type":"string","title":"Cookie","description":"The user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).","example":"ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7"},"community_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Community Name","description":"Name of Twitter community to post in or community id","example":"Python Developers or 1234567890123456789"},"proxy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proxy","description":"The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port . You can get proxy from: https://app.proxy-cheap.com/r/qiMxub","example":"http://username:password@ip:port"}},"type":"object","required":["tweet_content","cookie"],"title":"PostTweetQuery","description":"Parameters for posting a tweet"},"PostTweetResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"anyOf":[{"$ref":"#/components/schemas/PostTweetData"},{"type":"null"}],"description":"Posted tweet information"}},"type":"object","title":"PostTweetResponse","description":"Post tweet API response"},"ReplyResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"anyOf":[{"$ref":"#/components/schemas/TweetModel"},{"type":"null"}],"description":"Tweet data"}},"type":"object","title":"ReplyResponse","description":"Reply response data"},"SearchCommunityQuery":{"properties":{"query":{"type":"string","title":"Query","description":"The query to search for."},"target_count":{"type":"integer","title":"Target Count","description":"The number of communities to search."}},"type":"object","required":["query","target_count"],"title":"SearchCommunityQuery"},"SearchCommunityResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/CommunityModel"},"type":"array","title":"Data","description":"A list of community objects."}},"type":"object","required":["code","msg","data"],"title":"SearchCommunityResponse"},"SearchCommunityTweetsQuery":{"properties":{"community_id":{"type":"string","title":"Community Id","description":"The ID of the community."},"target_count":{"type":"integer","title":"Target Count","description":"The number of tweets to search."},"query":{"type":"string","title":"Query","description":"The query to search for."}},"type":"object","required":["community_id","target_count","query"],"title":"SearchCommunityTweetsQuery"},"SearchListQuery":{"properties":{"query":{"type":"string","title":"Query","description":"The query to search for."},"target_count":{"type":"integer","title":"Target Count","description":"The number of lists to search."}},"type":"object","required":["query","target_count"],"title":"SearchListQuery"},"SearchListResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/ListModel"},"type":"array","title":"Data","description":"A list of list objects."}},"type":"object","required":["code","msg","data"],"title":"SearchListResponse"},"SearchQuery":{"properties":{"searchTerms":{"items":{"type":"string"},"type":"array","title":"Searchterms","description":"List of search terms to query Twitter,Visit [Advance Search TwitterXAPI](https://advance-search.pages.dev) to generate advanced search terms online.","example":["python programming","AI technology"]},"maxItems":{"type":"integer","maximum":100000,"minimum":1,"title":"Maxitems","description":"Maximum number of tweets to return","default":10,"example":50},"sortBy":{"type":"string","enum":["Latest","Top"],"title":"Sortby","description":"Sort order for results","default":"Latest","example":"Latest"}},"type":"object","required":["searchTerms"],"title":"SearchQuery","description":"Advanced Twitter search query parameters"},"SearchResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"items":{"$ref":"#/components/schemas/TweetModel"},"type":"array","title":"Data","description":"List of tweets"}},"type":"object","required":["data"],"title":"SearchResponse","description":"Search API response"},"SearchUserResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/UserModel"},"type":"array","title":"Data","description":"A list of user objects."}},"type":"object","required":["code","msg","data"],"title":"SearchUserResponse"},"SentimentAnalysisModel":{"properties":{"tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tone","description":"The tone of the text. Positive, Negative, Neutral, Humorous, Sarcastic, Enthusiastic, Angry, or Informative"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment","description":"The sentiment of the text. Positive, Negative, or Neutral"}},"type":"object","title":"SentimentAnalysisModel"},"SentimentAnalysisQuery":{"properties":{"text":{"type":"string","title":"Text","description":"The text to analyze."}},"type":"object","required":["text"],"title":"SentimentAnalysisQuery"},"SentimentAnalysisResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"$ref":"#/components/schemas/SentimentAnalysisModel","description":"The sentiment analysis model."}},"type":"object","required":["code","msg","data"],"title":"SentimentAnalysisResponse"},"StandardResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","example":200},"msg":{"type":"string","title":"Msg","description":"Response message","example":"success"},"data":{"anyOf":[{},{"type":"null"}],"title":"Data","description":"Response data"}},"type":"object","required":["code","msg"],"title":"StandardResponse","description":"Standard API response format"},"StreamModel":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of the video stream","example":"https://video.twimg.com/..."},"bitrate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bitrate","description":"Bitrate of the video stream in bps","example":832000},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type","description":"Content type of the stream","example":"video/mp4"}},"type":"object","title":"StreamModel"},"TweetModel":{"properties":{"tweet_id":{"type":"string","title":"Tweet Id","description":"The unique identifier for the Tweet","example":"1803006263529541838"},"is_paid_promotion":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Paid Promotion","description":"Indicates whether the content or user is associated with a paid promotion","default":false,"example":true},"text":{"type":"string","title":"Text","description":"The actual text content of the Tweet"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"The date and time the Tweet was created","example":"Mon Jun 17 03:51:48 +0000 2024"},"created_at_datetime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At Datetime","description":"The ISO 8601 format of the creation date","example":"2024-06-17T03:51:48.000Z"},"bookmark_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bookmark Count","description":"Number of times the Tweet has been bookmarked","default":0},"bookmarked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Bookmarked","description":"Indicates if the authenticating user has bookmarked this Tweet","default":false},"community_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Community Note","description":"Community note associated with the Tweet"},"edit_tweet_ids":{"items":{"type":"string"},"type":"array","title":"Edit Tweet Ids","description":"A list of Tweet IDs for each edit of the Tweet","default":[]},"editable_until_msecs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Editable Until Msecs","description":"Timestamp for when the Tweet is no longer editable"},"edits_remaining":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edits Remaining","description":"Number of edits remaining for the Tweet"},"favorite_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Favorite Count","description":"Number of likes (favorites) for the Tweet","default":0},"favorited":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Favorited","description":"Indicates if the authenticating user has liked this Tweet","default":false},"full_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text","description":"The full text of the Tweet, especially for extended tweets"},"has_card":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Card","description":"Indicates if the Tweet has a card attached","default":false},"has_community_notes":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Community Notes","description":"Indicates if the Tweet has community notes","default":false},"hashtags":{"items":{"type":"string"},"type":"array","title":"Hashtags","description":"A list of hashtags mentioned in the Tweet","default":[],"example":["AI","Python"]},"cashtags":{"items":{"type":"string"},"type":"array","title":"Cashtags","description":"A list of cashtags (stock symbols) mentioned in the Tweet","default":[],"example":["$TSLA"]},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","description":"The unique identifier for the Tweet (same as tweet_id)"},"in_reply_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"In Reply To","description":"ID of the Tweet this is a reply to"},"in_reply_to_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"In Reply To User Id","description":"ID of the user this is a reply to"},"in_reply_to_screen_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"In Reply To Screen Name","description":"Screen name of the user this is a reply to"},"is_edit_eligible":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Edit Eligible","description":"Indicates if the Tweet is eligible for editing","default":false},"is_quote_status":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Quote Status","description":"Indicates if this Tweet is a quote of another Tweet","default":false},"quoted_status_id_str":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quoted Status Id Str","description":"The unique identifier for the Tweet that this is a quote of"},"is_translatable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Translatable","description":"Indicates if the Tweet is translatable","default":false},"lang":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang","description":"The BCP 47 language identifier for the Tweet's content","example":"en"},"media":{"items":{"$ref":"#/components/schemas/MediaModel"},"type":"array","title":"Media","description":"A list of media objects (photos, videos) attached to the Tweet","default":[]},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place","description":"The location associated with the Tweet"},"poll":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Poll","description":"A poll attached to the Tweet"},"possibly_sensitive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Possibly Sensitive","description":"Indicates if the Tweet may contain sensitive content"},"possibly_sensitive_editable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Possibly Sensitive Editable","description":"Indicates if the sensitive content flag is editable"},"quote":{"anyOf":[{"$ref":"#/components/schemas/TweetModel"},{"type":"null"}],"description":"The Tweet object being quoted"},"quote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quote Count","description":"Number of times this Tweet has been quoted","default":0},"related_tweets":{"items":{"$ref":"#/components/schemas/TweetModel"},"type":"array","title":"Related Tweets","description":"A list of related Tweets","default":[]},"replies":{"items":{"$ref":"#/components/schemas/TweetModel"},"type":"array","title":"Replies","description":"A list of replies to this Tweet","default":[]},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reply Count","description":"Number of replies to this Tweet","default":0},"reply_to":{"anyOf":[{"$ref":"#/components/schemas/TweetModel"},{"type":"null"}],"description":"The Tweet object this is a reply to"},"retweet_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retweet Count","description":"Number of times this Tweet has been retweeted","default":0},"retweeted_tweet":{"anyOf":[{"$ref":"#/components/schemas/TweetModel"},{"type":"null"}],"description":"The original Tweet object if this is a retweet"},"thread":{"anyOf":[{"items":{"$ref":"#/components/schemas/TweetModel"},"type":"array"},{"type":"null"}],"title":"Thread","description":"The conversation thread ID"},"thumbnail_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Title","description":"Title for the thumbnail in a card"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"URL for the thumbnail in a card"},"urls":{"items":{"type":"string"},"type":"array","title":"Urls","description":"A list of URLs included in the Tweet","default":[]},"user":{"anyOf":[{"$ref":"#/components/schemas/UserModel"},{"type":"null"}],"description":"The user who posted the Tweet"},"view_count":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"View Count","description":"Number of views for the Tweet"},"view_count_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"View Count State","description":"State of the view count"},"status":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Status","description":"Raw status dictionary"},"target_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Target Count","description":"The target count of items requested, for context"}},"type":"object","required":["tweet_id","text"],"title":"TweetModel"},"TweetThreadByIdBody":{"properties":{"tweet_id":{"type":"string","title":"Tweet Id","description":"The root tweet ID to fetch the thread for"},"max_items":{"type":"integer","maximum":200,"minimum":1,"title":"Max Items","description":"Max number of thread tweets to return","default":40},"fields":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Fields","description":"Fields to include in each tweet. If omitted, all fields are returned."}},"type":"object","required":["tweet_id"],"title":"TweetThreadByIdBody"},"TwitterAccountBasedStandardResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"anyOf":[{"items":{"$ref":"#/components/schemas/TwitterUserAboutResponse"},"type":"array"},{"type":"null"}],"title":"Data","description":"Twitter Account Based in data"}},"type":"object","title":"TwitterAccountBasedStandardResponse"},"TwitterUserAboutResponse":{"properties":{"user_id":{"type":"string","title":"User Id","description":"Twitter user ID","example":"44196397"},"avatar":{"type":"string","title":"Avatar","description":"Profile avatar image URL","example":"https://pbs.twimg.com/profile_images/1983681414370619392/oTT3nm5Z_normal.jpg"},"name":{"type":"string","title":"Name","description":"User display name","example":"Elon Musk"},"screen_name":{"type":"string","title":"Screen Name","description":"Twitter username (handle)","example":"elonmusk"},"created_at":{"type":"string","title":"Created At","description":"Account creation date in Twitter format","example":"Tue Jun 02 20:12:29 +0000 2009"},"profile_image_shape":{"type":"string","title":"Profile Image Shape","description":"Profile image shape (e.g., Circle, Square)","example":"Circle"},"verification":{"type":"boolean","title":"Verification","description":"Whether the user account is verified","example":false},"userLabelDisplayType":{"type":"string","title":"Userlabeldisplaytype","description":"User label display type (e.g., Badge)","example":"Badge"},"userLabelType":{"type":"string","title":"Userlabeltype","description":"User label type (e.g., BusinessLabel)","example":"BusinessLabel"},"is_blue_verified":{"type":"boolean","title":"Is Blue Verified","description":"Whether the user has blue verification badge (Twitter Blue/X Premium)","example":true},"privacy_policy_url":{"type":"string","title":"Privacy Policy Url","description":"Privacy policy or learn more URL","example":"https://help.twitter.com/managing-your-account/about-twitter-verified-accounts"},"account_based_in":{"type":"string","title":"Account Based In","description":"Country or region where the account is based","example":"United States"},"location_accurate":{"type":"boolean","title":"Location Accurate","description":"Whether the location information is accurate","example":true},"affiliate_username":{"type":"string","title":"Affiliate Username","description":"Affiliated username (e.g., business account username)","example":"X"},"source":{"type":"string","title":"Source","description":"Source of account creation (e.g., 'United States App Store')","example":"United States App Store"},"username_changes_count":{"type":"integer","title":"Username Changes Count","description":"Number of times the username has been changed","example":0},"override_verified_year":{"type":"integer","title":"Override Verified Year","description":"Override verified year (if applicable, negative values indicate special cases)","example":-3000},"verified_since_msec":{"type":"integer","title":"Verified Since Msec","description":"Timestamp in milliseconds when the account was verified (negative values indicate special cases)","example":-156836000000000}},"type":"object","required":["user_id","avatar","name","screen_name","created_at","profile_image_shape","verification","userLabelDisplayType","userLabelType","is_blue_verified","privacy_policy_url","account_based_in","location_accurate","affiliate_username","source","username_changes_count","override_verified_year","verified_since_msec"],"title":"TwitterUserAboutResponse"},"TwitterUserAboutStandardResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"anyOf":[{"$ref":"#/components/schemas/TwitterUserAboutResponse"},{"type":"null"}],"description":"Twitter User About data"}},"type":"object","title":"TwitterUserAboutStandardResponse","description":"Twitter User About API response"},"UserInfo":{"properties":{"userId":{"type":"string","title":"Userid","description":"User ID"},"isBlueVerified":{"type":"boolean","title":"Isblueverified","description":"Blue verification status"},"createdAt":{"type":"string","title":"Createdat","description":"Account creation date"},"createdAtDatetime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Createdatdatetime","description":"Account creation datetime in ISO format"},"defaultProfile":{"type":"boolean","title":"Defaultprofile","description":"Default profile flag"},"defaultProfileImage":{"type":"boolean","title":"Defaultprofileimage","description":"Default profile image flag"},"description":{"type":"string","title":"Description","description":"Bio description"},"location":{"type":"string","title":"Location","description":"Location"},"fastFollowersCount":{"type":"integer","title":"Fastfollowerscount","description":"Fast followers count"},"favouritesCount":{"type":"integer","title":"Favouritescount","description":"Likes count"},"followersCount":{"type":"integer","title":"Followerscount","description":"Followers count"},"followingCount":{"type":"integer","title":"Followingcount","description":"Following count"},"hasCustomTimelines":{"type":"boolean","title":"Hascustomtimelines","description":"Has custom timelines flag"},"isTranslator":{"type":"boolean","title":"Istranslator","description":"Is translator flag"},"listedCount":{"type":"integer","title":"Listedcount","description":"Listed count"},"mediaCount":{"type":"integer","title":"Mediacount","description":"Media count"},"name":{"type":"string","title":"Name","description":"Display name"},"normalFollowersCount":{"type":"integer","title":"Normalfollowerscount","description":"Normal followers count"},"pinnedTweetIdsStr":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Pinnedtweetidsstr","description":"Pinned tweet IDs"},"possiblySensitive":{"type":"boolean","title":"Possiblysensitive","description":"Possibly sensitive flag"},"profileImageUrlHttps":{"type":"string","title":"Profileimageurlhttps","description":"Profile image URL"},"username":{"type":"string","title":"Username","description":"Username"},"statusesCount":{"type":"integer","title":"Statusescount","description":"Tweets count"},"translatorType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Translatortype","description":"Translator type"},"verified":{"type":"boolean","title":"Verified","description":"Legacy verification status"},"verified_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verified Type","description":"Verification badge type: blue, business, government, etc.","examples":["blue","business","government"]},"withheldInCountries":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Withheldincountries","description":"Withheld in countries"},"protected":{"type":"boolean","title":"Protected","description":"Protected account flag"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"User profile URL"},"descriptionUrls":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Descriptionurls","description":"Description URLs"},"urls":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Urls","description":"User URLs"},"pinnedTweetIds":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Pinnedtweetids","description":"Pinned tweet IDs"}},"type":"object","required":["userId","isBlueVerified","createdAt","defaultProfile","defaultProfileImage","description","location","fastFollowersCount","favouritesCount","followersCount","followingCount","hasCustomTimelines","isTranslator","listedCount","mediaCount","name","normalFollowersCount","possiblySensitive","profileImageUrlHttps","username","statusesCount","verified","protected"],"title":"UserInfo","description":"User information structure"},"UserModel":{"properties":{"id":{"type":"string","title":"Id","description":"User ID","example":"1717001045992251392"},"name":{"type":"string","title":"Name","description":"Display name","example":"Cryptoklepto"},"screen_name":{"type":"string","title":"Screen Name","description":"Twitter username","example":"CK_Cryptoklepto"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"Account creation date","example":"Mon Oct 28 02:32:47 +0000 2024"},"created_at_datetime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At Datetime","description":"Account creation datetime in ISO format","example":"2024-10-28T02:32:47.000Z"},"can_media_tag":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Can Media Tag","description":"Whether the user can be tagged in media","default":false},"default_profile":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Default Profile","description":"Whether the user has a default profile","default":false},"default_profile_image":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Default Profile Image","description":"Whether the user has a default profile image","default":false},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"User's bio description","default":""},"description_urls":{"items":{"type":"string"},"type":"array","title":"Description Urls","description":"List of URLs found in the user's description","default":[]},"urls":{"anyOf":[{"items":{"$ref":"#/components/schemas/urlModel"},"type":"array"},{"type":"null"}],"title":"Urls","description":"List of URLs found in the user's profile"},"fast_followers_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fast Followers Count","description":"Count of fast followers","default":0},"favourites_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Favourites Count","description":"Number of tweets the user has liked","default":0},"followers_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Followers Count","description":"Number of followers","default":0},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Following Count","description":"Number of users this user is following","default":0},"has_custom_timelines":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Custom Timelines","description":"Whether the user has custom timelines","default":false},"is_blue_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Blue Verified","description":"Blue verification status","default":false},"verified_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verified Type","description":"Verification badge type when not blue-only: blue, business, government, etc.","examples":["government","business","blue"]},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Verified","description":"True if the account has any verification badge (blue, business, government, or legacy verified)","default":false},"profile_image_shape":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Image Shape","description":"Profile image shape (Circle or Square; Square often indicates business/government)","examples":["Circle","Square"]},"is_translator":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Translator","description":"Whether the user is a translator","default":false},"listed_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Listed Count","description":"Number of public lists the user is a member of","default":0},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"User's location","default":"","example":"New York, USA"},"media_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Media Count","description":"Number of media tweets posted by the user","default":0},"normal_followers_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Normal Followers Count","description":"Count of normal followers","default":0},"pinned_tweet_ids":{"items":{"type":"string"},"type":"array","title":"Pinned Tweet Ids","description":"List of pinned tweet IDs","default":[]},"possibly_sensitive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Possibly Sensitive","description":"Whether the user's profile may contain sensitive content","default":false},"profile_banner_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Banner Url","description":"URL of the user's profile banner"},"profile_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Image Url","description":"URL of the user's profile image"},"protected":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Protected","description":"Whether the user's tweets are protected","default":false},"statuses_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Statuses Count","description":"Number of tweets posted by the user","default":0}},"type":"object","required":["id","name","screen_name"],"title":"UserModel"},"UserTimelineFillQuery":{"properties":{"count":{"type":"integer","maximum":1000,"minimum":1,"title":"Count","description":"Maximum number of tweets to return across all pages.","default":20,"examples":[20]}},"type":"object","title":"UserTimelineFillQuery"},"UserTimelinePageQuery":{"properties":{"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor returned by the previous page. Leave empty to fetch the first page.","examples":["DAAHCgABHFeD5h9__-cLAAIAAAATMjAzODIzMzA5NTM4ODY4MDU5NAgAAwAAAAIAAA"]},"count":{"type":"integer","maximum":100,"minimum":1,"title":"Count","description":"Maximum number of tweets to return for this page.","default":20,"examples":[20]}},"type":"object","title":"UserTimelinePageQuery"},"UserTimelinePageResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"items":{"$ref":"#/components/schemas/UserTweetItem"},"type":"array","title":"Data","description":"Current page tweet items."},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Use this cursor to fetch the next page when has_next_page is true.","examples":["DAAHCgABHFeD5h9__-cLAAIAAAATMjAzODIzMzA5NTM4ODY4MDU5NAgAAwAAAAIAAA"]},"requested_count":{"type":"integer","title":"Requested Count","description":"Original count requested by the client."},"effective_count":{"type":"integer","title":"Effective Count","description":"Count after credit throttling was applied."},"parsed_count":{"type":"integer","title":"Parsed Count","description":"Number of tweets actually parsed from the response."}},"type":"object","required":["data","has_next_page","requested_count","effective_count","parsed_count"],"title":"UserTimelinePageResponse"},"UserTimelineResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"HTTP status code","default":200},"msg":{"type":"string","title":"Msg","description":"Response message","default":"success"},"data":{"items":{"$ref":"#/components/schemas/UserTweetItem"},"type":"array","title":"Data","description":"All fetched tweets."},"total_fetched_count":{"type":"integer","title":"Total Fetched Count","description":"Total number of tweets fetched across pages."},"page_count":{"type":"integer","title":"Page Count","description":"Number of pages fetched."}},"type":"object","required":["data","total_fetched_count","page_count"],"title":"UserTimelineResponse"},"UserTweetItem":{"properties":{"tweet_id":{"type":"string","title":"Tweet Id","description":"Tweet ID"},"is_paid_promotion":{"type":"boolean","title":"Is Paid Promotion","description":"Whether the tweet is associated with a paid promotion","default":false},"full_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text","description":"Tweet text"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"Tweet creation time"},"lang":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang","description":"Tweet language"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id","description":"Conversation ID"},"bookmark_count":{"type":"integer","title":"Bookmark Count","description":"Bookmark count","default":0},"favorite_count":{"type":"integer","title":"Favorite Count","description":"Like count","default":0},"reply_count":{"type":"integer","title":"Reply Count","description":"Reply count","default":0},"retweet_count":{"type":"integer","title":"Retweet Count","description":"Retweet count","default":0},"quote_count":{"type":"integer","title":"Quote Count","description":"Quote count","default":0},"view_count":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"View Count","description":"View count"},"view_count_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"View Count State","description":"View count state"},"author_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author User Id","description":"Author user ID"},"author_screen_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Screen Name","description":"Author screen name"},"author_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Name","description":"Author display name"},"author_is_blue_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Author Is Blue Verified","description":"Blue verification flag"},"author_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Author Verified","description":"Legacy verification flag"},"author_is_verified_organization_affiliate":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Author Is Verified Organization Affiliate","description":"Verified organization affiliate flag"}},"type":"object","required":["tweet_id"],"title":"UserTweetItem"},"UsersDetailsResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"The status code of the response."},"msg":{"type":"string","title":"Msg","description":"The message of the response."},"data":{"items":{"$ref":"#/components/schemas/UserModel"},"type":"array","title":"Data","description":"A list of user objects."}},"type":"object","required":["code","msg","data"],"title":"UsersDetailsResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerifiedFollowersData":{"properties":{"users":{"items":{"$ref":"#/components/schemas/UserInfo"},"type":"array","title":"Users","description":"Follower users on this page"},"has_next_page":{"type":"boolean","title":"Has Next Page","description":"Whether another page is available"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as cursor to fetch the next page when has_next_page is true","example":"1870681402093130182|2076960004551737340"}},"type":"object","required":["users","has_next_page"],"title":"VerifiedFollowersData","description":"Followers page data (regular or verified)"},"VerifiedFollowersResponse":{"properties":{"code":{"type":"integer","title":"Code","description":"Response code","example":200},"msg":{"type":"string","title":"Msg","description":"Response message","example":"success"},"data":{"anyOf":[{"$ref":"#/components/schemas/VerifiedFollowersData"},{"type":"null"}],"description":"Followers page"}},"type":"object","required":["code","msg"],"title":"VerifiedFollowersResponse","description":"Response for followers / verified followers"},"urlModel":{"properties":{"url":{"type":"string","title":"Url","description":"URL","example":"https://www.google.com"},"expanded_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expanded Url","description":"Expanded URL","example":"https://www.google.com"},"display_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Url","description":"Display URL","example":"www.google.com"}},"type":"object","required":["url"],"title":"urlModel"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}},"externalDocs":{"description":"TwexAPI developer documentation","url":"https://docs.twexapi.io"}}