x-twitter-scraper 0.2.1 → 0.3.0

package/resources/x/x.mjs

@@ -21,9 +21,6 @@ import { Tweets, } from "./tweets/tweets.mjs";
 import * as UsersAPI from "./users/users.mjs";
 import { Users, } from "./users/users.mjs";
 import { path } from "../../internal/utils/path.mjs";
-/**
- * X data lookups (subscription required)
- */
 export class X extends APIResource {
     constructor() {
         super(...arguments);
@@ -72,15 +69,15 @@ export class X extends APIResource {
         return this._client.get('/x/notifications', { query, ...options });
     }
     /**
-     * Get trending topics
+     * Get trending hashtags and topics from X by region
      *
      * @example
      * ```ts
      * const response = await client.x.getTrends();
      * ```
      */
-    getTrends(options) {
-        return this._client.get('/x/trends', options);
+    getTrends(query = {}, options) {
+        return this._client.get('/x/trends', { query, ...options });
     }
 }
 X.Tweets = Tweets;

package/resources/x/x.mjs.map

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

package/src/client.ts

@@ -74,18 +74,6 @@ import {
   ExtractionRunResponse,
   Extractions,
 } from './resources/extractions';
-import {
-  Integration,
-  IntegrationCreateParams,
-  IntegrationDeleteResponse,
-  IntegrationDelivery,
-  IntegrationListDeliveriesParams,
-  IntegrationListDeliveriesResponse,
-  IntegrationListResponse,
-  IntegrationSendTestResponse,
-  IntegrationUpdateParams,
-  Integrations,
-} from './resources/integrations';
 import {
   Monitor,
   MonitorCreateParams,
@@ -126,7 +114,6 @@ import {
   WebhookUpdateParams,
   Webhooks,
 } from './resources/webhooks';
-import { Bot } from './resources/bot/bot';
 import { Support } from './resources/support/support';
 import {
   X,
@@ -134,6 +121,7 @@ import {
   XGetHomeTimelineParams,
   XGetNotificationsParams,
   XGetNotificationsResponse,
+  XGetTrendsParams,
   XGetTrendsResponse,
 } from './resources/x/x';
 import { type Fetch } from './internal/builtin-types';
@@ -346,14 +334,8 @@ export class XTwitterScraper {
     );
   }
 
-  protected async authHeaders(
-    opts: FinalRequestOptions,
-    schemes: { apiKeyAuth?: boolean; oauthBearerAuth?: boolean },
-  ): Promise<NullableHeaders | undefined> {
-    return buildHeaders([
-      schemes.apiKeyAuth ? await this.apiKeyAuth(opts) : null,
-      schemes.oauthBearerAuth ? await this.oauthBearerAuth(opts) : null,
-    ]);
+  protected async authHeaders(opts: FinalRequestOptions): Promise<NullableHeaders | undefined> {
+    return buildHeaders([await this.apiKeyAuth(opts), await this.oauthBearerAuth(opts)]);
   }
 
   protected async apiKeyAuth(opts: FinalRequestOptions): Promise<NullableHeaders | undefined> {
@@ -796,7 +778,7 @@ export class XTwitterScraper {
         ...(options.timeout ? { 'X-Stainless-Timeout': String(Math.trunc(options.timeout / 1000)) } : {}),
         ...getPlatformHeaders(),
       },
-      await this.authHeaders(options, options.__security ?? { apiKeyAuth: true, oauthBearerAuth: true }),
+      await this.authHeaders(options),
       this._options.defaultHeaders,
       bodyHeaders,
       options.headers,
@@ -878,7 +860,7 @@ export class XTwitterScraper {
   static toFile = Uploads.toFile;
 
   /**
-   * Account info & settings
+   * Account info and settings
    */
   account: API.Account = new API.Account(this);
   /**
@@ -886,23 +868,23 @@ export class XTwitterScraper {
    */
   apiKeys: API.APIKeys = new API.APIKeys(this);
   /**
-   * Subscription & billing
+   * Subscription, billing, and credits
    */
   subscribe: API.Subscribe = new API.Subscribe(this);
   /**
-   * Tweet composition, drafts, writing styles & radar
+   * AI tweet composition, drafts, writing styles, and radar
    */
   compose: API.Compose = new API.Compose(this);
   /**
-   * Tweet composition, drafts, writing styles & radar
+   * AI tweet composition, drafts, writing styles, and radar
    */
   drafts: API.Drafts = new API.Drafts(this);
   /**
-   * Tweet composition, drafts, writing styles & radar
+   * AI tweet composition, drafts, writing styles, and radar
    */
   styles: API.Styles = new API.Styles(this);
   /**
-   * Tweet composition, drafts, writing styles & radar
+   * AI tweet composition, drafts, writing styles, and radar
    */
   radar: API.Radar = new API.Radar(this);
   /**
@@ -922,25 +904,17 @@ export class XTwitterScraper {
    */
   draws: API.Draws = new API.Draws(this);
   /**
-   * Webhook endpoint management & delivery
+   * Webhook endpoint management and delivery
    */
   webhooks: API.Webhooks = new API.Webhooks(this);
-  /**
-   * Push notification integrations (Telegram)
-   */
-  integrations: API.Integrations = new API.Integrations(this);
-  /**
-   * X data lookups (subscription required)
-   */
   x: API.X = new API.X(this);
   /**
-   * Trending topics by region
+   * Trending topics and hashtags by region
    */
   trends: API.Trends = new API.Trends(this);
-  bot: API.Bot = new API.Bot(this);
   support: API.Support = new API.Support(this);
   /**
-   * Subscription & billing
+   * Subscription, billing, and credits
    */
   credits: API.Credits = new API.Credits(this);
 }
@@ -957,10 +931,8 @@ XTwitterScraper.Events = Events;
 XTwitterScraper.Extractions = Extractions;
 XTwitterScraper.Draws = Draws;
 XTwitterScraper.Webhooks = Webhooks;
-XTwitterScraper.Integrations = Integrations;
 XTwitterScraper.X = X;
 XTwitterScraper.Trends = Trends;
-XTwitterScraper.Bot = Bot;
 XTwitterScraper.Support = Support;
 XTwitterScraper.Credits = Credits;
 
@@ -1079,19 +1051,6 @@ export declare namespace XTwitterScraper {
     type WebhookUpdateParams as WebhookUpdateParams,
   };
 
-  export {
-    Integrations as Integrations,
-    type Integration as Integration,
-    type IntegrationDelivery as IntegrationDelivery,
-    type IntegrationListResponse as IntegrationListResponse,
-    type IntegrationDeleteResponse as IntegrationDeleteResponse,
-    type IntegrationListDeliveriesResponse as IntegrationListDeliveriesResponse,
-    type IntegrationSendTestResponse as IntegrationSendTestResponse,
-    type IntegrationCreateParams as IntegrationCreateParams,
-    type IntegrationUpdateParams as IntegrationUpdateParams,
-    type IntegrationListDeliveriesParams as IntegrationListDeliveriesParams,
-  };
-
   export {
     X as X,
     type XGetArticleResponse as XGetArticleResponse,
@@ -1099,6 +1058,7 @@ export declare namespace XTwitterScraper {
     type XGetTrendsResponse as XGetTrendsResponse,
     type XGetHomeTimelineParams as XGetHomeTimelineParams,
     type XGetNotificationsParams as XGetNotificationsParams,
+    type XGetTrendsParams as XGetTrendsParams,
   };
 
   export {
@@ -1107,8 +1067,6 @@ export declare namespace XTwitterScraper {
     type TrendListParams as TrendListParams,
   };
 
-  export { Bot as Bot };
-
   export { Support as Support };
 
   export {
@@ -1122,4 +1080,6 @@ export declare namespace XTwitterScraper {
   export type EventType = API.EventType;
   export type PaginatedTweets = API.PaginatedTweets;
   export type PaginatedUsers = API.PaginatedUsers;
+  export type SearchTweet = API.SearchTweet;
+  export type UserProfile = API.UserProfile;
 }

package/src/internal/request-options.ts

@@ -75,8 +75,6 @@ export type RequestOptions = {
    */
   defaultBaseURL?: string | undefined;
 
-  __security?: { apiKeyAuth?: boolean; oauthBearerAuth?: boolean };
-
   __binaryResponse?: boolean | undefined;
 };
 

package/src/internal/utils/env.ts

@@ -9,10 +9,10 @@
  */
 export const readEnv = (env: string): string | undefined => {
   if (typeof (globalThis as any).process !== 'undefined') {
-    return (globalThis as any).process.env?.[env]?.trim() ?? undefined;
+    return (globalThis as any).process.env?.[env]?.trim() || undefined;
   }
   if (typeof (globalThis as any).Deno !== 'undefined') {
-    return (globalThis as any).Deno.env?.get?.(env)?.trim();
+    return (globalThis as any).Deno.env?.get?.(env)?.trim() || undefined;
   }
   return undefined;
 };

package/src/resources/account.ts

@@ -5,7 +5,7 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
 /**
- * Account info & settings
+ * Account info and settings
  */
 export class Account extends APIResource {
   /**
@@ -17,7 +17,7 @@ export class Account extends APIResource {
    * ```
    */
   retrieve(options?: RequestOptions): APIPromise<AccountRetrieveResponse> {
-    return this._client.get('/account', { ...options, __security: { apiKeyAuth: true } });
+    return this._client.get('/account', options);
   }
 
   /**
@@ -51,7 +51,7 @@ export class Account extends APIResource {
     body: AccountUpdateLocaleParams,
     options?: RequestOptions,
   ): APIPromise<AccountUpdateLocaleResponse> {
-    return this._client.patch('/account', { body, ...options, __security: { apiKeyAuth: true } });
+    return this._client.patch('/account', { body, ...options });
   }
 }
 
@@ -62,16 +62,18 @@ export interface AccountRetrieveResponse {
 
   plan: 'active' | 'inactive';
 
-  currentPeriod?: AccountRetrieveResponse.CurrentPeriod;
+  creditInfo?: AccountRetrieveResponse.CreditInfo;
 }
 
 export namespace AccountRetrieveResponse {
-  export interface CurrentPeriod {
-    end: string;
+  export interface CreditInfo {
+    autoTopupEnabled: boolean;
 
-    start: string;
+    balance: number;
 
-    usagePercent: number;
+    lifetimePurchased: number;
+
+    lifetimeUsed: number;
   }
 }
 

package/src/resources/api-keys.ts

@@ -20,7 +20,7 @@ export class APIKeys extends APIResource {
    * ```
    */
   create(body: APIKeyCreateParams, options?: RequestOptions): APIPromise<APIKeyCreateResponse> {
-    return this._client.post('/api-keys', { body, ...options, __security: { apiKeyAuth: true } });
+    return this._client.post('/api-keys', { body, ...options });
   }
 
   /**
@@ -32,7 +32,7 @@ export class APIKeys extends APIResource {
    * ```
    */
   list(options?: RequestOptions): APIPromise<APIKeyListResponse> {
-    return this._client.get('/api-keys', { ...options, __security: { apiKeyAuth: true } });
+    return this._client.get('/api-keys', options);
   }
 
   /**
@@ -44,7 +44,7 @@ export class APIKeys extends APIResource {
    * ```
    */
   revoke(id: string, options?: RequestOptions): APIPromise<APIKeyRevokeResponse> {
-    return this._client.delete(path`/api-keys/${id}`, { ...options, __security: { apiKeyAuth: true } });
+    return this._client.delete(path`/api-keys/${id}`, options);
   }
 }
 

package/src/resources/compose.ts

@@ -5,7 +5,7 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
 /**
- * Tweet composition, drafts, writing styles & radar
+ * AI tweet composition, drafts, writing styles, and radar
  */
 export class Compose extends APIResource {
   /**

package/src/resources/credits.ts

@@ -5,7 +5,7 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
 /**
- * Subscription & billing
+ * Subscription, billing, and credits
  */
 export class Credits extends APIResource {
   /**

package/src/resources/drafts.ts

@@ -7,7 +7,7 @@ import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
 /**
- * Tweet composition, drafts, writing styles & radar
+ * AI tweet composition, drafts, writing styles, and radar
  */
 export class Drafts extends APIResource {
   /**

package/src/resources/events.ts

@@ -24,7 +24,7 @@ export class Events extends APIResource {
     query: EventListParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<EventListResponse> {
-    return this._client.get('/events', { query, ...options, __security: { apiKeyAuth: true } });
+    return this._client.get('/events', { query, ...options });
   }
 }
 

package/src/resources/extractions.ts

@@ -165,13 +165,15 @@ export interface ExtractionListResponse {
 export interface ExtractionEstimateCostResponse {
   allowed: boolean;
 
-  estimatedResults: number;
+  creditsAvailable: string;
+
+  creditsRequired: string;
 
-  projectedPercent: number;
+  estimatedResults: number;
 
   source: string;
 
-  usagePercent: number;
+  resolvedXUserId?: string;
 }
 
 export interface ExtractionRunResponse {

package/src/resources/index.ts

@@ -17,7 +17,6 @@ export {
   type AccountSetXUsernameParams,
   type AccountUpdateLocaleParams,
 } from './account';
-export { Bot } from './bot/bot';
 export { Compose, type ComposeCreateResponse, type ComposeCreateParams } from './compose';
 export {
   Credits,
@@ -59,18 +58,6 @@ export {
   type ExtractionExportResultsParams,
   type ExtractionRunParams,
 } from './extractions';
-export {
-  Integrations,
-  type Integration,
-  type IntegrationDelivery,
-  type IntegrationListResponse,
-  type IntegrationDeleteResponse,
-  type IntegrationListDeliveriesResponse,
-  type IntegrationSendTestResponse,
-  type IntegrationCreateParams,
-  type IntegrationUpdateParams,
-  type IntegrationListDeliveriesParams,
-} from './integrations';
 export {
   Monitors,
   type Monitor,
@@ -119,4 +106,5 @@ export {
   type XGetTrendsResponse,
   type XGetHomeTimelineParams,
   type XGetNotificationsParams,
+  type XGetTrendsParams,
 } from './x/x';

package/src/resources/monitors.ts

@@ -16,7 +16,7 @@ export class Monitors extends APIResource {
    * @example
    * ```ts
    * const monitor = await client.monitors.create({
-   *   eventTypes: ['tweet.new', 'follower.gained'],
+   *   eventTypes: ['tweet.new', 'tweet.reply'],
    *   username: 'elonmusk',
    * });
    * ```

package/src/resources/radar.ts

@@ -5,7 +5,7 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
 /**
- * Tweet composition, drafts, writing styles & radar
+ * AI tweet composition, drafts, writing styles, and radar
  */
 export class Radar extends APIResource {
   /**
@@ -20,10 +20,35 @@ export class Radar extends APIResource {
 }
 
 /**
- * Trending topic with score, category, source, and region.
+ * Trending topic with score, category, source, region, language, and
+ * source-specific metadata.
  */
 export interface RadarItem {
-  category: string;
+  /**
+   * Internal numeric identifier (stringified bigint).
+   */
+  id: string;
+
+  category: 'general' | 'tech' | 'dev' | 'science' | 'culture' | 'politics' | 'business' | 'entertainment';
+
+  createdAt: string;
+
+  language: string;
+
+  /**
+   * Source-specific fields. Shape varies per source:
+   *
+   * - reddit: { subreddit: string, author: string }
+   * - github: { starsToday: number }
+   * - hacker_news: { points: number, numberComments: number }
+   * - google_trends: { approxTraffic: number }
+   * - polymarket: { volume24hr: number }
+   * - wikipedia: { views: number }
+   * - trustmrr: { mrr, growthPercent, last30Days, total, customers,
+   *   activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?,
+   *   growthMrrPercent?, multiple?, paymentProvider?, rank? }
+   */
+  metadata: { [key: string]: unknown };
 
   publishedAt: string;
 
@@ -31,7 +56,12 @@ export interface RadarItem {
 
   score: number;
 
-  source: string;
+  source: 'github' | 'google_trends' | 'hacker_news' | 'polymarket' | 'reddit' | 'trustmrr' | 'wikipedia';
+
+  /**
+   * Source-specific identifier used for deduplication.
+   */
+  sourceId: string;
 
   title: string;
 
@@ -43,27 +73,37 @@ export interface RadarItem {
 }
 
 export interface RadarRetrieveTrendingTopicsResponse {
+  hasMore: boolean;
+
   items: Array<RadarItem>;
 
-  total: number;
+  /**
+   * Opaque cursor for the next page (present only when hasMore is true).
+   */
+  nextCursor?: string;
 }
 
 export interface RadarRetrieveTrendingTopicsParams {
   /**
-   * Filter by category (general, tech, dev, etc.)
+   * Cursor for pagination (from prior response nextCursor).
    */
-  category?: string;
+  after?: string;
 
   /**
-   * Number of items to return
+   * Filter by category.
    */
-  count?: number;
+  category?: 'general' | 'tech' | 'dev' | 'science' | 'culture' | 'politics' | 'business' | 'entertainment';
 
   /**
-   * Lookback window in hours
+   * Lookback window in hours (1-168, default 24).
    */
   hours?: number;
 
+  /**
+   * Number of items to return (1-100, default 50).
+   */
+  limit?: number;
+
   /**
    * Region filter (us, global, etc.)
    */

package/src/resources/shared.ts

@@ -1,8 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import * as TweetsAPI from './x/tweets/tweets';
-import * as UsersAPI from './x/users/users';
-
 /**
  * Error response containing a machine-readable error code.
  */
@@ -17,17 +14,17 @@ export interface Error {
     | 'invalid_tweet_id'
     | 'invalid_tweet_url'
     | 'invalid_username'
+    | 'insufficient_credits'
     | 'missing_params'
     | 'missing_query'
     | 'monitor_already_exists'
     | 'monitor_limit_reached'
+    | 'no_credits'
     | 'no_subscription'
     | 'not_found'
-    | 'stream_registration_failed'
     | 'subscription_inactive'
     | 'tweet_not_found'
     | 'unauthenticated'
-    | 'usage_limit_reached'
     | 'user_not_found'
     | 'webhook_inactive'
     | 'x_api_rate_limited'
@@ -38,13 +35,7 @@ export interface Error {
 /**
  * Type of monitor event fired when account activity occurs.
  */
-export type EventType =
-  | 'tweet.new'
-  | 'tweet.reply'
-  | 'tweet.retweet'
-  | 'tweet.quote'
-  | 'follower.gained'
-  | 'follower.lost';
+export type EventType = 'tweet.new' | 'tweet.reply' | 'tweet.retweet' | 'tweet.quote';
 
 /**
  * Paginated list of tweets with cursor-based navigation.
@@ -54,7 +45,7 @@ export interface PaginatedTweets {
 
   next_cursor: string;
 
-  tweets: Array<TweetsAPI.SearchTweet>;
+  tweets: Array<SearchTweet>;
 }
 
 /**
@@ -65,5 +56,74 @@ export interface PaginatedUsers {
 
   next_cursor: string;
 
-  users: Array<UsersAPI.UserProfile>;
+  users: Array<UserProfile>;
+}
+
+/**
+ * Tweet returned from search results with inline author info.
+ */
+export interface SearchTweet {
+  id: string;
+
+  text: string;
+
+  author?: SearchTweet.Author;
+
+  bookmarkCount?: number;
+
+  createdAt?: string;
+
+  /**
+   * True for Note Tweets (long-form content, up to 25,000 characters)
+   */
+  isNoteTweet?: boolean;
+
+  likeCount?: number;
+
+  quoteCount?: number;
+
+  replyCount?: number;
+
+  retweetCount?: number;
+
+  viewCount?: number;
+}
+
+export namespace SearchTweet {
+  export interface Author {
+    id: string;
+
+    name: string;
+
+    username: string;
+
+    verified?: boolean;
+  }
+}
+
+/**
+ * X user profile with bio, follower counts, and verification status.
+ */
+export interface UserProfile {
+  id: string;
+
+  name: string;
+
+  username: string;
+
+  createdAt?: string;
+
+  description?: string;
+
+  followers?: number;
+
+  following?: number;
+
+  location?: string;
+
+  profilePicture?: string;
+
+  statusesCount?: number;
+
+  verified?: boolean;
 }

package/src/resources/styles.ts

@@ -7,7 +7,7 @@ import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
 /**
- * Tweet composition, drafts, writing styles & radar
+ * AI tweet composition, drafts, writing styles, and radar
  */
 export class Styles extends APIResource {
   /**

package/src/resources/subscribe.ts

@@ -5,7 +5,7 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
 /**
- * Subscription & billing
+ * Subscription, billing, and credits
  */
 export class Subscribe extends APIResource {
   /**