x-twitter-scraper 0.12.3 → 0.13.0

package/resources/x/communities/tweets.d.ts

@@ -3,24 +3,25 @@ import * as Shared from "../../shared.js";
 import { APIPromise } from "../../../core/api-promise.js";
 import { RequestOptions } from "../../../internal/request-options.js";
 /**
- * X Community info, members, and tweets
+ * Find X Communities & read their info, members, posts & media
  */
 export declare class Tweets extends APIResource {
     /**
-     * Requires a Community ID and keyword query.
+     * One resumable page. Add communityId to search 1 Community, or leave it out to
+     * search every Community.
      *
      * @example
      * ```ts
      * const paginatedTweets =
-     *   await client.x.communities.tweets.list({
-     *     communityId: '321669910225',
-     *     q: 'q',
-     *   });
+     *   await client.x.communities.tweets.list({ q: 'q' });
      * ```
      */
     list(query: TweetListParams, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
     /**
-     * List tweets posted in a community
+     * Returns public tweets posted within one community, newest first by default. Send
+     * queryType=Top for the posts X ranks highest. The first page opens with the tweet
+     * the community pinned, flagged isPinned, as x.com shows it. Each tweet costs 1
+     * credit.
      *
      * @example
      * ```ts
@@ -32,39 +33,368 @@ export declare class Tweets extends APIResource {
 }
 export interface TweetListParams {
     /**
-     * Numeric ID of the community to search
+     * Search query
      */
-    communityId: string;
+    q: string;
     /**
-     * Keyword query within the selected community
+     * Words or quoted phrases where any one can match. Separate with spaces, commas,
+     * or lines.
      */
-    q: string;
+    anyWords?: string;
+    /**
+     * Only return tweets from Blue-verified authors.
+     */
+    blueVerifiedOnly?: boolean;
+    /**
+     * Cashtags separated by spaces, commas, or lines.
+     */
+    cashtags?: string;
+    /**
+     * Numeric ID of the Community whose posts to search. Leave it out to search posts
+     * across every Community.
+     */
+    communityId?: string;
+    /**
+     * Conversation ID filter.
+     */
+    conversationId?: string;
     /**
-     * Pagination cursor for community results
+     * Pagination cursor for community search. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
      */
     cursor?: string;
     /**
-     * Maximum page items (1-100, default 20). Source, filters, or credits can reduce
-     * results. Continue while has_next_page is true. Deprecated limit and count
-     * aliases remain accepted.
+     * Match this literal phrase, including any hyphens.
+     */
+    exactPhrase?: string;
+    /**
+     * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+     */
+    excludeWords?: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Filter by author username.
+     */
+    fromUser?: string;
+    /**
+     * Hashtags separated by spaces, commas, or lines.
+     */
+    hashtags?: string;
+    /**
+     * Only replies to this tweet ID.
+     */
+    inReplyToTweetId?: string;
+    /**
+     * Filter by language. Alias `lang` is accepted.
+     */
+    language?: string;
+    /**
+     * Maximum likes threshold. maxLikes & max_likes also work.
+     */
+    maxFaves?: number;
+    /**
+     * Return Tweets at or below this ID.
+     */
+    maxId?: string;
+    /**
+     * Maximum quotes threshold.
+     */
+    maxQuotes?: number;
+    /**
+     * Maximum replies threshold.
+     */
+    maxReplies?: number;
+    /**
+     * Maximum retweets threshold.
+     */
+    maxRetweets?: number;
+    /**
+     * Filter media. Aliases: has_video, has_media.
+     */
+    mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
+    /**
+     * Filter tweets mentioning a username.
+     */
+    mentioning?: string;
+    /**
+     * Minimum bookmark count threshold.
+     */
+    minBookmarks?: number;
+    /**
+     * Minimum likes. Aliases: minFaves, min_likes, min_faves.
+     */
+    minLikes?: number;
+    /**
+     * Minimum quote count threshold.
+     */
+    minQuotes?: number;
+    /**
+     * Minimum replies threshold.
+     */
+    minReplies?: number;
+    /**
+     * Minimum retweets threshold.
+     */
+    minRetweets?: number;
+    /**
+     * Minimum view count threshold.
+     */
+    minViews?: number;
+    /**
+     * Only return native reposts.
+     */
+    nativeRetweets?: boolean;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Items per page (1-100, default 20). Source, filters or credits can return fewer.
+     * Follow next_cursor for more pages. Aliases: limit, count, max_results, maxItems,
+     * max_items & per_page.
      */
     pageSize?: number;
     /**
-     * Sort order for community results (Latest or Top)
+     * Sort order (Latest or Top)
      */
     queryType?: 'Latest' | 'Top';
+    /**
+     * Only when the caller requests a quote mode.
+     */
+    quotes?: 'include' | 'exclude' | 'only';
+    /**
+     * Only quotes of this tweet ID.
+     */
+    quotesOfTweetId?: string;
+    /**
+     * Reply mode. Exclude keeps own-thread replies.
+     */
+    replies?: 'include' | 'exclude' | 'only';
+    /**
+     * Only when the caller requests a repost mode.
+     */
+    retweets?: 'include' | 'exclude' | 'only';
+    /**
+     * Only retweets of this tweet ID.
+     */
+    retweetsOfTweetId?: string;
+    /**
+     * Start date in YYYY-MM-DD format, as a UTC day.
+     */
+    sinceDate?: string;
+    /**
+     * Return Tweets whose IDs exceed this ID.
+     */
+    sinceId?: string;
+    /**
+     * Filter replies sent to a username.
+     */
+    toUser?: string;
+    /**
+     * End date in YYYY-MM-DD format, as a UTC day, inclusive, so its own posts count.
+     */
+    untilDate?: string;
+    /**
+     * URL substring or domain filter.
+     */
+    url?: string;
+    /**
+     * Only return tweets from verified authors.
+     */
+    verifiedOnly?: boolean;
+    /**
+     * Keeps Tweets from a recent window, such as 90m or 7d. Use a whole number & s, m,
+     * h or d.
+     */
+    withinTime?: string;
 }
 export interface TweetListByCommunityParams {
     /**
-     * Pagination cursor for community tweets
+     * Words or quoted phrases where any one can match. Separate with spaces, commas,
+     * or lines.
+     */
+    anyWords?: string;
+    /**
+     * Only return tweets from Blue-verified authors.
+     */
+    blueVerifiedOnly?: boolean;
+    /**
+     * Cashtags separated by spaces, commas, or lines.
+     */
+    cashtags?: string;
+    /**
+     * Conversation ID filter.
+     */
+    conversationId?: string;
+    /**
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
      */
     cursor?: string;
     /**
-     * Maximum page items (1-100, default 20). Source, filters, or credits can reduce
-     * results. Continue while has_next_page is true. Deprecated limit and count
-     * aliases remain accepted.
+     * Match this literal phrase, including any hyphens.
+     */
+    exactPhrase?: string;
+    /**
+     * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+     */
+    excludeWords?: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Filter by author username.
+     */
+    fromUser?: string;
+    /**
+     * Hashtags separated by spaces, commas, or lines.
+     */
+    hashtags?: string;
+    /**
+     * Only replies to this tweet ID.
+     */
+    inReplyToTweetId?: string;
+    /**
+     * Filter by language. Alias `lang` is accepted.
+     */
+    language?: string;
+    /**
+     * Maximum likes threshold. maxLikes & max_likes also work.
+     */
+    maxFaves?: number;
+    /**
+     * Return Tweets at or below this ID.
+     */
+    maxId?: string;
+    /**
+     * Maximum quotes threshold.
+     */
+    maxQuotes?: number;
+    /**
+     * Maximum replies threshold.
+     */
+    maxReplies?: number;
+    /**
+     * Maximum retweets threshold.
+     */
+    maxRetweets?: number;
+    /**
+     * Filter media. Aliases: has_video, has_media.
+     */
+    mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
+    /**
+     * Filter tweets mentioning a username.
+     */
+    mentioning?: string;
+    /**
+     * Minimum bookmark count threshold.
+     */
+    minBookmarks?: number;
+    /**
+     * Minimum likes. Aliases: minFaves, min_likes, min_faves.
+     */
+    minLikes?: number;
+    /**
+     * Minimum quote count threshold.
+     */
+    minQuotes?: number;
+    /**
+     * Minimum replies threshold.
+     */
+    minReplies?: number;
+    /**
+     * Minimum retweets threshold.
+     */
+    minRetweets?: number;
+    /**
+     * Minimum view count threshold.
+     */
+    minViews?: number;
+    /**
+     * Only return native reposts.
+     */
+    nativeRetweets?: boolean;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Items per page (1-100, default 20). Source, filters or credits can return fewer.
+     * Follow next_cursor for more pages. Aliases: limit, count, max_results, maxItems,
+     * max_items & per_page.
      */
     pageSize?: number;
+    /**
+     * Latest for newest first, or Top for the posts X ranks highest. Any case. Aliases
+     * ranking & sort, which also take Recency & Relevance. Send the same value with
+     * each cursor.
+     */
+    queryType?: 'Latest' | 'Top';
+    /**
+     * Only when the caller requests a quote mode.
+     */
+    quotes?: 'include' | 'exclude' | 'only';
+    /**
+     * Only quotes of this tweet ID.
+     */
+    quotesOfTweetId?: string;
+    /**
+     * Reply mode. Exclude keeps own-thread replies.
+     */
+    replies?: 'include' | 'exclude' | 'only';
+    /**
+     * Only when the caller requests a repost mode.
+     */
+    retweets?: 'include' | 'exclude' | 'only';
+    /**
+     * Only retweets of this tweet ID.
+     */
+    retweetsOfTweetId?: string;
+    /**
+     * Start date in YYYY-MM-DD format, as a UTC day.
+     */
+    sinceDate?: string;
+    /**
+     * Return Tweets whose IDs exceed this ID.
+     */
+    sinceId?: string;
+    /**
+     * Filter replies sent to a username.
+     */
+    toUser?: string;
+    /**
+     * End date in YYYY-MM-DD format, as a UTC day, inclusive, so its own posts count.
+     */
+    untilDate?: string;
+    /**
+     * URL substring or domain filter.
+     */
+    url?: string;
+    /**
+     * Only return tweets from verified authors.
+     */
+    verifiedOnly?: boolean;
+    /**
+     * Keeps Tweets from a recent window, such as 90m or 7d. Use a whole number & s, m,
+     * h or d.
+     */
+    withinTime?: string;
 }
 export declare namespace Tweets {
     export { type TweetListParams as TweetListParams, type TweetListByCommunityParams as TweetListByCommunityParams, };

package/resources/x/communities/tweets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tweets.d.ts","sourceRoot":"","sources":["../../../src/resources/x/communities/tweets.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,kCAA+B;AACrD,OAAO,KAAK,MAAM,wBAAqB;AACvC,OAAO,EAAE,UAAU,EAAE,qCAAkC;AACvD,OAAO,EAAE,cAAc,EAAE,6CAA0C;AAGnE;;GAEG;AACH,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC;IAI1F;;;;;;;;OAQG;IACH,eAAe,CACb,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,0BAA0B,GAAG,IAAI,GAAG,SAAc,EACzD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC;CAGtC;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IAEV;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,0BAA0B,IAAI,0BAA0B,GAC9D,CAAC;CACH"}
+{"version":3,"file":"tweets.d.ts","sourceRoot":"","sources":["../../../src/resources/x/communities/tweets.ts"],"names":[],"mappings":"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"}

package/resources/x/communities/tweets.js

@@ -8,26 +8,27 @@ exports.Tweets = void 0;
 const resource_1 = require("../../../core/resource.js");
 const path_1 = require("../../../internal/utils/path.js");
 /**
- * X Community info, members, and tweets
+ * Find X Communities & read their info, members, posts & media
  */
 class Tweets extends resource_1.APIResource {
     /**
-     * Requires a Community ID and keyword query.
+     * One resumable page. Add communityId to search 1 Community, or leave it out to
+     * search every Community.
      *
      * @example
      * ```ts
      * const paginatedTweets =
-     *   await client.x.communities.tweets.list({
-     *     communityId: '321669910225',
-     *     q: 'q',
-     *   });
+     *   await client.x.communities.tweets.list({ q: 'q' });
      * ```
      */
     list(query, options) {
         return this._client.get('/x/communities/tweets', { query, ...options });
     }
     /**
-     * List tweets posted in a community
+     * Returns public tweets posted within one community, newest first by default. Send
+     * queryType=Top for the posts X ranks highest. The first page opens with the tweet
+     * the community pinned, flagged isPinned, as x.com shows it. Each tweet costs 1
+     * credit.
      *
      * @example
      * ```ts

package/resources/x/communities/tweets.js.map

@@ -1 +1 @@
-{"version":3,"file":"tweets.js","sourceRoot":"","sources":["../../../src/resources/x/communities/tweets.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,EAAE;AACF,sCAAsC;;;AAEtC,sFAAsF;AAEtF,wDAAqD;AAIrD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,KAAsB,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;;OAQG;IACH,eAAe,CACb,EAAU,EACV,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;CACF;AAjCD,wBAiCC"}
+{"version":3,"file":"tweets.js","sourceRoot":"","sources":["../../../src/resources/x/communities/tweets.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,EAAE;AACF,sCAAsC;;;AAEtC,sFAAsF;AAEtF,wDAAqD;AAIrD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;OASG;IACH,IAAI,CAAC,KAAsB,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,eAAe,CACb,EAAU,EACV,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;CACF;AAlCD,wBAkCC"}

package/resources/x/communities/tweets.mjs

@@ -5,26 +5,27 @@
 import { APIResource } from "../../../core/resource.mjs";
 import { path } from "../../../internal/utils/path.mjs";
 /**
- * X Community info, members, and tweets
+ * Find X Communities & read their info, members, posts & media
  */
 export class Tweets extends APIResource {
     /**
-     * Requires a Community ID and keyword query.
+     * One resumable page. Add communityId to search 1 Community, or leave it out to
+     * search every Community.
      *
      * @example
      * ```ts
      * const paginatedTweets =
-     *   await client.x.communities.tweets.list({
-     *     communityId: '321669910225',
-     *     q: 'q',
-     *   });
+     *   await client.x.communities.tweets.list({ q: 'q' });
      * ```
      */
     list(query, options) {
         return this._client.get('/x/communities/tweets', { query, ...options });
     }
     /**
-     * List tweets posted in a community
+     * Returns public tweets posted within one community, newest first by default. Send
+     * queryType=Top for the posts X ranks highest. The first page opens with the tweet
+     * the community pinned, flagged isPinned, as x.com shows it. Each tweet costs 1
+     * credit.
      *
      * @example
      * ```ts

package/resources/x/communities/tweets.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tweets.mjs","sourceRoot":"","sources":["../../../src/resources/x/communities/tweets.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,sCAAsC;AAEtC,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAIrD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD;;GAEG;AACH,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,KAAsB,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;;OAQG;IACH,eAAe,CACb,EAAU,EACV,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,kBAAkB,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;CACF"}
+{"version":3,"file":"tweets.mjs","sourceRoot":"","sources":["../../../src/resources/x/communities/tweets.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,sCAAsC;AAEtC,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAIrD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD;;GAEG;AACH,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;OASG;IACH,IAAI,CAAC,KAAsB,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,eAAe,CACb,EAAU,EACV,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,kBAAkB,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;CACF"}