x-twitter-scraper 0.12.3 → 0.13.0

package/resources/drafts.d.mts

@@ -6,7 +6,7 @@ import { RequestOptions } from "../internal/request-options.mjs";
  */
 export declare class Drafts extends APIResource {
     /**
-     * Save a tweet draft
+     * Stores a private Xquik draft. It never publishes or creates native X drafts.
      *
      * @example
      * ```ts
@@ -19,7 +19,7 @@ export declare class Drafts extends APIResource {
      */
     create(body: DraftCreateParams, options?: RequestOptions): APIPromise<DraftDetail>;
     /**
-     * Get draft by ID
+     * Returns one private Xquik draft. Native X drafts remain inaccessible.
      *
      * @example
      * ```ts
@@ -28,7 +28,7 @@ export declare class Drafts extends APIResource {
      */
     retrieve(id: string, options?: RequestOptions): APIPromise<DraftDetail>;
     /**
-     * List saved drafts
+     * Lists private Xquik drafts. It cannot access native X drafts.
      *
      * @example
      * ```ts
@@ -37,7 +37,7 @@ export declare class Drafts extends APIResource {
      */
     list(query?: DraftListParams | null | undefined, options?: RequestOptions): APIPromise<DraftListResponse>;
     /**
-     * Delete a draft
+     * Deletes one Xquik draft, not native X drafts or published posts.
      *
      * @example
      * ```ts
@@ -47,7 +47,7 @@ export declare class Drafts extends APIResource {
     delete(id: string, options?: RequestOptions): APIPromise<void>;
 }
 /**
- * Saved tweet draft with optional topic and goal.
+ * Private Xquik draft with optional topic and goal.
  */
 export interface Draft {
     id: string;
@@ -57,15 +57,10 @@ export interface Draft {
     topic?: string;
 }
 /**
- * Full tweet draft including update timestamp.
+ * Full private Xquik draft including update timestamp.
  */
-export interface DraftDetail {
-    id: string;
-    createdAt: string;
-    text: string;
+export interface DraftDetail extends Draft {
     updatedAt: string;
-    goal?: string;
-    topic?: string;
 }
 export interface DraftListResponse {
     drafts: Array<Draft>;
@@ -73,20 +68,21 @@ export interface DraftListResponse {
     nextCursor?: string;
 }
 export interface DraftCreateParams {
+    /**
+     * Draft text, up to 25,000 characters. An emoji counts as 2.
+     */
     text: string;
     goal?: 'engagement' | 'followers' | 'authority' | 'conversation';
     topic?: string;
 }
 export interface DraftListParams {
     /**
-     * Cursor for pagination
+     * Cursor for pagination. The after alias also works.
      */
     afterCursor?: string;
     /**
-     * Maximum number of items to return (1-100, default 50). For paid per-result
-     * endpoints, the returned count may be lower when available usage balance cannot cover
-     * the requested page. If zero paid results are affordable, the endpoint returns
-     * 402 insufficient_credits.
+     * Maximum items per page: 1 to 100, default 50. Credits can reduce paid results.
+     * With none affordable, it returns 402 insufficient_credits.
      */
     limit?: number;
 }

package/resources/drafts.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"drafts.d.mts","sourceRoot":"","sources":["../src/resources/drafts.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,gCAA4B;AAEjD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAG7D;;GAEG;AACH,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAIlF;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAIvE;;;;;;;OAOG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iBAAiB,CAAC;IAIhC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAM/D;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,MAAM,CAAC;IAEb,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAErB,OAAO,EAAE,OAAO,CAAC;IAEjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,CAAC,EAAE,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;IAEjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}
+{"version":3,"file":"drafts.d.mts","sourceRoot":"","sources":["../src/resources/drafts.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,gCAA4B;AAEjD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAG7D;;GAEG;AACH,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAIlF;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAIvE;;;;;;;OAOG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iBAAiB,CAAC;IAIhC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAM/D;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,KAAK;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAErB,OAAO,EAAE,OAAO,CAAC;IAEjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,CAAC,EAAE,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;IAEjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/drafts.d.ts

@@ -6,7 +6,7 @@ import { RequestOptions } from "../internal/request-options.js";
  */
 export declare class Drafts extends APIResource {
     /**
-     * Save a tweet draft
+     * Stores a private Xquik draft. It never publishes or creates native X drafts.
      *
      * @example
      * ```ts
@@ -19,7 +19,7 @@ export declare class Drafts extends APIResource {
      */
     create(body: DraftCreateParams, options?: RequestOptions): APIPromise<DraftDetail>;
     /**
-     * Get draft by ID
+     * Returns one private Xquik draft. Native X drafts remain inaccessible.
      *
      * @example
      * ```ts
@@ -28,7 +28,7 @@ export declare class Drafts extends APIResource {
      */
     retrieve(id: string, options?: RequestOptions): APIPromise<DraftDetail>;
     /**
-     * List saved drafts
+     * Lists private Xquik drafts. It cannot access native X drafts.
      *
      * @example
      * ```ts
@@ -37,7 +37,7 @@ export declare class Drafts extends APIResource {
      */
     list(query?: DraftListParams | null | undefined, options?: RequestOptions): APIPromise<DraftListResponse>;
     /**
-     * Delete a draft
+     * Deletes one Xquik draft, not native X drafts or published posts.
      *
      * @example
      * ```ts
@@ -47,7 +47,7 @@ export declare class Drafts extends APIResource {
     delete(id: string, options?: RequestOptions): APIPromise<void>;
 }
 /**
- * Saved tweet draft with optional topic and goal.
+ * Private Xquik draft with optional topic and goal.
  */
 export interface Draft {
     id: string;
@@ -57,15 +57,10 @@ export interface Draft {
     topic?: string;
 }
 /**
- * Full tweet draft including update timestamp.
+ * Full private Xquik draft including update timestamp.
  */
-export interface DraftDetail {
-    id: string;
-    createdAt: string;
-    text: string;
+export interface DraftDetail extends Draft {
     updatedAt: string;
-    goal?: string;
-    topic?: string;
 }
 export interface DraftListResponse {
     drafts: Array<Draft>;
@@ -73,20 +68,21 @@ export interface DraftListResponse {
     nextCursor?: string;
 }
 export interface DraftCreateParams {
+    /**
+     * Draft text, up to 25,000 characters. An emoji counts as 2.
+     */
     text: string;
     goal?: 'engagement' | 'followers' | 'authority' | 'conversation';
     topic?: string;
 }
 export interface DraftListParams {
     /**
-     * Cursor for pagination
+     * Cursor for pagination. The after alias also works.
      */
     afterCursor?: string;
     /**
-     * Maximum number of items to return (1-100, default 50). For paid per-result
-     * endpoints, the returned count may be lower when available usage balance cannot cover
-     * the requested page. If zero paid results are affordable, the endpoint returns
-     * 402 insufficient_credits.
+     * Maximum items per page: 1 to 100, default 50. Credits can reduce paid results.
+     * With none affordable, it returns 402 insufficient_credits.
      */
     limit?: number;
 }

package/resources/drafts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drafts.d.ts","sourceRoot":"","sources":["../src/resources/drafts.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AAEjD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAG7D;;GAEG;AACH,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAIlF;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAIvE;;;;;;;OAOG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iBAAiB,CAAC;IAIhC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAM/D;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,MAAM,CAAC;IAEb,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAErB,OAAO,EAAE,OAAO,CAAC;IAEjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,CAAC,EAAE,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;IAEjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}
+{"version":3,"file":"drafts.d.ts","sourceRoot":"","sources":["../src/resources/drafts.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AAEjD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAG7D;;GAEG;AACH,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAIlF;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAIvE;;;;;;;OAOG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iBAAiB,CAAC;IAIhC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAM/D;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,KAAK;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAErB,OAAO,EAAE,OAAO,CAAC;IAEjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,CAAC,EAAE,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;IAEjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/drafts.js

@@ -13,7 +13,7 @@ const path_1 = require("../internal/utils/path.js");
  */
 class Drafts extends resource_1.APIResource {
     /**
-     * Save a tweet draft
+     * Stores a private Xquik draft. It never publishes or creates native X drafts.
      *
      * @example
      * ```ts
@@ -28,7 +28,7 @@ class Drafts extends resource_1.APIResource {
         return this._client.post('/drafts', { body, ...options });
     }
     /**
-     * Get draft by ID
+     * Returns one private Xquik draft. Native X drafts remain inaccessible.
      *
      * @example
      * ```ts
@@ -39,7 +39,7 @@ class Drafts extends resource_1.APIResource {
         return this._client.get((0, path_1.path) `/drafts/${id}`, options);
     }
     /**
-     * List saved drafts
+     * Lists private Xquik drafts. It cannot access native X drafts.
      *
      * @example
      * ```ts
@@ -50,7 +50,7 @@ class Drafts extends resource_1.APIResource {
         return this._client.get('/drafts', { query, ...options });
     }
     /**
-     * Delete a draft
+     * Deletes one Xquik draft, not native X drafts or published posts.
      *
      * @example
      * ```ts

package/resources/drafts.mjs

@@ -10,7 +10,7 @@ import { path } from "../internal/utils/path.mjs";
  */
 export class Drafts extends APIResource {
     /**
-     * Save a tweet draft
+     * Stores a private Xquik draft. It never publishes or creates native X drafts.
      *
      * @example
      * ```ts
@@ -25,7 +25,7 @@ export class Drafts extends APIResource {
         return this._client.post('/drafts', { body, ...options });
     }
     /**
-     * Get draft by ID
+     * Returns one private Xquik draft. Native X drafts remain inaccessible.
      *
      * @example
      * ```ts
@@ -36,7 +36,7 @@ export class Drafts extends APIResource {
         return this._client.get(path `/drafts/${id}`, options);
     }
     /**
-     * List saved drafts
+     * Lists private Xquik drafts. It cannot access native X drafts.
      *
      * @example
      * ```ts
@@ -47,7 +47,7 @@ export class Drafts extends APIResource {
         return this._client.get('/drafts', { query, ...options });
     }
     /**
-     * Delete a draft
+     * Deletes one Xquik draft, not native X drafts or published posts.
      *
      * @example
      * ```ts

package/resources/draws.d.mts

@@ -6,7 +6,7 @@ import { RequestOptions } from "../internal/request-options.mjs";
  */
 export declare class Draws extends APIResource {
     /**
-     * Get draw details
+     * Returns draw rules, status, candidates, and selected winners.
      *
      * @example
      * ```ts
@@ -17,7 +17,7 @@ export declare class Draws extends APIResource {
      */
     retrieve(id: string, options?: RequestOptions): APIPromise<DrawRetrieveResponse>;
     /**
-     * List draws
+     * Returns giveaway draws owned by the authenticated account.
      *
      * @example
      * ```ts
@@ -26,7 +26,7 @@ export declare class Draws extends APIResource {
      */
     list(query?: DrawListParams | null | undefined, options?: RequestOptions): APIPromise<DrawListResponse>;
     /**
-     * Export draw data
+     * Downloads draw evidence in the requested format.
      *
      * @example
      * ```ts
@@ -41,43 +41,52 @@ export declare class Draws extends APIResource {
      */
     export(id: string, query: DrawExportParams, options?: RequestOptions): APIPromise<Response>;
     /**
-     * Runs a giveaway draw from a source tweet. The draw first checks that the usage
-     * balance can inspect the source tweet and at least 1 candidate. Available balance
-     * caps how many replies and retweeters can be inspected before filters and winner
-     * selection run.
+     * Checks credits, then draws winners from inspected replies & reposters. Remaining
+     * credits cap the candidates.
      *
      * @example
      * ```ts
      * const response = await client.draws.run({
      *   tweetUrl: 'https://x.com/elonmusk/status/1234567890',
+     *   backupCount: 2,
+     *   filterAccountAgeDays: 30,
+     *   filterLanguage: 'en',
+     *   filterMinFollowers: 50,
+     *   mustFollowUsername: 'elonmusk',
      *   mustRetweet: true,
+     *   requiredHashtags: ['#giveaway'],
+     *   requiredKeywords: ['entered'],
+     *   requiredMentions: ['@elonmusk'],
+     *   uniqueAuthorsOnly: true,
      *   winnerCount: 3,
      * });
      * ```
      */
-    run(body: DrawRunParams, options?: RequestOptions): APIPromise<DrawRunResponse>;
+    run(params: DrawRunParams, options?: RequestOptions): APIPromise<DrawRunResponse>;
 }
 /**
  * Full giveaway draw with tweet metrics, entries, and timing.
  */
-export interface DrawDetail {
-    /**
-     * Draw public ID.
-     */
-    id: string;
-    createdAt: string;
-    status: string;
-    totalEntries: number;
+export interface DrawDetail extends DrawListItem {
     tweetAuthorUsername: string;
     tweetId: string;
+    /**
+     * Whole number from 0.
+     */
     tweetLikeCount: number;
+    /**
+     * Whole number from 0.
+     */
     tweetQuoteCount: number;
+    /**
+     * Whole number from 0.
+     */
     tweetReplyCount: number;
+    /**
+     * Whole number from 0.
+     */
     tweetRetweetCount: number;
     tweetText: string;
-    tweetUrl: string;
-    validEntries: number;
-    drawnAt?: string;
 }
 /**
  * Giveaway draw summary with entry counts and status.
@@ -89,8 +98,14 @@ export interface DrawListItem {
     id: string;
     createdAt: string;
     status: string;
+    /**
+     * Whole number from 0.
+     */
     totalEntries: number;
     tweetUrl: string;
+    /**
+     * Whole number from 0.
+     */
     validEntries: number;
     drawnAt?: string;
 }
@@ -118,28 +133,27 @@ export interface DrawListResponse {
 export interface DrawRunResponse {
     id: string;
     /**
-     * Candidate entries inspected for this draw. This may
-     * be lower than the source tweet's full reply count.
+     * Entries inspected after the credit cap, which can be fewer than the post's
+     * replies.
      */
     totalEntries: number;
     tweetId: string;
     /**
-     * Entries from the inspected candidate set that passed all filters. This is not
-     * necessarily every valid reply on the source tweet when the available balance limits inspection.
+     * Inspected entries that passed every filter. A credit cap can leave valid replies
+     * uninspected.
      */
     validEntries: number;
     winners: Array<Winner>;
 }
 export interface DrawListParams {
     /**
-     * Previous nextCursor.
+     * Previous nextCursor. The after alias also works. Offset pagination is not
+     * supported.
      */
     cursor?: string;
     /**
-     * Maximum number of items to return (1-100, default 50). For paid per-result
-     * endpoints, the returned count may be lower when available usage balance cannot cover
-     * the requested page. If zero paid results are affordable, the endpoint returns
-     * 402 insufficient_credits.
+     * Maximum items per page: 1 to 100, default 50. Credits can reduce paid results.
+     * With none affordable, it returns 402 insufficient_credits.
      */
     limit?: number;
 }
@@ -155,18 +169,60 @@ export interface DrawExportParams {
     type?: 'winners' | 'entries';
 }
 export interface DrawRunParams {
+    /**
+     * Body param
+     */
     tweetUrl: string;
+    /**
+     * Body param
+     */
     backupCount?: number;
+    /**
+     * Body param
+     */
     filterAccountAgeDays?: number;
+    /**
+     * Body param
+     */
     filterLanguage?: string;
+    /**
+     * Body param
+     */
     filterMinFollowers?: number;
+    /**
+     * Body param: X username entrants must follow, with or without @
+     */
     mustFollowUsername?: string;
+    /**
+     * Body param
+     */
     mustRetweet?: boolean;
+    /**
+     * Body param
+     */
     requiredHashtags?: Array<string>;
+    /**
+     * Body param
+     */
     requiredKeywords?: Array<string>;
+    /**
+     * Body param
+     */
     requiredMentions?: Array<string>;
+    /**
+     * Body param
+     */
     uniqueAuthorsOnly?: boolean;
+    /**
+     * Body param
+     */
     winnerCount?: number;
+    /**
+     * Header param: Generate 1 unique value per intended request. Reuse it only to
+     * retry the same request. Exact retries return the original result & charge
+     * nothing.
+     */
+    'Idempotency-Key'?: string;
 }
 export declare namespace Draws {
     export { type DrawDetail as DrawDetail, type DrawListItem as DrawListItem, type Winner as Winner, type DrawRetrieveResponse as DrawRetrieveResponse, type DrawListResponse as DrawListResponse, type DrawRunResponse as DrawRunResponse, type DrawListParams as DrawListParams, type DrawExportParams as DrawExportParams, type DrawRunParams as DrawRunParams, };

package/resources/draws.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"draws.d.mts","sourceRoot":"","sources":["../src/resources/draws.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"draws.d.mts","sourceRoot":"","sources":["../src/resources/draws.ts"],"names":[],"mappings":"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"}