Class: XTwitterScraper::Models::X::TweetSearchParams

Inherits:
Internal::Type::BaseModel show all
Extended by:
Internal::Type::RequestParameters::Converter
Includes:
Internal::Type::RequestParameters
Defined in:
lib/x_twitter_scraper/models/x/tweet_search_params.rb,
sig/x_twitter_scraper/models/x/tweet_search_params.rbs

Overview

See Also:

  • XTwitterScraper::Resources::X::Tweets#search

Defined Under Namespace

Modules: MediaType, QueryType, Quotes, Replies, Retweets

Constant Summary

Constants included from Internal::Type::RequestParameters

Internal::Type::RequestParameters::XTwitterScraper

Instance Attribute Summary collapse

Attributes included from Internal::Type::RequestParameters

#request_options

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Internal::Type::RequestParameters::Converter

dump_request

Methods included from Internal::Type::RequestParameters

included

Methods inherited from Internal::Type::BaseModel

==, #==, #[], coerce, #deconstruct_keys, #deep_to_h, dump, fields, hash, #hash, inherited, inspect, #inspect, known_fields, optional, recursively_to_h, required, #to_h, #to_json, #to_s, to_sorbet_type, #to_yaml

Methods included from Internal::Type::Converter

#coerce, coerce, #dump, dump, #inspect, inspect, meta_info, new_coerce_state, type_info

Methods included from Internal::Util::SorbetRuntimeSupport

#const_missing, #define_sorbet_constant!, #sorbet_constant_defined?, #to_sorbet_type, to_sorbet_type

Constructor Details

#initialize(q:, advanced_query: nil, any_words: nil, bounding_box: nil, cashtags: nil, conversation_id: nil, cursor: nil, exact_phrase: nil, exclude_words: nil, from_user: nil, hashtags: nil, in_reply_to_tweet_id: nil, language: nil, limit: nil, list_id: nil, media_type: nil, mentioning: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, place: nil, place_country: nil, point_radius: nil, query_type: nil, quotes: nil, quotes_of_tweet_id: nil, replies: nil, retweets: nil, retweets_of_tweet_id: nil, since_date: nil, since_time: nil, to_user: nil, until_date: nil, until_time: nil, url: nil, verified_only: nil, request_options: {}) ⇒ Object

Some parameter documentations has been truncated, see XTwitterScraper::Models::X::TweetSearchParams for more details.

