x-twitter-scraper 0.12.4 → 0.13.1

package/resources/draws.d.ts

@@ -6,7 +6,7 @@ import { RequestOptions } from "../internal/request-options.js";
  */
 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.ts.map

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

package/resources/draws.js

@@ -4,7 +4,6 @@
 // SPDX-License-Identifier: Apache-2.0
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Draws = void 0;
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 const resource_1 = require("../core/resource.js");
 const headers_1 = require("../internal/headers.js");
 const path_1 = require("../internal/utils/path.js");
@@ -13,7 +12,7 @@ const path_1 = require("../internal/utils/path.js");
  */
 class Draws extends resource_1.APIResource {
     /**
-     * Get draw details
+     * Returns draw rules, status, candidates, and selected winners.
      *
      * @example
      * ```ts
@@ -26,7 +25,7 @@ class Draws extends resource_1.APIResource {
         return this._client.get((0, path_1.path) `/draws/${id}`, options);
     }
     /**
-     * List draws
+     * Returns giveaway draws owned by the authenticated account.
      *
      * @example
      * ```ts
@@ -37,7 +36,7 @@ class Draws extends resource_1.APIResource {
         return this._client.get('/draws', { query, ...options });
     }
     /**
-     * Export draw data
+     * Downloads draw evidence in the requested format.
      *
      * @example
      * ```ts
@@ -59,22 +58,37 @@ class Draws extends resource_1.APIResource {
         });
     }
     /**
-     * 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, options) {
-        return this._client.post('/draws', { body, ...options });
+    run(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/draws', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
     }
 }
 exports.Draws = Draws;

package/resources/draws.js.map

@@ -1 +1 @@
-{"version":3,"file":"draws.js","sourceRoot":"","sources":["../src/resources/draws.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,EAAE;AACF,sCAAsC;;;AAEtC,sFAAsF;AAEtF,kDAA+C;AAE/C,oDAAmD;AAEnD,oDAA8C;AAE9C;;GAEG;AACH,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAU,EAAE,KAAuB,EAAE,OAAwB;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,UAAU,EAAE,SAAS,EAAE;YACjD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACjF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,IAAmB,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF;AAvED,sBAuEC"}
+{"version":3,"file":"draws.js","sourceRoot":"","sources":["../src/resources/draws.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,EAAE;AACF,sCAAsC;;;AAEtC,kDAA+C;AAE/C,oDAAmD;AAEnD,oDAA8C;AAE9C;;GAEG;AACH,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAU,EAAE,KAAuB,EAAE,OAAwB;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,UAAU,EAAE,SAAS,EAAE;YACjD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACjF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,GAAG,CAAC,MAAqB,EAAE,OAAwB;QACjD,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE;YACjC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AAtFD,sBAsFC"}

package/resources/draws.mjs

@@ -1,7 +1,6 @@
 // SPDX-FileCopyrightText: 2026 Xquik contributors
 //
 // SPDX-License-Identifier: Apache-2.0
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../core/resource.mjs";
 import { buildHeaders } from "../internal/headers.mjs";
 import { path } from "../internal/utils/path.mjs";
@@ -10,7 +9,7 @@ import { path } from "../internal/utils/path.mjs";
  */
 export class Draws extends APIResource {
     /**
-     * Get draw details
+     * Returns draw rules, status, candidates, and selected winners.
      *
      * @example
      * ```ts
@@ -23,7 +22,7 @@ export class Draws extends APIResource {
         return this._client.get(path `/draws/${id}`, options);
     }
     /**
-     * List draws
+     * Returns giveaway draws owned by the authenticated account.
      *
      * @example
      * ```ts
@@ -34,7 +33,7 @@ export class Draws extends APIResource {
         return this._client.get('/draws', { query, ...options });
     }
     /**
-     * Export draw data
+     * Downloads draw evidence in the requested format.
      *
      * @example
      * ```ts
@@ -56,22 +55,37 @@ export class Draws extends APIResource {
         });
     }
     /**
-     * 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, options) {
-        return this._client.post('/draws', { body, ...options });
+    run(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/draws', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
     }
 }
 //# sourceMappingURL=draws.mjs.map

package/resources/draws.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"draws.mjs","sourceRoot":"","sources":["../src/resources/draws.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,sCAAsC;AAEtC,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAU,EAAE,KAAuB,EAAE,OAAwB;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,UAAU,EAAE,SAAS,EAAE;YACjD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACjF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,IAAmB,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF"}
+{"version":3,"file":"draws.mjs","sourceRoot":"","sources":["../src/resources/draws.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,sCAAsC;AAEtC,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAU,EAAE,KAAuB,EAAE,OAAwB;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,UAAU,EAAE,SAAS,EAAE;YACjD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACjF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,GAAG,CAAC,MAAqB,EAAE,OAAwB;QACjD,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE;YACjC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF"}