x-twitter-scraper 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f77c7d16b32e28457098d4f022f31953508d3daa2c132fd88351825b689f6741
-  data.tar.gz: 5183d601d54d0a035443e1cafb2dceceb4278130a0a9674b128b39f91f6f6fca
+  metadata.gz: 9eea1f78b8204ff6a1873f23fceea72968444a55e8d0f3843f950ed4763cb33b
+  data.tar.gz: ed862a57848c9534d65e9162ccc3b777d10a1526003a3d82dbfd113ca4f41c24
 SHA512:
-  metadata.gz: 660c20843ae2f9af5cc1f8fb4a528949ff568a161b6da850cb0f25f38e12fcdc1c8880dc96b8b3313d9d9149a52fcf3e025bcdfc65b9a2fb252cadfee2acf887
-  data.tar.gz: 02cb56fce3643f7c066f819ce6f7e36c88537d67e7fb2424292af59fb5e0eb75c2536f24b5ec2528c319d5ba8d61ba42b9f6de9b3a553936a31f654207bbe510
+  metadata.gz: 7b1b7c117741251b9932dcf8cb3923c545506967c3a37c5950ca648c0f9d2c9a88c96e5634a283a7ec965a1e619c2491bf3d41cf71701a37e3755c2a7bd231de
+  data.tar.gz: de4c90cc4b7451f1ee3c09326617c5f3a688d71dcfe3f86429a3b8dea0ba45a93523647db2243682f89cef16e0892c05a2f59de49797585fe016416baa3e9c18

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.7.0 (2026-07-31)
+
+Full Changelog: [v0.6.1...v0.7.0](https://github.com/Xquik-dev/x-twitter-scraper-ruby/compare/v0.6.1...v0.7.0)
+
+### Features
+
+* **api:** add complete reply extraction, rich response contracts, and compatible typed account outcomes ([#28](https://github.com/Xquik-dev/x-twitter-scraper-ruby/pull/28)) ([f638d05](https://github.com/Xquik-dev/x-twitter-scraper-ruby/commit/f638d05a1a633c223f2683a64abc1dbab233af6a))
+
+## 0.6.1 (2026-07-30)
+
+Full Changelog: [v0.6.0...v0.6.1](https://github.com/Xquik-dev/x-twitter-scraper-ruby/compare/v0.6.0...v0.6.1)
+
 ## 0.6.0 (2026-07-29)
 
 Full Changelog: [v0.5.7...v0.6.0](https://github.com/Xquik-dev/x-twitter-scraper-ruby/compare/v0.5.7...v0.6.0)

data/README.md

@@ -35,7 +35,7 @@ Add the gem to your `Gemfile`:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "x-twitter-scraper", "~> 0.6.0"
+gem "x-twitter-scraper", "~> 0.7.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/x_twitter_scraper/internal/type/union.rb

@@ -10,16 +10,32 @@ module XTwitterScraper
       # @api private
       #
       # @example
-      #   # `compose_create_response` is a `XTwitterScraper::Models::ComposeCreateResponse`
-      #   case compose_create_response
-      #   when XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult
-      #     puts(compose_create_response.content_rules)
-      #   when XTwitterScraper::Models::ComposeCreateResponse::ComposeRefineResult
-      #     puts(compose_create_response.composition_guidance)
-      #   when XTwitterScraper::Models::ComposeCreateResponse::ComposeScoreResult
-      #     puts(compose_create_response.checklist)
+      #   # `account_connection_attempt_retrieve_response` is a `XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse`
+      #   case account_connection_attempt_retrieve_response
+      #   when XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::Pending
+      #     puts(account_connection_attempt_retrieve_response.id)
+      #   when XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::Success
+      #     puts(account_connection_attempt_retrieve_response.object)
+      #   when XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::Failed
+      #     puts(account_connection_attempt_retrieve_response.error)
+      #   when XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::RequiresEmailCode
+      #     puts(account_connection_attempt_retrieve_response.message)
       #   else
-      #     puts(compose_create_response)
+      #     puts(account_connection_attempt_retrieve_response)
+      #   end
+      #
+      # @example
+      #   case account_connection_attempt_retrieve_response
+      #   in {status: :pending, id: id, object: object, poll_after_ms: poll_after_ms}
+      #     puts(id)
+      #   in {status: :success, id: id, object: object}
+      #     puts(object)
+      #   in {status: :failed, id: id, error: error, object: object}
+      #     puts(error)
+      #   in {status: :requires_email_code, id: id, message: message}
+      #     puts(message)
+      #   else
+      #     puts(account_connection_attempt_retrieve_response)
       #   end
       module Union
         include XTwitterScraper::Internal::Type::Converter

data/lib/x_twitter_scraper/models/content_disclosure.rb

@@ -38,12 +38,6 @@ module XTwitterScraper
 
       # @see XTwitterScraper::Models::ContentDisclosure#ai_generated
       class AIGenerated < XTwitterScraper::Internal::Type::BaseModel
-        # @!attribute can_edit
-        #   Whether the disclosure can be edited on X.
-        #
-        #   @return [Boolean, nil]
-        optional :can_edit, XTwitterScraper::Internal::Type::Boolean, api_name: :canEdit
-
         # @!attribute detection_source
         #   Source of the AI-generated media disclosure.
         #
@@ -58,9 +52,7 @@ module XTwitterScraper
                  XTwitterScraper::Internal::Type::Boolean,
                  api_name: :hasAiGeneratedMedia
 
-        # @!method initialize(can_edit: nil, detection_source: nil, has_ai_generated_media: nil)
-        #   @param can_edit [Boolean] Whether the disclosure can be edited on X.
-        #
+        # @!method initialize(detection_source: nil, has_ai_generated_media: nil)
         #   @param detection_source [String] Source of the AI-generated media disclosure.
         #
         #   @param has_ai_generated_media [Boolean] True when X labels the tweet as containing AI-generated media.

data/lib/x_twitter_scraper/models/embedded_tweet.rb

@@ -47,12 +47,30 @@ module XTwitterScraper
       #   @return [Integer]
       required :view_count, Integer, api_name: :viewCount
 
+      # @!attribute article
+      #   Article metadata attached to a tweet.
+      #
+      #   @return [XTwitterScraper::Models::EmbeddedTweet::Article, nil]
+      optional :article, -> { XTwitterScraper::EmbeddedTweet::Article }
+
       # @!attribute author
       #   X user profile with bio, follower counts, and verification status.
       #
       #   @return [XTwitterScraper::Models::UserProfile, nil]
       optional :author, -> { XTwitterScraper::UserProfile }
 
+      # @!attribute card
+      #   Public card metadata attached to a tweet.
+      #
+      #   @return [XTwitterScraper::Models::EmbeddedTweet::Card, nil]
+      optional :card, -> { XTwitterScraper::EmbeddedTweet::Card }
+
+      # @!attribute community_note
+      #   Community Note presentation metadata returned by X.
+      #
+      #   @return [XTwitterScraper::Models::EmbeddedTweet::CommunityNote, nil]
+      optional :community_note, -> { XTwitterScraper::EmbeddedTweet::CommunityNote }, api_name: :communityNote
+
       # @!attribute content_disclosure
       #   Content disclosure metadata shown by X when a tweet is labeled as paid
       #   partnership content or AI-generated media.
@@ -77,6 +95,12 @@ module XTwitterScraper
                XTwitterScraper::Internal::Type::ArrayOf[Integer],
                api_name: :displayTextRange
 
+      # @!attribute edit
+      #   Edit history metadata returned by X.
+      #
+      #   @return [XTwitterScraper::Models::EmbeddedTweet::Edit, nil]
+      optional :edit, -> { XTwitterScraper::EmbeddedTweet::Edit }
+
       # @!attribute entities
       #
       #   @return [Hash{Symbol=>Object}, nil]
@@ -117,6 +141,11 @@ module XTwitterScraper
       #   @return [Boolean, nil]
       optional :is_reply, XTwitterScraper::Internal::Type::Boolean, api_name: :isReply
 
+      # @!attribute is_translatable
+      #
+      #   @return [Boolean, nil]
+      optional :is_translatable, XTwitterScraper::Internal::Type::Boolean, api_name: :isTranslatable
+
       # @!attribute lang
       #
       #   @return [String, nil]
@@ -127,6 +156,47 @@ module XTwitterScraper
       #   @return [Array<XTwitterScraper::Models::TweetMedia>, nil]
       optional :media, -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::TweetMedia] }
 
+      # @!attribute note_tweet
+      #   Complete Note Tweet content and rich-text metadata.
+      #
+      #   @return [XTwitterScraper::Models::EmbeddedTweet::NoteTweet, nil]
+      optional :note_tweet, -> { XTwitterScraper::EmbeddedTweet::NoteTweet }, api_name: :noteTweet
+
+      # @!attribute place
+      #   Public place metadata attached to a tweet.
+      #
+      #   @return [XTwitterScraper::Models::EmbeddedTweet::Place, nil]
+      optional :place, -> { XTwitterScraper::EmbeddedTweet::Place }
+
+      # @!attribute possibly_sensitive
+      #
+      #   @return [Boolean, nil]
+      optional :possibly_sensitive, XTwitterScraper::Internal::Type::Boolean, api_name: :possiblySensitive
+
+      # @!attribute previous_counts
+      #   Engagement counts retained from a prior tweet edit.
+      #
+      #   @return [XTwitterScraper::Models::EmbeddedTweet::PreviousCounts, nil]
+      optional :previous_counts,
+               -> { XTwitterScraper::EmbeddedTweet::PreviousCounts },
+               api_name: :previousCounts
+
+      # @!attribute quoted_tweet
+      #   Quoted or retweeted tweet context. Every object includes id, text, and
+      #   engagement metrics. A zero metric can mean X did not report the count. Author,
+      #   media, and conversation fields appear when available.
+      #
+      #   @return [XTwitterScraper::Models::EmbeddedTweet, nil]
+      optional :quoted_tweet, -> { XTwitterScraper::EmbeddedTweet }
+
+      # @!attribute retweeted_tweet
+      #   Quoted or retweeted tweet context. Every object includes id, text, and
+      #   engagement metrics. A zero metric can mean X did not report the count. Author,
+      #   media, and conversation fields appear when available.
+      #
+      #   @return [XTwitterScraper::Models::EmbeddedTweet, nil]
+      optional :retweeted_tweet, -> { XTwitterScraper::EmbeddedTweet }
+
       # @!attribute source
       #
       #   @return [String, nil]
@@ -142,7 +212,12 @@ module XTwitterScraper
       #   @return [String, nil]
       optional :url, String
 
-      # @!method initialize(id:, bookmark_count:, like_count:, quote_count:, reply_count:, retweet_count:, text:, view_count:, author: nil, content_disclosure: nil, conversation_id: nil, created_at: nil, display_text_range: nil, entities: nil, in_reply_to_id: nil, in_reply_to_user_id: nil, in_reply_to_username: nil, is_limited_reply: nil, is_note_tweet: nil, is_quote_status: nil, is_reply: nil, lang: nil, media: nil, source: nil, type: nil, url: nil)
+      # @!attribute view_state
+      #
+      #   @return [String, nil]
+      optional :view_state, String, api_name: :viewState
+
+      # @!method initialize(id:, bookmark_count:, like_count:, quote_count:, reply_count:, retweet_count:, text:, view_count:, article: nil, author: nil, card: nil, community_note: nil, content_disclosure: nil, conversation_id: nil, created_at: nil, display_text_range: nil, edit: nil, entities: nil, in_reply_to_id: nil, in_reply_to_user_id: nil, in_reply_to_username: nil, is_limited_reply: nil, is_note_tweet: nil, is_quote_status: nil, is_reply: nil, is_translatable: nil, lang: nil, media: nil, note_tweet: nil, place: nil, possibly_sensitive: nil, previous_counts: nil, quoted_tweet: nil, retweeted_tweet: nil, source: nil, type: nil, url: nil, view_state: nil)
       #   Some parameter documentations has been truncated, see
       #   {XTwitterScraper::Models::EmbeddedTweet} for more details.
       #
@@ -166,8 +241,14 @@ module XTwitterScraper
       #
       #   @param view_count [Integer]
       #
+      #   @param article [XTwitterScraper::Models::EmbeddedTweet::Article] Article metadata attached to a tweet.
+      #
       #   @param author [XTwitterScraper::Models::UserProfile] X user profile with bio, follower counts, and verification status.
       #
+      #   @param card [XTwitterScraper::Models::EmbeddedTweet::Card] Public card metadata attached to a tweet.
+      #
+      #   @param community_note [XTwitterScraper::Models::EmbeddedTweet::CommunityNote] Community Note presentation metadata returned by X.
+      #
       #   @param content_disclosure [XTwitterScraper::Models::ContentDisclosure] Content disclosure metadata shown by X when a tweet is labeled as paid partnersh
       #
       #   @param conversation_id [String]
@@ -176,6 +257,8 @@ module XTwitterScraper
       #
       #   @param display_text_range [Array<Integer>]
       #
+      #   @param edit [XTwitterScraper::Models::EmbeddedTweet::Edit] Edit history metadata returned by X.
+      #
       #   @param entities [Hash{Symbol=>Object}]
       #
       #   @param in_reply_to_id [String]
@@ -192,15 +275,320 @@ module XTwitterScraper
       #
       #   @param is_reply [Boolean]
       #
+      #   @param is_translatable [Boolean]
+      #
       #   @param lang [String]
       #
       #   @param media [Array<XTwitterScraper::Models::TweetMedia>]
       #
+      #   @param note_tweet [XTwitterScraper::Models::EmbeddedTweet::NoteTweet] Complete Note Tweet content and rich-text metadata.
+      #
+      #   @param place [XTwitterScraper::Models::EmbeddedTweet::Place] Public place metadata attached to a tweet.
+      #
+      #   @param possibly_sensitive [Boolean]
+      #
+      #   @param previous_counts [XTwitterScraper::Models::EmbeddedTweet::PreviousCounts] Engagement counts retained from a prior tweet edit.
+      #
+      #   @param quoted_tweet [XTwitterScraper::Models::EmbeddedTweet] Quoted or retweeted tweet context. Every object includes id, text, and engagemen
+      #
+      #   @param retweeted_tweet [XTwitterScraper::Models::EmbeddedTweet] Quoted or retweeted tweet context. Every object includes id, text, and engagemen
+      #
       #   @param source [String]
       #
       #   @param type [String]
       #
       #   @param url [String]
+      #
+      #   @param view_state [String]
+
+      # @see XTwitterScraper::Models::EmbeddedTweet#article
+      class Article < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute cover_media_url
+        #
+        #   @return [String, nil]
+        optional :cover_media_url, String, api_name: :coverMediaUrl
+
+        # @!attribute preview_text
+        #
+        #   @return [String, nil]
+        optional :preview_text, String, api_name: :previewText
+
+        # @!attribute title
+        #
+        #   @return [String, nil]
+        optional :title, String
+
+        # @!method initialize(id: nil, cover_media_url: nil, preview_text: nil, title: nil)
+        #   Article metadata attached to a tweet.
+        #
+        #   @param id [String]
+        #   @param cover_media_url [String]
+        #   @param preview_text [String]
+        #   @param title [String]
+      end
+
+      # @see XTwitterScraper::Models::EmbeddedTweet#card
+      class Card < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute binding_values
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :binding_values,
+                 XTwitterScraper::Internal::Type::HashOf[XTwitterScraper::Internal::Type::Unknown],
+                 api_name: :bindingValues
+
+        # @!attribute name
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!attribute url
+        #
+        #   @return [String, nil]
+        optional :url, String
+
+        # @!method initialize(id: nil, binding_values: nil, name: nil, url: nil)
+        #   Public card metadata attached to a tweet.
+        #
+        #   @param id [String]
+        #   @param binding_values [Hash{Symbol=>Object}]
+        #   @param name [String]
+        #   @param url [String]
+      end
+
+      # @see XTwitterScraper::Models::EmbeddedTweet#community_note
+      class CommunityNote < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute destination_url
+        #
+        #   @return [String, nil]
+        optional :destination_url, String, api_name: :destinationUrl
+
+        # @!attribute footer
+        #
+        #   @return [String, nil]
+        optional :footer, String
+
+        # @!attribute short_title
+        #
+        #   @return [String, nil]
+        optional :short_title, String, api_name: :shortTitle
+
+        # @!attribute subtitle
+        #
+        #   @return [String, nil]
+        optional :subtitle, String
+
+        # @!attribute title
+        #
+        #   @return [String, nil]
+        optional :title, String
+
+        # @!attribute visual_style
+        #
+        #   @return [String, nil]
+        optional :visual_style, String, api_name: :visualStyle
+
+        # @!method initialize(id: nil, destination_url: nil, footer: nil, short_title: nil, subtitle: nil, title: nil, visual_style: nil)
+        #   Community Note presentation metadata returned by X.
+        #
+        #   @param id [String]
+        #   @param destination_url [String]
+        #   @param footer [String]
+        #   @param short_title [String]
+        #   @param subtitle [String]
+        #   @param title [String]
+        #   @param visual_style [String]
+      end
+
+      # @see XTwitterScraper::Models::EmbeddedTweet#edit
+      class Edit < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute editable_until_msecs
+        #
+        #   @return [String, nil]
+        optional :editable_until_msecs, String, api_name: :editableUntilMsecs
+
+        # @!attribute edit_tweet_ids
+        #
+        #   @return [Array<String>, nil]
+        optional :edit_tweet_ids, XTwitterScraper::Internal::Type::ArrayOf[String], api_name: :editTweetIds
+
+        # @!method initialize(editable_until_msecs: nil, edit_tweet_ids: nil)
+        #   Edit history metadata returned by X.
+        #
+        #   @param editable_until_msecs [String]
+        #   @param edit_tweet_ids [Array<String>]
+      end
+
+      # @see XTwitterScraper::Models::EmbeddedTweet#note_tweet
+      class NoteTweet < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute text
+        #
+        #   @return [String]
+        required :text, String
+
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute entities
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :entities, XTwitterScraper::Internal::Type::HashOf[XTwitterScraper::Internal::Type::Unknown]
+
+        # @!attribute is_expandable
+        #
+        #   @return [Boolean, nil]
+        optional :is_expandable, XTwitterScraper::Internal::Type::Boolean, api_name: :isExpandable
+
+        # @!attribute richtext_tags
+        #
+        #   @return [Array<XTwitterScraper::Models::EmbeddedTweet::NoteTweet::RichtextTag>, nil]
+        optional :richtext_tags,
+                 -> {
+                   XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::EmbeddedTweet::NoteTweet::RichtextTag]
+                 },
+                 api_name: :richtextTags
+
+        # @!method initialize(text:, id: nil, entities: nil, is_expandable: nil, richtext_tags: nil)
+        #   Complete Note Tweet content and rich-text metadata.
+        #
+        #   @param text [String]
+        #   @param id [String]
+        #   @param entities [Hash{Symbol=>Object}]
+        #   @param is_expandable [Boolean]
+        #   @param richtext_tags [Array<XTwitterScraper::Models::EmbeddedTweet::NoteTweet::RichtextTag>]
+
+        class RichtextTag < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute from_index
+          #
+          #   @return [Integer]
+          required :from_index, Integer, api_name: :fromIndex
+
+          # @!attribute to_index
+          #
+          #   @return [Integer]
+          required :to_index, Integer, api_name: :toIndex
+
+          # @!attribute types
+          #
+          #   @return [Array<String>]
+          required :types, XTwitterScraper::Internal::Type::ArrayOf[String]
+
+          # @!method initialize(from_index:, to_index:, types:)
+          #   @param from_index [Integer]
+          #   @param to_index [Integer]
+          #   @param types [Array<String>]
+        end
+      end
+
+      # @see XTwitterScraper::Models::EmbeddedTweet#place
+      class Place < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute bounding_box
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :bounding_box,
+                 XTwitterScraper::Internal::Type::HashOf[XTwitterScraper::Internal::Type::Unknown],
+                 api_name: :boundingBox
+
+        # @!attribute country
+        #
+        #   @return [String, nil]
+        optional :country, String
+
+        # @!attribute country_code
+        #
+        #   @return [String, nil]
+        optional :country_code, String, api_name: :countryCode
+
+        # @!attribute full_name
+        #
+        #   @return [String, nil]
+        optional :full_name, String, api_name: :fullName
+
+        # @!attribute name
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!attribute place_type
+        #
+        #   @return [String, nil]
+        optional :place_type, String, api_name: :placeType
+
+        # @!attribute url
+        #
+        #   @return [String, nil]
+        optional :url, String
+
+        # @!method initialize(id: nil, bounding_box: nil, country: nil, country_code: nil, full_name: nil, name: nil, place_type: nil, url: nil)
+        #   Public place metadata attached to a tweet.
+        #
+        #   @param id [String]
+        #   @param bounding_box [Hash{Symbol=>Object}]
+        #   @param country [String]
+        #   @param country_code [String]
+        #   @param full_name [String]
+        #   @param name [String]
+        #   @param place_type [String]
+        #   @param url [String]
+      end
+
+      # @see XTwitterScraper::Models::EmbeddedTweet#previous_counts
+      class PreviousCounts < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute bookmark_count
+        #
+        #   @return [Integer, nil]
+        optional :bookmark_count, Integer, api_name: :bookmarkCount
+
+        # @!attribute like_count
+        #
+        #   @return [Integer, nil]
+        optional :like_count, Integer, api_name: :likeCount
+
+        # @!attribute quote_count
+        #
+        #   @return [Integer, nil]
+        optional :quote_count, Integer, api_name: :quoteCount
+
+        # @!attribute reply_count
+        #
+        #   @return [Integer, nil]
+        optional :reply_count, Integer, api_name: :replyCount
+
+        # @!attribute retweet_count
+        #
+        #   @return [Integer, nil]
+        optional :retweet_count, Integer, api_name: :retweetCount
+
+        # @!method initialize(bookmark_count: nil, like_count: nil, quote_count: nil, reply_count: nil, retweet_count: nil)
+        #   Engagement counts retained from a prior tweet edit.
+        #
+        #   @param bookmark_count [Integer]
+        #   @param like_count [Integer]
+        #   @param quote_count [Integer]
+        #   @param reply_count [Integer]
+        #   @param retweet_count [Integer]
+      end
     end
   end
 end

data/lib/x_twitter_scraper/models/paginated_tweets.rb

@@ -23,11 +23,10 @@ module XTwitterScraper
       required :tweets, -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::SearchTweet] }
 
       # @!method initialize(has_next_page:, next_cursor:, tweets:)
-      #   Paginated tweet results. The item count can be lower than pageSize when the
-      #   source returns fewer tweets, filters remove tweets, or remaining credits cover
-      #   fewer results. Follow next_cursor while has_next_page is true. An empty page can
-      #   still have has_next_page true after filtering. Zero affordable results returns
-      #   402 insufficient_credits.
+      #   Paginated tweets. Source visibility, filters, or remaining credits can reduce
+      #   results. An empty filtered page can still have has_next_page true. Follow
+      #   next_cursor while has_next_page is true. Zero affordable results returns 402
+      #   insufficient_credits.
       #
       #   @param has_next_page [Boolean]
       #   @param next_cursor [String]