Parameters:

  • q (String) —

    Search query (keywords,

  • advanced_query (String) (defaults to: nil) —

    Raw advanced search query appended as-is.

  • any_words (String) (defaults to: nil) —

    Words or quoted phrases where any one can match. Separate with spaces, commas, o

  • bounding_box (String) (defaults to: nil) —

    Geo bounding box, e.g. -74.1 40.6 -73.9 40.8.

  • cashtags (String) (defaults to: nil) —

    Cashtags separated by spaces, commas, or lines.

  • conversation_id (String) (defaults to: nil) —

    Conversation ID filter.

  • cursor (String) (defaults to: nil) —

    Pagination cursor from previous response

  • exact_phrase (String) (defaults to: nil) —

    Exact phrase to match.

  • exclude_words (String) (defaults to: nil) —

    Words or quoted phrases to exclude. Separate with spaces, commas, or lines.

  • from_user (String) (defaults to: nil) —

    Filter by author username.

  • hashtags (String) (defaults to: nil) —

    Hashtags separated by spaces, commas, or lines.

  • in_reply_to_tweet_id (String) (defaults to: nil) —

    Only replies to this tweet ID.

  • language (String) (defaults to: nil) —

    Language code filter, e.g. en or tr.

  • limit (Integer) (defaults to: nil) —

    Max tweets to return (server paginates internally). Omit for single page (~20).

  • list_id (String) (defaults to: nil) —

    Search within a list ID.

  • media_type (Symbol, XTwitterScraper::Models::X::TweetSearchParams::MediaType) (defaults to: nil) —

    Filter by media type.

  • mentioning (String) (defaults to: nil) —

    Filter tweets mentioning a username.

  • min_faves (Integer) (defaults to: nil) —

    Minimum likes threshold.

  • min_quotes (Integer) (defaults to: nil) —

    Minimum quote count threshold.

  • min_replies (Integer) (defaults to: nil) —

    Minimum replies threshold.

  • min_retweets (Integer) (defaults to: nil) —

    Minimum retweets threshold.

  • place (String) (defaults to: nil) —

    Search within a place ID.

  • place_country (String) (defaults to: nil) —

    Search within a country code.

  • point_radius (String) (defaults to: nil) —

    Geo point radius, e.g. -73.99 40.73 25mi.

  • query_type (Symbol, XTwitterScraper::Models::X::TweetSearchParams::QueryType) (defaults to: nil) —

    Sort order - Latest (chronological) or Top (engagement-ranked)

  • quotes (Symbol, XTwitterScraper::Models::X::TweetSearchParams::Quotes) (defaults to: nil) —

    Quote mode.

  • quotes_of_tweet_id (String) (defaults to: nil) —

    Only quotes of this tweet ID.

  • replies (Symbol, XTwitterScraper::Models::X::TweetSearchParams::Replies) (defaults to: nil) —

    Reply mode.

  • retweets (Symbol, XTwitterScraper::Models::X::TweetSearchParams::Retweets) (defaults to: nil) —

    Retweet mode.

  • retweets_of_tweet_id (String) (defaults to: nil) —

    Only retweets of this tweet ID.

  • since_date (Date) (defaults to: nil) —

    Start date in YYYY-MM-DD format.

  • since_time (String) (defaults to: nil) —

    ISO 8601 timestamp - only return tweets after this time

  • to_user (String) (defaults to: nil) —

    Filter replies sent to a username.

  • until_date (Date) (defaults to: nil) —

    End date in YYYY-MM-DD format.

  • until_time (String) (defaults to: nil) —

    ISO 8601 timestamp - only return tweets before this time

  • url (String) (defaults to: nil) —

    URL substring or domain filter.

  • verified_only (Boolean) (defaults to: nil) —

    Only return tweets from verified authors.

  • request_options (XTwitterScraper::RequestOptions, Hash{Symbol=>Object}) (defaults to: {}) 



# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 237

Instance Attribute Details

#advanced_query ⇒ String?

Raw advanced search query appended as-is.

Parameters:

  • (String)

Returns:

  • (String, nil) 


21
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 21

optional :advanced_query, String

#any_words ⇒ String?

Words or quoted phrases where any one can match. Separate with spaces, commas, or lines.

Parameters:

  • (String)

Returns:

  • (String, nil) 


28
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 28

optional :any_words, String

#bounding_box ⇒ String?

Geo bounding box, e.g. -74.1 40.6 -73.9 40.8.

Parameters:

  • (String)

Returns:

  • (String, nil) 


34
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 34

optional :bounding_box, String

#cashtags ⇒ String?

Cashtags separated by spaces, commas, or lines.

Parameters:

  • (String)

Returns:

  • (String, nil) 


40
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 40

optional :cashtags, String

#conversation_id ⇒ String?

Conversation ID filter.

Parameters:

  • (String)

Returns:

  • (String, nil) 


46
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 46

optional :conversation_id, String

#cursor ⇒ String?

Pagination cursor from previous response

Parameters:

  • (String)

Returns:

  • (String, nil) 


52
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 52

optional :cursor, String

#exact_phrase ⇒ String?

Exact phrase to match.

Parameters:

  • (String)

Returns:

  • (String, nil) 


58
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 58

optional :exact_phrase, String

#exclude_words ⇒ String?

Words or quoted phrases to exclude. Separate with spaces, commas, or lines.

Parameters:

  • (String)

Returns:

  • (String, nil) 


64
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 64

optional :exclude_words, String

#from_user ⇒ String?

Filter by author username.

Parameters:

  • (String)

Returns:

  • (String, nil) 


70
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 70

optional :from_user, String

#hashtags ⇒ String?

Hashtags separated by spaces, commas, or lines.

Parameters:

  • (String)

Returns:

  • (String, nil) 


76
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 76

optional :hashtags, String

#in_reply_to_tweet_id ⇒ String?

Only replies to this tweet ID.

Parameters:

  • (String)

Returns:

  • (String, nil) 


82
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 82

optional :in_reply_to_tweet_id, String

#language ⇒ String?

Language code filter, e.g. en or tr.

Parameters:

  • (String)

Returns:

  • (String, nil) 


88
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 88

optional :language, String

#limit ⇒ Integer?

Max tweets to return (server paginates internally). Omit for single page (~20). This is an upper bound for paid authenticated calls: remaining credits can reduce the returned page size, and zero affordable results returns 402 insufficient_credits.

Parameters:

  • (Integer)

Returns:

  • (Integer, nil) 


97
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 97

optional :limit, Integer

#list_id ⇒ String?

Search within a list ID.

Parameters:

  • (String)

Returns:

  • (String, nil) 


103
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 103

optional :list_id, String

#media_type ⇒ Symbol, ...

Filter by media type.

Returns:



109
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 109

optional :media_type, enum: -> { XTwitterScraper::X::TweetSearchParams::MediaType }

#mentioning ⇒ String?

Filter tweets mentioning a username.

Parameters:

  • (String)

Returns:

  • (String, nil) 


115
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 115

optional :mentioning, String

#min_faves ⇒ Integer?

Minimum likes threshold.

Parameters:

  • (Integer)

Returns:

  • (Integer, nil) 


121
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 121

optional :min_faves, Integer

#min_quotes ⇒ Integer?

Minimum quote count threshold.

Parameters:

  • (Integer)

Returns:

  • (Integer, nil) 


127
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 127

optional :min_quotes, Integer

#min_replies ⇒ Integer?

Minimum replies threshold.

Parameters:

  • (Integer)

Returns:

  • (Integer, nil) 


133
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 133

optional :min_replies, Integer

#min_retweets ⇒ Integer?

Minimum retweets threshold.

Parameters:

  • (Integer)

Returns:

  • (Integer, nil) 


139
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 139

optional :min_retweets, Integer

#place ⇒ String?

Search within a place ID.

Parameters:

  • (String)

Returns:

  • (String, nil) 


145
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 145

optional :place, String

#place_country ⇒ String?

Search within a country code.

Parameters:

  • (String)

Returns:

  • (String, nil) 


151
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 151

optional :place_country, String

#point_radius ⇒ String?

Geo point radius, e.g. -73.99 40.73 25mi.

Parameters:

  • (String)

Returns:

  • (String, nil) 


157
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 157

optional :point_radius, String

#q ⇒ String

Search query (keywords,

Parameters:

  • value (String)

Returns:

  • (String) 


15
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 15

required :q, String

#query_type ⇒ Symbol, ...

Sort order - Latest (chronological) or Top (engagement-ranked)

Returns:



163
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 163

optional :query_type, enum: -> { XTwitterScraper::X::TweetSearchParams::QueryType }

#quotes ⇒ Symbol, ...

Quote mode.

Returns:



169
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 169

optional :quotes, enum: -> { XTwitterScraper::X::TweetSearchParams::Quotes }

#quotes_of_tweet_id ⇒ String?

Only quotes of this tweet ID.

Parameters:

  • (String)

Returns:

  • (String, nil) 


175
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 175

optional :quotes_of_tweet_id, String

#replies ⇒ Symbol, ...

Reply mode.

Returns:



181
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 181

optional :replies, enum: -> { XTwitterScraper::X::TweetSearchParams::Replies }

#retweets ⇒ Symbol, ...

Retweet mode.

Returns:



187
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 187

optional :retweets, enum: -> { XTwitterScraper::X::TweetSearchParams::Retweets }

#retweets_of_tweet_id ⇒ String?

Only retweets of this tweet ID.

Parameters:

  • (String)

Returns:

  • (String, nil) 


193
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 193

optional :retweets_of_tweet_id, String

#since_date ⇒ Date?

Start date in YYYY-MM-DD format.

Parameters:

  • (Date)

Returns:

  • (Date, nil) 


199
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 199

optional :since_date, Date

#since_time ⇒ String?

ISO 8601 timestamp - only return tweets after this time

Parameters:

  • (String)

Returns:

  • (String, nil) 


205
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 205

optional :since_time, String

#to_user ⇒ String?

Filter replies sent to a username.

Parameters:

  • (String)

Returns:

  • (String, nil) 


211
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 211

optional :to_user, String

#until_date ⇒ Date?

End date in YYYY-MM-DD format.

Parameters:

  • (Date)

Returns:

  • (Date, nil) 


217
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 217

optional :until_date, Date

#until_time ⇒ String?

ISO 8601 timestamp - only return tweets before this time

Parameters:

  • (String)

Returns:

  • (String, nil) 


223
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 223

optional :until_time, String

#url ⇒ String?

URL substring or domain filter.

Parameters:

  • (String)

Returns:

  • (String, nil) 


229
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 229

optional :url, String

#verified_only ⇒ Boolean?

Only return tweets from verified authors.

Parameters:

  • (Boolean)

Returns:

  • (Boolean, nil) 


235
 
# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 235

optional :verified_only, XTwitterScraper::Internal::Type::Boolean

Class Method Details

.values ⇒ Array<Symbol>

Returns:

  • (Array<Symbol>) 



# File 'lib/x_twitter_scraper/models/x/tweet_search_params.rb', line 328

Instance Method Details

#to_hash ⇒ {

Returns:

  • ({) 


247
 
# File 'sig/x_twitter_scraper/models/x/tweet_search_params.rbs', line 247

def to_hash: -> {