> ## Documentation Index > Fetch the complete documentation index at: https://docs.twexapi.io/llms.txt > Use this file to discover all available pages before exploring further. # Search Hashtags > 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. ## OpenAPI ````yaml /api-reference/openapi.json post /twitter/hashtags openapi: 3.1.0 info: title: Twitter API Service description: |2- A comprehensive Twitter API service that provides various Twitter operations including: * **Search Operations**: Advanced search, hashtags, cashtags * **Tweet Operations**: Post, like, retweet, quote, bookmark, delete * **User Operations**: Batch user information retrieval * **Influencer Operations**: Get tweets from top influencers All endpoints return standardized responses in the format: ```json { "code": 200, "msg": "success", "data": {...} } ``` ## Authentication This API uses Bearer token authentication. Include your token in the Authorization header: ``` Authorization: Bearer your_token_here ``` contact: name: API Support email: support@twitterxapi.com license: name: MIT version: 1.0.0 servers: - url: https://api.twexapi.io description: Development server security: [] paths: /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: [] components: schemas: 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 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 HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError 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 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 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 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_dm: anyOf: - type: boolean - type: 'null' title: Can Dm description: Whether the user can be direct messaged default: false 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 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 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 ````