x-twitter-scraper 0.12.4 → 0.13.0

package/src/resources/x/communities/communities.ts

@@ -14,6 +14,8 @@ import {
   JoinDeleteAllParams,
   JoinDeleteAllResponse,
 } from './join';
+import * as MediaAPI from './media';
+import { Media, MediaListParams } from './media';
 import * as TweetsAPI from './tweets';
 import { TweetListByCommunityParams, TweetListParams, Tweets } from './tweets';
 import { APIPromise } from '../../../core/api-promise';
@@ -24,9 +26,10 @@ import { path } from '../../../internal/utils/path';
 export class Communities extends APIResource {
   join: JoinAPI.Join = new JoinAPI.Join(this._client);
   tweets: TweetsAPI.Tweets = new TweetsAPI.Tweets(this._client);
+  media: MediaAPI.Media = new MediaAPI.Media(this._client);
 
   /**
-   * Create community
+   * Creates an X Community through a connected account.
    *
    * @example
    * ```ts
@@ -48,15 +51,18 @@ export class Communities extends APIResource {
   }
 
   /**
-   * Delete community
+   * Deletes an owned X Community through a connected account.
    *
    * @example
    * ```ts
-   * const community = await client.x.communities.delete('id', {
-   *   account: '@elonmusk',
-   *   community_name: 'Tesla Fans',
-   *   'Idempotency-Key': 'Idempotency-Key',
-   * });
+   * const community = await client.x.communities.delete(
+   *   '1500000000000000000',
+   *   {
+   *     account: '@elonmusk',
+   *     community_name: 'Tesla Fans',
+   *     'Idempotency-Key': 'Idempotency-Key',
+   *   },
+   * );
    * ```
    */
   delete(
@@ -73,7 +79,76 @@ export class Communities extends APIResource {
   }
 
   /**
-   * Get community name, description and member count
+   * Returns the communities X finds for a keyword, in X's order. Each community
+   * costs 1 credit. To search the tweets in Communities, use /x/communities/search.
+   *
+   * @example
+   * ```ts
+   * const communityPage = await client.x.communities.find({
+   *   q: 'q',
+   * });
+   * ```
+   */
+  find(query: CommunityFindParams, options?: RequestOptions): APIPromise<Shared.CommunityPage> {
+    return this._client.get('/x/communities/find', { query, ...options });
+  }
+
+  /**
+   * Returns the communities X ranks highest under a topic or subtopic. Name it by
+   * topicId or by topic name from /x/communities/topics. Each community costs 1
+   * credit. A missing or unknown topic returns invalid_community_topic & lists the
+   * topic names.
+   *
+   * @example
+   * ```ts
+   * const communityPage =
+   *   await client.x.communities.listPopular();
+   * ```
+   */
+  listPopular(
+    query: CommunityListPopularParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<Shared.CommunityPage> {
+    return this._client.get('/x/communities/popular', { query, ...options });
+  }
+
+  /**
+   * Returns the communities X suggests, with their full public fields. X picks them
+   * per request, so 2 calls can differ. If X suggests none, Xquik asks up to 2 more
+   * times. An empty list is free. Each community costs 1 credit.
+   *
+   * @example
+   * ```ts
+   * const response = await client.x.communities.listSuggested();
+   * ```
+   */
+  listSuggested(
+    query: CommunityListSuggestedParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CommunityListSuggestedResponse> {
+    return this._client.get('/x/communities/suggested', { query, ...options });
+  }
+
+  /**
+   * Returns the community topics with their subtopics. Pass an ID as topicId, or a
+   * name as topic, to /x/communities/popular. Each top-level topic costs 1 credit,
+   * its subtopics included.
+   *
+   * @example
+   * ```ts
+   * const response = await client.x.communities.listTopics();
+   * ```
+   */
+  listTopics(
+    query: CommunityListTopicsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CommunityListTopicsResponse> {
+    return this._client.get('/x/communities/topics', { query, ...options });
+  }
+
+  /**
+   * Returns one community's public identity, rules, join question, search tags,
+   * membership counts, and the profiles of its creator, admin and previewed members.
    *
    * @example
    * ```ts
@@ -82,12 +157,16 @@ export class Communities extends APIResource {
    * );
    * ```
    */
-  retrieveInfo(id: string, options?: RequestOptions): APIPromise<CommunityRetrieveInfoResponse> {
-    return this._client.get(path`/x/communities/${id}/info`, options);
+  retrieveInfo(
+    id: string,
+    query: CommunityRetrieveInfoParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CommunityRetrieveInfoResponse> {
+    return this._client.get(path`/x/communities/${id}/info`, { query, ...options });
   }
 
   /**
-   * List members of a community
+   * Returns public member profiles for one community.
    *
    * @example
    * ```ts
@@ -104,7 +183,7 @@ export class Communities extends APIResource {
   }
 
   /**
-   * List moderators of a community
+   * Returns public moderator profiles for one community.
    *
    * @example
    * ```ts
@@ -121,15 +200,14 @@ export class Communities extends APIResource {
   }
 
   /**
-   * Returns tweets, not community records. Requires a Community ID.
+   * Returns one tweet page, not community records. Add communityId to search 1
+   * Community, or leave it out to search every Community. To find communities by
+   * keyword, use /x/communities/find.
    *
    * @example
    * ```ts
    * const paginatedTweets =
-   *   await client.x.communities.retrieveSearch({
-   *     communityId: '321669910225',
-   *     q: 'q',
-   *   });
+   *   await client.x.communities.retrieveSearch({ q: 'q' });
    * ```
    */
   retrieveSearch(
@@ -138,12 +216,34 @@ export class Communities extends APIResource {
   ): APIPromise<Shared.PaginatedTweets> {
     return this._client.get('/x/communities/search', { query, ...options });
   }
+
+  /**
+   * Finds a community's members by name or username, as the search box on X's
+   * members page does. X checks up to 10 accounts that match, & the answer holds the
+   * members among them, each with its role. Each member costs 1 credit. An answer
+   * without members is free.
+   *
+   * @example
+   * ```ts
+   * const paginatedUsers =
+   *   await client.x.communities.searchMembers('id', {
+   *     q: 'q',
+   *   });
+   * ```
+   */
+  searchMembers(
+    id: string,
+    query: CommunitySearchMembersParams,
+    options?: RequestOptions,
+  ): APIPromise<Shared.PaginatedUsers> {
+    return this._client.get(path`/x/communities/${id}/members/search`, { query, ...options });
+  }
 }
 
 /**
- * Durable write lifecycle record. Poll statusUrl until terminal is true. Reusing
- * the original Idempotency-Key returns this same record. Submit a new write only
- * when safeToRetry is true, using a new key.
+ * Durable write record. Poll statusUrl until terminal is true. Reusing its
+ * Idempotency-Key returns this record. Create another action only when safeToRetry
+ * is true.
  */
 export interface CommunityCreateResponse {
   id: string;
@@ -164,6 +264,7 @@ export interface CommunityCreateResponse {
     | 'unfollow'
     | 'remove_follower'
     | 'send_dm'
+    | 'delete_dm'
     | 'upload_media'
     | 'update_profile'
     | 'update_avatar'
@@ -208,7 +309,7 @@ export interface CommunityCreateResponse {
   retryable: boolean;
 
   /**
-   * True only when no write was dispatched and a new idempotency key may be used.
+   * True only when X did not get the write and a new idempotency key may be used.
    */
   safeToRetry: boolean;
 
@@ -264,6 +365,10 @@ export interface CommunityCreateResponse {
    */
   expiresAt?: string;
 
+  /**
+   * True when this answers a retry of an earlier request with the same
+   * Idempotency-Key.
+   */
   idempotent?: boolean;
 
   /**
@@ -340,6 +445,9 @@ export namespace CommunityCreateResponse {
   export interface NextAction {
     type: 'poll' | 'retry' | 'verify_result' | 'fix_request';
 
+    /**
+     * Milliseconds to wait before you poll or retry.
+     */
     afterMs?: number;
 
     requiresNewIdempotencyKey?: boolean;
@@ -384,9 +492,9 @@ export namespace CommunityCreateResponse {
 }
 
 /**
- * Durable write lifecycle record. Poll statusUrl until terminal is true. Reusing
- * the original Idempotency-Key returns this same record. Submit a new write only
- * when safeToRetry is true, using a new key.
+ * Durable write record. Poll statusUrl until terminal is true. Reusing its
+ * Idempotency-Key returns this record. Create another action only when safeToRetry
+ * is true.
  */
 export interface CommunityDeleteResponse {
   id: string;
@@ -407,6 +515,7 @@ export interface CommunityDeleteResponse {
     | 'unfollow'
     | 'remove_follower'
     | 'send_dm'
+    | 'delete_dm'
     | 'upload_media'
     | 'update_profile'
     | 'update_avatar'
@@ -451,7 +560,7 @@ export interface CommunityDeleteResponse {
   retryable: boolean;
 
   /**
-   * True only when no write was dispatched and a new idempotency key may be used.
+   * True only when X did not get the write and a new idempotency key may be used.
    */
   safeToRetry: boolean;
 
@@ -507,6 +616,10 @@ export interface CommunityDeleteResponse {
    */
   expiresAt?: string;
 
+  /**
+   * True when this answers a retry of an earlier request with the same
+   * Idempotency-Key.
+   */
   idempotent?: boolean;
 
   /**
@@ -583,6 +696,9 @@ export namespace CommunityDeleteResponse {
   export interface NextAction {
     type: 'poll' | 'retry' | 'verify_result' | 'fix_request';
 
+    /**
+     * Milliseconds to wait before you poll or retry.
+     */
     afterMs?: number;
 
     requiresNewIdempotencyKey?: boolean;
@@ -626,154 +742,237 @@ export namespace CommunityDeleteResponse {
   }
 }
 
-export interface CommunityRetrieveInfoResponse {
+export interface CommunityListSuggestedResponse {
+  /**
+   * Suggested communities in X's order
+   */
+  communities: Array<Shared.Community>;
+
+  /**
+   * Communities returned & charged
+   */
+  count: number;
+
   /**
-   * Community info object
+   * What to do next. Present only when X suggests none.
    */
-  community: CommunityRetrieveInfoResponse.Community;
+  message?: string;
 }
 
-export namespace CommunityRetrieveInfoResponse {
+export interface CommunityListTopicsResponse {
   /**
-   * Community info object
+   * Top-level topics returned & charged
    */
-  export interface Community {
-    /**
-     * Unique community identifier
-     */
-    id: string;
+  count: number;
 
-    /**
-     * Community banner image URL
-     */
-    banner_url?: string;
+  /**
+   * Topics in X's order
+   */
+  topics: Array<Shared.CommunityTopic>;
 
-    /**
-     * Community creation timestamp
-     */
-    created_at?: string;
+  /**
+   * What to do next. Present only when X lists no topic.
+   */
+  message?: string;
+}
 
-    creator?: Community.Creator;
+export interface CommunityRetrieveInfoResponse {
+  /**
+   * Public X Community, as every Community read returns it.
+   */
+  community: Shared.Community;
+}
 
-    /**
-     * About text for the community
-     */
-    description?: string;
+export interface CommunityCreateParams {
+  /**
+   * Body param: X account (@username or ID) creating the community
+   */
+  account: string;
 
-    /**
-     * Invitation policy
-     */
-    invites_policy?: string;
+  /**
+   * Body param: Community name, 1 to 100 characters, as X takes it
+   */
+  name: string;
 
-    /**
-     * Whether the community is marked sensitive
-     */
-    is_nsfw?: boolean;
+  /**
+   * Header param: Use one unique value per intended write. Reuse it only for an
+   * identical retry. A matching retry returns the first answer again, with
+   * idempotent: true added. It keeps the first status, body & Retry-After. It sends
+   * nothing to X & charges nothing. While the first request runs, a retry returns
+   * 202 & the action. Different input returns 409. Protection lasts at least 90
+   * days.
+   */
+  'Idempotency-Key': string;
 
-    /**
-     * Join policy (open or restricted)
-     */
-    join_policy?: string;
+  /**
+   * Body param: Community description
+   */
+  description?: string;
+}
 
-    /**
-     * Total member count
-     */
-    member_count?: number;
+export interface CommunityDeleteParams {
+  /**
+   * Body param: X account (@username or ID) deleting the community
+   */
+  account: string;
 
-    /**
-     * Total moderator count
-     */
-    moderator_count?: number;
+  /**
+   * Body param: Community name for confirmation
+   */
+  community_name: string;
 
-    /**
-     * Display name of the community
-     */
-    name?: string;
+  /**
+   * Header param: Use one unique value per intended write. Reuse it only for an
+   * identical retry. A matching retry returns the first answer again, with
+   * idempotent: true added. It keeps the first status, body & Retry-After. It sends
+   * nothing to X & charges nothing. While the first request runs, a retry returns
+   * 202 & the action. Different input returns 409. Protection lasts at least 90
+   * days.
+   */
+  'Idempotency-Key': string;
+}
 
-    /**
-     * Primary topic
-     */
-    primary_topic?: Community.PrimaryTopic;
+export interface CommunityFindParams {
+  /**
+   * Keyword to find communities by, such as ai. Alias query.
+   */
+  q: string;
 
-    /**
-     * Community rules
-     */
-    rules?: Array<Community.Rule>;
-  }
+  /**
+   * Pagination cursor for collection results. Also read as next_cursor, next_token,
+   * pagination_token or continuation_token.
+   */
+  cursor?: string;
 
-  export namespace Community {
-    export interface Creator {
-      id: 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;
 
-      username: string;
+  /**
+   * 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;
 
-      verified: boolean;
+  /**
+   * 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;
+}
 
-      name?: string;
-    }
+export interface CommunityListPopularParams {
+  /**
+   * Pagination cursor for collection results. Also read as next_cursor, next_token,
+   * pagination_token or continuation_token.
+   */
+  cursor?: string;
 
-    /**
-     * Primary topic
-     */
-    export interface PrimaryTopic {
-      id?: 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;
 
-      name?: string;
-    }
+  /**
+   * 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;
 
-    export interface Rule {
-      id?: 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;
 
-      description?: string;
+  /**
+   * Topic or subtopic name in any case, such as technology. Send this or topicId.
+   */
+  topic?: string;
 
-      name?: string;
-    }
-  }
+  /**
+   * Topic or subtopic ID from /x/communities/topics, such as 301. Wins over topic.
+   */
+  topicId?: string;
 }
 
-export interface CommunityCreateParams {
+export interface CommunityListSuggestedParams {
   /**
-   * Body param: X account (@username or ID) creating the community
+   * 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.
    */
-  account: string;
+  fields?: string;
 
   /**
-   * Body param: Community name
+   * Maximum communities to return. Omit it for every suggestion. Credits can return
+   * fewer. Aliases pageSize, count, max_results, maxItems, max_items & per_page.
    */
-  name: string;
+  limit?: number;
 
   /**
-   * Header param: Generate one unique value for each intended write. Reuse it only
-   * when retrying the exact same account, action, target, and payload. A reused key
-   * returns the original action. Reusing it with different input returns 409. Replay
-   * protection remains active for at least 90 days.
+   * Fields to drop from each row, comma-separated. It takes the same names as
+   * fields. With fields, it drops from the kept fields.
    */
-  'Idempotency-Key': string;
+  omit?: string;
+}
 
+export interface CommunityListTopicsParams {
   /**
-   * Body param: Community description
+   * 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.
    */
-  description?: string;
-}
+  fields?: string;
 
-export interface CommunityDeleteParams {
   /**
-   * Body param: X account (@username or ID) deleting the community
+   * Maximum topics to return. Omit it for every topic. Credits can return fewer.
+   * Aliases pageSize, count, max_results, maxItems, max_items & per_page.
    */
-  account: string;
+  limit?: number;
 
   /**
-   * Body param: Community name for confirmation
+   * Fields to drop from each row, comma-separated. It takes the same names as
+   * fields. With fields, it drops from the kept fields.
    */
-  community_name: string;
+  omit?: string;
+}
 
+export interface CommunityRetrieveInfoParams {
   /**
-   * Header param: Generate one unique value for each intended write. Reuse it only
-   * when retrying the exact same account, action, target, and payload. A reused key
-   * returns the original action. Reusing it with different input returns 409. Replay
-   * protection remains active for at least 90 days.
+   * 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.
    */
-  'Idempotency-Key': string;
+  fields?: string;
+
+  /**
+   * 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;
 }
 
 export interface CommunityRetrieveMembersParams {
@@ -783,10 +982,43 @@ export interface CommunityRetrieveMembersParams {
   bioContains?: string;
 
   /**
-   * Pagination cursor
+   * Only return profiles X marks as blue verified. X marks many business &
+   * government accounts blue too. Use verifiedType for 1 badge type.
+   */
+  blueVerifiedOnly?: boolean;
+
+  /**
+   * Only return profiles that publish an email outside free webmail, such as Gmail.
+   */
+  businessEmailOnly?: boolean;
+
+  /**
+   * Pagination cursor for collection results. Also read as next_cursor, next_token,
+   * pagination_token or continuation_token.
    */
   cursor?: string;
 
+  /**
+   * Only return profiles with an email at one of these domains. Separate domains
+   * with commas. Subdomains match.
+   */
+  emailDomains?: 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;
+
+  /**
+   * Only return profiles that publish an email.
+   */
+  hasEmail?: boolean;
+
   /**
    * Only return profiles with a location.
    */
@@ -808,7 +1040,7 @@ export interface CommunityRetrieveMembersParams {
   maxFollowers?: number;
 
   /**
-   * Maximum following count.
+   * Profiles may follow at most this many accounts.
    */
   maxFollowing?: number;
 
@@ -828,7 +1060,7 @@ export interface CommunityRetrieveMembersParams {
   minFollowers?: number;
 
   /**
-   * Minimum following count.
+   * Profiles must follow at least this many accounts.
    */
   minFollowing?: number;
 
@@ -838,9 +1070,13 @@ export interface CommunityRetrieveMembersParams {
   minStatuses?: number;
 
   /**
-   * Items per page (20-200, default 20). This is an upper bound for paid
-   * authenticated calls: available usage balance can reduce the returned page size, and
-   * zero affordable results returns 402 insufficient_credits.
+   * 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;
+
+  /**
+   * Maximum user profiles per page (1-200, default 20).
    */
   pageSize?: number;
 
@@ -867,10 +1103,43 @@ export interface CommunityRetrieveModeratorsParams {
   bioContains?: string;
 
   /**
-   * Pagination cursor for community moderators
+   * Only return profiles X marks as blue verified. X marks many business &
+   * government accounts blue too. Use verifiedType for 1 badge type.
+   */
+  blueVerifiedOnly?: boolean;
+
+  /**
+   * Only return profiles that publish an email outside free webmail, such as Gmail.
+   */
+  businessEmailOnly?: boolean;
+
+  /**
+   * Pagination cursor for collection results. Also read as next_cursor, next_token,
+   * pagination_token or continuation_token.
    */
   cursor?: string;
 
+  /**
+   * Only return profiles with an email at one of these domains. Separate domains
+   * with commas. Subdomains match.
+   */
+  emailDomains?: 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;
+
+  /**
+   * Only return profiles that publish an email.
+   */
+  hasEmail?: boolean;
+
   /**
    * Only return profiles with a location.
    */
@@ -892,7 +1161,7 @@ export interface CommunityRetrieveModeratorsParams {
   maxFollowers?: number;
 
   /**
-   * Maximum following count.
+   * Profiles may follow at most this many accounts.
    */
   maxFollowing?: number;
 
@@ -912,7 +1181,7 @@ export interface CommunityRetrieveModeratorsParams {
   minFollowers?: number;
 
   /**
-   * Minimum following count.
+   * Profiles must follow at least this many accounts.
    */
   minFollowing?: number;
 
@@ -921,6 +1190,12 @@ export interface CommunityRetrieveModeratorsParams {
    */
   minStatuses?: number;
 
+  /**
+   * 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;
+
   /**
    * Match a username substring, ignoring case.
    */
@@ -939,24 +1214,163 @@ export interface CommunityRetrieveModeratorsParams {
 
 export interface CommunityRetrieveSearchParams {
   /**
-   * Numeric ID of the community whose posts to search
+   * Search query
+   */
+  q: string;
+
+  /**
+   * Words or quoted phrases where any one can match. Separate with spaces, commas,
+   * or lines.
    */
-  communityId: string;
+  anyWords?: string;
 
   /**
-   * Search query
+   * Only return tweets from Blue-verified authors.
    */
-  q: string;
+  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 search
+   * 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;
 
@@ -964,21 +1378,207 @@ export interface CommunityRetrieveSearchParams {
    * 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 CommunitySearchMembersParams {
+  /**
+   * Name or username to find members by, such as marckohlbrugge. A leading @ is
+   * dropped. Alias query.
+   */
+  q: string;
+
+  /**
+   * Match any comma-separated or line-separated bio term, ignoring case.
+   */
+  bioContains?: string;
+
+  /**
+   * Only return profiles X marks as blue verified. X marks many business &
+   * government accounts blue too. Use verifiedType for 1 badge type.
+   */
+  blueVerifiedOnly?: boolean;
+
+  /**
+   * Only return profiles that publish an email outside free webmail, such as Gmail.
+   */
+  businessEmailOnly?: boolean;
+
+  /**
+   * Only return profiles with an email at one of these domains. Separate domains
+   * with commas. Subdomains match.
+   */
+  emailDomains?: 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;
+
+  /**
+   * Only return profiles that publish an email.
+   */
+  hasEmail?: boolean;
+
+  /**
+   * Only return profiles with a location.
+   */
+  hasLocation?: boolean;
+
+  /**
+   * Only return profiles with a website.
+   */
+  hasWebsite?: boolean;
+
+  /**
+   * Match a location substring, ignoring case.
+   */
+  locationContains?: string;
+
+  /**
+   * Maximum follower count. Missing counts pass this maximum.
+   */
+  maxFollowers?: number;
+
+  /**
+   * Profiles may follow at most this many accounts.
+   */
+  maxFollowing?: number;
+
+  /**
+   * Maximum post count. maxPosts is also accepted.
+   */
+  maxStatuses?: number;
+
+  /**
+   * Minimum account age in whole days.
+   */
+  minAccountAgeDays?: number;
+
+  /**
+   * Minimum follower count. Filtering happens before billing.
+   */
+  minFollowers?: number;
+
+  /**
+   * Profiles must follow at least this many accounts.
+   */
+  minFollowing?: number;
+
+  /**
+   * Minimum post count. minPosts is also accepted.
+   */
+  minStatuses?: number;
+
+  /**
+   * 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;
+
+  /**
+   * Match a username substring, ignoring case.
+   */
+  usernameContains?: string;
+
+  /**
+   * Only return verified profiles.
+   */
+  verifiedOnly?: boolean;
+
+  /**
+   * Match the verification type exactly, ignoring case.
+   */
+  verifiedType?: string;
 }
 
 Communities.Join = Join;
 Communities.Tweets = Tweets;
+Communities.Media = Media;
 
 export declare namespace Communities {
   export {
     type CommunityCreateResponse as CommunityCreateResponse,
     type CommunityDeleteResponse as CommunityDeleteResponse,
+    type CommunityListSuggestedResponse as CommunityListSuggestedResponse,
+    type CommunityListTopicsResponse as CommunityListTopicsResponse,
     type CommunityRetrieveInfoResponse as CommunityRetrieveInfoResponse,
     type CommunityCreateParams as CommunityCreateParams,
     type CommunityDeleteParams as CommunityDeleteParams,
+    type CommunityFindParams as CommunityFindParams,
+    type CommunityListPopularParams as CommunityListPopularParams,
+    type CommunityListSuggestedParams as CommunityListSuggestedParams,
+    type CommunityListTopicsParams as CommunityListTopicsParams,
+    type CommunityRetrieveInfoParams as CommunityRetrieveInfoParams,
     type CommunityRetrieveMembersParams as CommunityRetrieveMembersParams,
     type CommunityRetrieveModeratorsParams as CommunityRetrieveModeratorsParams,
     type CommunityRetrieveSearchParams as CommunityRetrieveSearchParams,
+    type CommunitySearchMembersParams as CommunitySearchMembersParams,
   };
 
   export {
@@ -994,4 +1594,6 @@ export declare namespace Communities {
     type TweetListParams as TweetListParams,
     type TweetListByCommunityParams as TweetListByCommunityParams,
   };
+
+  export { Media as Media, type MediaListParams as MediaListParams };
 }