@the-convocation/twitter-scraper 0.19.0 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -70,13 +70,13 @@ class AuthenticationError extends Error {
70
70
  }
71
71
  }
72
72
 
73
- const log$4 = debug("twitter-scraper:rate-limit");
73
+ const log$6 = debug("twitter-scraper:rate-limit");
74
74
  class WaitingRateLimitStrategy {
75
75
  async onRateLimit({ response: res }) {
76
76
  const xRateLimitLimit = res.headers.get("x-rate-limit-limit");
77
77
  const xRateLimitRemaining = res.headers.get("x-rate-limit-remaining");
78
78
  const xRateLimitReset = res.headers.get("x-rate-limit-reset");
79
- log$4(
79
+ log$6(
80
80
  `Rate limit event: limit=${xRateLimitLimit}, remaining=${xRateLimitRemaining}, reset=${xRateLimitReset}`
81
81
  );
82
82
  if (xRateLimitRemaining == "0" && xRateLimitReset) {
@@ -92,23 +92,7 @@ class ErrorRateLimitStrategy {
92
92
  }
93
93
  }
94
94
 
95
- const genericPlatform = new class {
96
- randomizeCiphers() {
97
- return Promise.resolve();
98
- }
99
- }();
100
-
101
- class Platform {
102
- async randomizeCiphers() {
103
- const platform = await Platform.importPlatform();
104
- await platform?.randomizeCiphers();
105
- }
106
- static async importPlatform() {
107
- return genericPlatform;
108
- }
109
- }
110
-
111
- const log$3 = debug("twitter-scraper:requests");
95
+ const log$5 = debug("twitter-scraper:requests");
112
96
  async function updateCookieJar(cookieJar, headers) {
113
97
  let setCookieHeaders = [];
114
98
  if (typeof headers.getSetCookie === "function") {
@@ -123,12 +107,12 @@ async function updateCookieJar(cookieJar, headers) {
123
107
  for (const cookieStr of setCookieHeaders) {
124
108
  const cookie = toughCookie.Cookie.parse(cookieStr);
125
109
  if (!cookie) {
126
- log$3(`Failed to parse cookie: ${cookieStr.substring(0, 100)}`);
110
+ log$5(`Failed to parse cookie: ${cookieStr.substring(0, 100)}`);
127
111
  continue;
128
112
  }
129
113
  if (cookie.maxAge === 0 || cookie.expires && cookie.expires < /* @__PURE__ */ new Date()) {
130
114
  if (cookie.key === "ct0") {
131
- log$3(`Skipping deletion of ct0 cookie (Max-Age=0)`);
115
+ log$5(`Skipping deletion of ct0 cookie (Max-Age=0)`);
132
116
  }
133
117
  continue;
134
118
  }
@@ -136,7 +120,7 @@ async function updateCookieJar(cookieJar, headers) {
136
120
  const url = `${cookie.secure ? "https" : "http"}://${cookie.domain}${cookie.path}`;
137
121
  await cookieJar.setCookie(cookie, url);
138
122
  if (cookie.key === "ct0") {
139
- log$3(
123
+ log$5(
140
124
  `Successfully set ct0 cookie with value: ${cookie.value.substring(
141
125
  0,
142
126
  20
@@ -144,9 +128,9 @@ async function updateCookieJar(cookieJar, headers) {
144
128
  );
145
129
  }
146
130
  } catch (err) {
147
- log$3(`Failed to set cookie ${cookie.key}: ${err}`);
131
+ log$5(`Failed to set cookie ${cookie.key}: ${err}`);
148
132
  if (cookie.key === "ct0") {
149
- log$3(`FAILED to set ct0 cookie! Error: ${err}`);
133
+ log$5(`FAILED to set ct0 cookie! Error: ${err}`);
150
134
  }
151
135
  }
152
136
  }
@@ -160,131 +144,84 @@ async function updateCookieJar(cookieJar, headers) {
160
144
  }
161
145
  }
162
146
 
163
- const log$2 = debug("twitter-scraper:api");
164
- const bearerToken = "AAAAAAAAAAAAAAAAAAAAAFQODgEAAAAAVHTp76lzh3rFzcHbmHVvQxYYpTw%3DckAlMINMjmCwxUcaXbAN4XqJVdgMJaHqNOFgPMK0zN1qLqLQCF";
165
- async function jitter(maxMs) {
166
- const jitter2 = Math.random() * maxMs;
167
- await new Promise((resolve) => setTimeout(resolve, jitter2));
168
- }
169
- async function requestApi(url, auth, method = "GET", platform = new Platform(), headers = new headersPolyfill.Headers()) {
170
- log$2(`Making ${method} request to ${url}`);
171
- await auth.installTo(headers, url);
172
- await platform.randomizeCiphers();
173
- let res;
174
- do {
175
- const fetchParameters = [
176
- url,
147
+ const log$4 = debug("twitter-scraper:xpff");
148
+ let isoCrypto = null;
149
+ function getCrypto() {
150
+ if (isoCrypto != null) {
151
+ return isoCrypto;
152
+ }
153
+ if (typeof crypto === "undefined") {
154
+ log$4("Global crypto is undefined, importing from crypto module...");
155
+ const { webcrypto } = require("crypto");
156
+ isoCrypto = webcrypto;
157
+ return webcrypto;
158
+ }
159
+ isoCrypto = crypto;
160
+ return crypto;
161
+ }
162
+ async function sha256(message) {
163
+ const msgBuffer = new TextEncoder().encode(message);
164
+ const hashBuffer = await getCrypto().subtle.digest("SHA-256", msgBuffer);
165
+ return new Uint8Array(hashBuffer);
166
+ }
167
+ function buf2hex(buffer) {
168
+ return [...new Uint8Array(buffer)].map((x) => x.toString(16).padStart(2, "0")).join("");
169
+ }
170
+ class XPFFHeaderGenerator {
171
+ constructor(seed) {
172
+ this.seed = seed;
173
+ }
174
+ async deriveKey(guestId) {
175
+ const combined = `${this.seed}${guestId}`;
176
+ const result = await sha256(combined);
177
+ return result;
178
+ }
179
+ async generateHeader(plaintext, guestId) {
180
+ log$4(`Generating XPFF key for guest ID: ${guestId}`);
181
+ const key = await this.deriveKey(guestId);
182
+ const nonce = getCrypto().getRandomValues(new Uint8Array(12));
183
+ const cipher = await getCrypto().subtle.importKey(
184
+ "raw",
185
+ key,
186
+ { name: "AES-GCM" },
187
+ false,
188
+ ["encrypt"]
189
+ );
190
+ const encrypted = await getCrypto().subtle.encrypt(
177
191
  {
178
- method,
179
- headers,
180
- credentials: "include"
181
- }
182
- ];
183
- try {
184
- res = await auth.fetch(...fetchParameters);
185
- } catch (err) {
186
- if (!(err instanceof Error)) {
187
- throw err;
188
- }
189
- return {
190
- success: false,
191
- err: new Error("Failed to perform request.")
192
- };
193
- }
194
- await updateCookieJar(auth.cookieJar(), res.headers);
195
- if (res.status === 429) {
196
- log$2("Rate limit hit, waiting for retry...");
197
- await auth.onRateLimit({
198
- fetchParameters,
199
- response: res
200
- });
201
- }
202
- } while (res.status === 429);
203
- if (!res.ok) {
204
- return {
205
- success: false,
206
- err: await ApiError.fromResponse(res)
207
- };
208
- }
209
- const value = await res.json();
210
- if (res.headers.get("x-rate-limit-incoming") == "0") {
211
- auth.deleteToken();
212
- return { success: true, value };
213
- } else {
214
- return { success: true, value };
215
- }
216
- }
217
- function addApiFeatures(o) {
218
- return {
219
- ...o,
220
- rweb_lists_timeline_redesign_enabled: true,
221
- responsive_web_graphql_exclude_directive_enabled: true,
222
- verified_phone_label_enabled: false,
223
- creator_subscriptions_tweet_preview_api_enabled: true,
224
- responsive_web_graphql_timeline_navigation_enabled: true,
225
- responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
226
- tweetypie_unmention_optimization_enabled: true,
227
- responsive_web_edit_tweet_api_enabled: true,
228
- graphql_is_translatable_rweb_tweet_is_translatable_enabled: true,
229
- view_counts_everywhere_api_enabled: true,
230
- longform_notetweets_consumption_enabled: true,
231
- tweet_awards_web_tipping_enabled: false,
232
- freedom_of_speech_not_reach_fetch_enabled: true,
233
- standardized_nudges_misinfo: true,
234
- longform_notetweets_rich_text_read_enabled: true,
235
- responsive_web_enhance_cards_enabled: false,
236
- subscriptions_verification_info_enabled: true,
237
- subscriptions_verification_info_reason_enabled: true,
238
- subscriptions_verification_info_verified_since_enabled: true,
239
- super_follow_badge_privacy_enabled: false,
240
- super_follow_exclusive_tweet_notifications_enabled: false,
241
- super_follow_tweet_api_enabled: false,
242
- super_follow_user_api_enabled: false,
243
- android_graphql_skip_api_media_color_palette: false,
244
- creator_subscriptions_subscription_count_enabled: false,
245
- blue_business_profile_image_shape_enabled: false,
246
- unified_cards_ad_metadata_container_dynamic_card_content_query_enabled: false
247
- };
192
+ name: "AES-GCM",
193
+ iv: nonce
194
+ },
195
+ cipher,
196
+ new TextEncoder().encode(plaintext)
197
+ );
198
+ const combined = new Uint8Array(nonce.length + encrypted.byteLength);
199
+ combined.set(nonce);
200
+ combined.set(new Uint8Array(encrypted), nonce.length);
201
+ const result = buf2hex(combined);
202
+ log$4(`XPFF header generated for guest ID ${guestId}: ${result}`);
203
+ return result;
204
+ }
205
+ }
206
+ const xpffBaseKey = "0e6be1f1e21ffc33590b888fd4dc81b19713e570e805d4e5df80a493c9571a05";
207
+ function xpffPlain() {
208
+ const timestamp = Date.now();
209
+ return JSON.stringify({
210
+ navigator_properties: {
211
+ hasBeenActive: "true",
212
+ userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36",
213
+ webdriver: "false"
214
+ },
215
+ created_at: timestamp
216
+ });
248
217
  }
249
- function addApiParams(params, includeTweetReplies) {
250
- params.set("include_profile_interstitial_type", "1");
251
- params.set("include_blocking", "1");
252
- params.set("include_blocked_by", "1");
253
- params.set("include_followed_by", "1");
254
- params.set("include_want_retweets", "1");
255
- params.set("include_mute_edge", "1");
256
- params.set("include_can_dm", "1");
257
- params.set("include_can_media_tag", "1");
258
- params.set("include_ext_has_nft_avatar", "1");
259
- params.set("include_ext_is_blue_verified", "1");
260
- params.set("include_ext_verified_type", "1");
261
- params.set("skip_status", "1");
262
- params.set("cards_platform", "Web-12");
263
- params.set("include_cards", "1");
264
- params.set("include_ext_alt_text", "true");
265
- params.set("include_ext_limited_action_results", "false");
266
- params.set("include_quote_count", "true");
267
- params.set("include_reply_count", "1");
268
- params.set("tweet_mode", "extended");
269
- params.set("include_ext_collab_control", "true");
270
- params.set("include_ext_views", "true");
271
- params.set("include_entities", "true");
272
- params.set("include_user_entities", "true");
273
- params.set("include_ext_media_color", "true");
274
- params.set("include_ext_media_availability", "true");
275
- params.set("include_ext_sensitive_media_warning", "true");
276
- params.set("include_ext_trusted_friends_metadata", "true");
277
- params.set("send_error_codes", "true");
278
- params.set("simple_quoted_tweet", "true");
279
- params.set("include_tweet_replies", `${includeTweetReplies}`);
280
- params.set(
281
- "ext",
282
- "mediaStats,highlightedLabel,hasNftAvatar,voiceInfo,birdwatchPivot,enrichments,superFollowMetadata,unmentionInfo,editControl,collab_control,vibe"
283
- );
284
- return params;
218
+ async function generateXPFFHeader(guestId) {
219
+ const generator = new XPFFHeaderGenerator(xpffBaseKey);
220
+ const plaintext = xpffPlain();
221
+ return generator.generateHeader(plaintext, guestId);
285
222
  }
286
223
 
287
- const log$1 = debug("twitter-scraper:auth");
224
+ const log$3 = debug("twitter-scraper:auth");
288
225
  function withTransform(fetchFn, transform) {
289
226
  return async (input, init) => {
290
227
  const fetchArgs = await transform?.request?.(input, init) ?? [
@@ -338,20 +275,30 @@ class TwitterGuestAuth {
338
275
  if (this.shouldUpdate()) {
339
276
  await this.updateGuestToken();
340
277
  }
341
- const token = this.guestToken;
342
- if (token == null) {
343
- throw new AuthenticationError(
344
- "Authentication token is null or undefined."
345
- );
278
+ if (this.guestToken) {
279
+ headers.set("x-guest-token", this.guestToken);
346
280
  }
347
281
  headers.set("authorization", `Bearer ${this.bearerToken}`);
348
- headers.set("x-guest-token", token);
282
+ headers.set(
283
+ "user-agent",
284
+ "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36"
285
+ );
286
+ await this.installCsrfToken(headers);
287
+ if (this.options?.experimental?.xpff) {
288
+ const guestId = await this.guestId();
289
+ if (guestId != null) {
290
+ const xpffHeader = await generateXPFFHeader(guestId);
291
+ headers.set("x-xp-forwarded-for", xpffHeader);
292
+ }
293
+ }
294
+ headers.set("cookie", await this.getCookieString());
295
+ }
296
+ async installCsrfToken(headers) {
349
297
  const cookies = await this.getCookies();
350
298
  const xCsrfToken = cookies.find((cookie) => cookie.key === "ct0");
351
299
  if (xCsrfToken) {
352
300
  headers.set("x-csrf-token", xCsrfToken.value);
353
301
  }
354
- headers.set("cookie", await this.getCookieString());
355
302
  }
356
303
  async setCookie(key, value) {
357
304
  const cookie = toughCookie.Cookie.parse(`${key}=${value}`);
@@ -384,16 +331,28 @@ class TwitterGuestAuth {
384
331
  getCookieJarUrl() {
385
332
  return typeof document !== "undefined" ? document.location.toString() : "https://x.com";
386
333
  }
334
+ async guestId() {
335
+ const cookies = await this.getCookies();
336
+ const guestIdCookie = cookies.find((cookie) => cookie.key === "guest_id");
337
+ return guestIdCookie ? guestIdCookie.value : null;
338
+ }
387
339
  /**
388
340
  * Updates the authentication state with a new guest token from the Twitter API.
389
341
  */
390
342
  async updateGuestToken() {
343
+ try {
344
+ await this.updateGuestTokenCore();
345
+ } catch (err) {
346
+ log$3("Failed to update guest token; this may cause issues:", err);
347
+ }
348
+ }
349
+ async updateGuestTokenCore() {
391
350
  const guestActivateUrl = "https://api.x.com/1.1/guest/activate.json";
392
351
  const headers = new headersPolyfill.Headers({
393
352
  Authorization: `Bearer ${this.bearerToken}`,
394
353
  Cookie: await this.getCookieString()
395
354
  });
396
- log$1(`Making POST request to ${guestActivateUrl}`);
355
+ log$3(`Making POST request to ${guestActivateUrl}`);
397
356
  const res = await this.fetch(guestActivateUrl, {
398
357
  method: "POST",
399
358
  headers,
@@ -403,7 +362,7 @@ class TwitterGuestAuth {
403
362
  if (!res.ok) {
404
363
  throw new AuthenticationError(await res.text());
405
364
  }
406
- const o = await res.json();
365
+ const o = await flexParseJson(res);
407
366
  if (o == null || o["guest_token"] == null) {
408
367
  throw new AuthenticationError("guest_token not found.");
409
368
  }
@@ -414,7 +373,7 @@ class TwitterGuestAuth {
414
373
  this.guestToken = newGuestToken;
415
374
  this.guestCreatedAt = /* @__PURE__ */ new Date();
416
375
  await this.setCookie("gt", newGuestToken);
417
- log$1(`Updated guest token: ${newGuestToken}`);
376
+ log$3(`Updated guest token: ${newGuestToken}`);
418
377
  }
419
378
  /**
420
379
  * Returns if the authentication token needs to be updated or not.
@@ -425,6 +384,280 @@ class TwitterGuestAuth {
425
384
  }
426
385
  }
427
386
 
387
+ const genericPlatform = new class {
388
+ randomizeCiphers() {
389
+ return Promise.resolve();
390
+ }
391
+ }();
392
+
393
+ class Platform {
394
+ async randomizeCiphers() {
395
+ const platform = await Platform.importPlatform();
396
+ await platform?.randomizeCiphers();
397
+ }
398
+ static async importPlatform() {
399
+ return genericPlatform;
400
+ }
401
+ }
402
+
403
+ const log$2 = debug("twitter-scraper:xctxid");
404
+ let linkedom = null;
405
+ function linkedomImport() {
406
+ if (!linkedom) {
407
+ const mod = require("linkedom");
408
+ linkedom = mod;
409
+ return mod;
410
+ }
411
+ return linkedom;
412
+ }
413
+ async function parseHTML(html) {
414
+ if (typeof window !== "undefined") {
415
+ const { defaultView } = new DOMParser().parseFromString(html, "text/html");
416
+ if (!defaultView) {
417
+ throw new Error("Failed to get defaultView from parsed HTML.");
418
+ }
419
+ return defaultView;
420
+ } else {
421
+ const { DOMParser: DOMParser2 } = linkedomImport();
422
+ return new DOMParser2().parseFromString(html, "text/html").defaultView;
423
+ }
424
+ }
425
+ async function handleXMigration(fetchFn) {
426
+ const headers = {
427
+ accept: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
428
+ "accept-language": "ja",
429
+ "cache-control": "no-cache",
430
+ pragma: "no-cache",
431
+ priority: "u=0, i",
432
+ "sec-ch-ua": '"Google Chrome";v="135", "Not-A.Brand";v="8", "Chromium";v="135"',
433
+ "sec-ch-ua-mobile": "?0",
434
+ "sec-ch-ua-platform": '"Windows"',
435
+ "sec-fetch-dest": "document",
436
+ "sec-fetch-mode": "navigate",
437
+ "sec-fetch-site": "none",
438
+ "sec-fetch-user": "?1",
439
+ "upgrade-insecure-requests": "1",
440
+ "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36"
441
+ };
442
+ const response = await fetchFn("https://x.com", {
443
+ headers
444
+ });
445
+ if (!response.ok) {
446
+ throw new Error(`Failed to fetch X homepage: ${response.statusText}`);
447
+ }
448
+ const htmlText = await response.text();
449
+ let dom = await parseHTML(htmlText);
450
+ let document = dom.window.document;
451
+ const migrationRedirectionRegex = new RegExp(
452
+ "(http(?:s)?://(?:www\\.)?(twitter|x){1}\\.com(/x)?/migrate([/?])?tok=[a-zA-Z0-9%\\-_]+)+",
453
+ "i"
454
+ );
455
+ const metaRefresh = document.querySelector("meta[http-equiv='refresh']");
456
+ const metaContent = metaRefresh ? metaRefresh.getAttribute("content") || "" : "";
457
+ const migrationRedirectionUrl = migrationRedirectionRegex.exec(metaContent) || migrationRedirectionRegex.exec(htmlText);
458
+ if (migrationRedirectionUrl) {
459
+ const redirectResponse = await fetch(migrationRedirectionUrl[0]);
460
+ if (!redirectResponse.ok) {
461
+ throw new Error(
462
+ `Failed to follow migration redirection: ${redirectResponse.statusText}`
463
+ );
464
+ }
465
+ const redirectHtml = await redirectResponse.text();
466
+ dom = await parseHTML(redirectHtml);
467
+ document = dom.window.document;
468
+ }
469
+ const migrationForm = document.querySelector("form[name='f']") || document.querySelector("form[action='https://x.com/x/migrate']");
470
+ if (migrationForm) {
471
+ const url = migrationForm.getAttribute("action") || "https://x.com/x/migrate";
472
+ const method = migrationForm.getAttribute("method") || "POST";
473
+ const requestPayload = new FormData();
474
+ const inputFields = migrationForm.querySelectorAll("input");
475
+ for (const element of Array.from(inputFields)) {
476
+ const name = element.getAttribute("name");
477
+ const value = element.getAttribute("value");
478
+ if (name && value) {
479
+ requestPayload.append(name, value);
480
+ }
481
+ }
482
+ const formResponse = await fetch(url, {
483
+ method,
484
+ body: requestPayload,
485
+ headers
486
+ });
487
+ if (!formResponse.ok) {
488
+ throw new Error(
489
+ `Failed to submit migration form: ${formResponse.statusText}`
490
+ );
491
+ }
492
+ const formHtml = await formResponse.text();
493
+ dom = await parseHTML(formHtml);
494
+ document = dom.window.document;
495
+ }
496
+ return document;
497
+ }
498
+ let ClientTransaction = null;
499
+ function clientTransaction() {
500
+ if (!ClientTransaction) {
501
+ const mod = require("x-client-transaction-id");
502
+ const ctx = mod.ClientTransaction;
503
+ ClientTransaction = ctx;
504
+ return ctx;
505
+ }
506
+ return ClientTransaction;
507
+ }
508
+ async function generateTransactionId(url, fetchFn, method) {
509
+ const parsedUrl = new URL(url);
510
+ const path = parsedUrl.pathname;
511
+ log$2(`Generating transaction ID for ${method} ${path}`);
512
+ const document = await handleXMigration(fetchFn);
513
+ const transaction = await clientTransaction().create(document);
514
+ const transactionId = await transaction.generateTransactionId(method, path);
515
+ log$2(`Transaction ID: ${transactionId}`);
516
+ return transactionId;
517
+ }
518
+
519
+ const log$1 = debug("twitter-scraper:api");
520
+ const bearerToken = "AAAAAAAAAAAAAAAAAAAAAFQODgEAAAAAVHTp76lzh3rFzcHbmHVvQxYYpTw%3DckAlMINMjmCwxUcaXbAN4XqJVdgMJaHqNOFgPMK0zN1qLqLQCF";
521
+ async function jitter(maxMs) {
522
+ const jitter2 = Math.random() * maxMs;
523
+ await new Promise((resolve) => setTimeout(resolve, jitter2));
524
+ }
525
+ async function requestApi(url, auth, method = "GET", platform = new Platform(), headers = new headersPolyfill.Headers()) {
526
+ log$1(`Making ${method} request to ${url}`);
527
+ await auth.installTo(headers, url);
528
+ await platform.randomizeCiphers();
529
+ if (auth instanceof TwitterGuestAuth && auth.options?.experimental?.xClientTransactionId) {
530
+ const transactionId = await generateTransactionId(
531
+ url,
532
+ auth.fetch.bind(auth),
533
+ method
534
+ );
535
+ headers.set("x-client-transaction-id", transactionId);
536
+ }
537
+ let res;
538
+ do {
539
+ const fetchParameters = [
540
+ url,
541
+ {
542
+ method,
543
+ headers,
544
+ credentials: "include"
545
+ }
546
+ ];
547
+ try {
548
+ res = await auth.fetch(...fetchParameters);
549
+ } catch (err) {
550
+ if (!(err instanceof Error)) {
551
+ throw err;
552
+ }
553
+ return {
554
+ success: false,
555
+ err: new Error("Failed to perform request.")
556
+ };
557
+ }
558
+ await updateCookieJar(auth.cookieJar(), res.headers);
559
+ if (res.status === 429) {
560
+ log$1("Rate limit hit, waiting for retry...");
561
+ await auth.onRateLimit({
562
+ fetchParameters,
563
+ response: res
564
+ });
565
+ }
566
+ } while (res.status === 429);
567
+ if (!res.ok) {
568
+ return {
569
+ success: false,
570
+ err: await ApiError.fromResponse(res)
571
+ };
572
+ }
573
+ const value = await flexParseJson(res);
574
+ if (res.headers.get("x-rate-limit-incoming") == "0") {
575
+ auth.deleteToken();
576
+ return { success: true, value };
577
+ } else {
578
+ return { success: true, value };
579
+ }
580
+ }
581
+ async function flexParseJson(res) {
582
+ try {
583
+ return await res.json();
584
+ } catch {
585
+ log$1("Failed to parse response as JSON, trying text parse...");
586
+ const text = await res.text();
587
+ log$1("Response text:", text);
588
+ return JSON.parse(text);
589
+ }
590
+ }
591
+ function addApiFeatures(o) {
592
+ return {
593
+ ...o,
594
+ rweb_lists_timeline_redesign_enabled: true,
595
+ responsive_web_graphql_exclude_directive_enabled: true,
596
+ verified_phone_label_enabled: false,
597
+ creator_subscriptions_tweet_preview_api_enabled: true,
598
+ responsive_web_graphql_timeline_navigation_enabled: true,
599
+ responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
600
+ tweetypie_unmention_optimization_enabled: true,
601
+ responsive_web_edit_tweet_api_enabled: true,
602
+ graphql_is_translatable_rweb_tweet_is_translatable_enabled: true,
603
+ view_counts_everywhere_api_enabled: true,
604
+ longform_notetweets_consumption_enabled: true,
605
+ tweet_awards_web_tipping_enabled: false,
606
+ freedom_of_speech_not_reach_fetch_enabled: true,
607
+ standardized_nudges_misinfo: true,
608
+ longform_notetweets_rich_text_read_enabled: true,
609
+ responsive_web_enhance_cards_enabled: false,
610
+ subscriptions_verification_info_enabled: true,
611
+ subscriptions_verification_info_reason_enabled: true,
612
+ subscriptions_verification_info_verified_since_enabled: true,
613
+ super_follow_badge_privacy_enabled: false,
614
+ super_follow_exclusive_tweet_notifications_enabled: false,
615
+ super_follow_tweet_api_enabled: false,
616
+ super_follow_user_api_enabled: false,
617
+ android_graphql_skip_api_media_color_palette: false,
618
+ creator_subscriptions_subscription_count_enabled: false,
619
+ blue_business_profile_image_shape_enabled: false,
620
+ unified_cards_ad_metadata_container_dynamic_card_content_query_enabled: false
621
+ };
622
+ }
623
+ function addApiParams(params, includeTweetReplies) {
624
+ params.set("include_profile_interstitial_type", "1");
625
+ params.set("include_blocking", "1");
626
+ params.set("include_blocked_by", "1");
627
+ params.set("include_followed_by", "1");
628
+ params.set("include_want_retweets", "1");
629
+ params.set("include_mute_edge", "1");
630
+ params.set("include_can_dm", "1");
631
+ params.set("include_can_media_tag", "1");
632
+ params.set("include_ext_has_nft_avatar", "1");
633
+ params.set("include_ext_is_blue_verified", "1");
634
+ params.set("include_ext_verified_type", "1");
635
+ params.set("skip_status", "1");
636
+ params.set("cards_platform", "Web-12");
637
+ params.set("include_cards", "1");
638
+ params.set("include_ext_alt_text", "true");
639
+ params.set("include_ext_limited_action_results", "false");
640
+ params.set("include_quote_count", "true");
641
+ params.set("include_reply_count", "1");
642
+ params.set("tweet_mode", "extended");
643
+ params.set("include_ext_collab_control", "true");
644
+ params.set("include_ext_views", "true");
645
+ params.set("include_entities", "true");
646
+ params.set("include_user_entities", "true");
647
+ params.set("include_ext_media_color", "true");
648
+ params.set("include_ext_media_availability", "true");
649
+ params.set("include_ext_sensitive_media_warning", "true");
650
+ params.set("include_ext_trusted_friends_metadata", "true");
651
+ params.set("send_error_codes", "true");
652
+ params.set("simple_quoted_tweet", "true");
653
+ params.set("include_tweet_replies", `${includeTweetReplies}`);
654
+ params.set(
655
+ "ext",
656
+ "mediaStats,highlightedLabel,hasNftAvatar,voiceInfo,birdwatchPivot,enrichments,superFollowMetadata,unmentionInfo,editControl,collab_control,vibe"
657
+ );
658
+ return params;
659
+ }
660
+
428
661
  const log = debug("twitter-scraper:auth-user");
429
662
  const TwitterUserAuthSubtask = typebox.Type.Object({
430
663
  subtask_id: typebox.Type.String(),
@@ -532,21 +765,25 @@ class TwitterUserAuth extends TwitterGuestAuth {
532
765
  this.jar = new toughCookie.CookieJar();
533
766
  }
534
767
  }
535
- async installCsrfToken(headers) {
536
- const cookies = await this.getCookies();
537
- const xCsrfToken = cookies.find((cookie) => cookie.key === "ct0");
538
- if (xCsrfToken) {
539
- headers.set("x-csrf-token", xCsrfToken.value);
540
- }
541
- }
542
768
  async installTo(headers) {
543
769
  headers.set("authorization", `Bearer ${this.bearerToken}`);
544
- const cookie = await this.getCookieString();
545
- headers.set("cookie", cookie);
770
+ headers.set(
771
+ "user-agent",
772
+ "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36"
773
+ );
546
774
  if (this.guestToken) {
547
775
  headers.set("x-guest-token", this.guestToken);
548
776
  }
549
777
  await this.installCsrfToken(headers);
778
+ if (this.options?.experimental?.xpff) {
779
+ const guestId = await this.guestId();
780
+ if (guestId != null) {
781
+ const xpffHeader = await generateXPFFHeader(guestId);
782
+ headers.set("x-xp-forwarded-for", xpffHeader);
783
+ }
784
+ }
785
+ const cookie = await this.getCookieString();
786
+ headers.set("cookie", cookie);
550
787
  }
551
788
  async initLogin() {
552
789
  this.removeCookie("twitter_ads_id=");
@@ -751,12 +988,6 @@ class TwitterUserAuth extends TwitterGuestAuth {
751
988
  onboardingTaskUrl = `https://api.x.com/1.1/onboarding/task.json?flow_name=${data.flow_name}`;
752
989
  }
753
990
  log(`Making POST request to ${onboardingTaskUrl}`);
754
- const token = this.guestToken;
755
- if (token == null) {
756
- throw new AuthenticationError(
757
- "Authentication token is null or undefined."
758
- );
759
- }
760
991
  const headers = new headersPolyfill.Headers({
761
992
  accept: "*/*",
762
993
  "accept-language": "en-US,en;q=0.9",
@@ -773,12 +1004,19 @@ class TwitterUserAuth extends TwitterGuestAuth {
773
1004
  "sec-fetch-mode": "cors",
774
1005
  "sec-fetch-site": "same-origin",
775
1006
  "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36",
776
- "x-guest-token": token,
777
1007
  "x-twitter-auth-type": "OAuth2Client",
778
1008
  "x-twitter-active-user": "yes",
779
1009
  "x-twitter-client-language": "en"
780
1010
  });
781
1011
  await this.installTo(headers);
1012
+ if (this.options?.experimental?.xClientTransactionId) {
1013
+ const transactionId = await generateTransactionId(
1014
+ onboardingTaskUrl,
1015
+ this.fetch.bind(this),
1016
+ "POST"
1017
+ );
1018
+ headers.set("x-client-transaction-id", transactionId);
1019
+ }
782
1020
  let res;
783
1021
  do {
784
1022
  const fetchParameters = [
@@ -813,7 +1051,7 @@ class TwitterUserAuth extends TwitterGuestAuth {
813
1051
  if (!res.ok) {
814
1052
  return { status: "error", err: await ApiError.fromResponse(res) };
815
1053
  }
816
- const flow = await res.json();
1054
+ const flow = await flexParseJson(res);
817
1055
  if (flow?.flow_token == null) {
818
1056
  return {
819
1057
  status: "error",
@@ -851,12 +1089,12 @@ class TwitterUserAuth extends TwitterGuestAuth {
851
1089
 
852
1090
  const endpoints = {
853
1091
  // TODO: Migrate other endpoint URLs here
854
- UserTweets: "https://api.x.com/graphql/VfoNveT-zJPGVZMPydZUfQ/UserTweets?variables=%7B%22userId%22%3A%221806359170830172162%22%2C%22count%22%3A20%2C%22includePromotedContent%22%3Atrue%2C%22withQuickPromoteEligibilityTweetFields%22%3Atrue%2C%22withVoice%22%3Atrue%7D&features=%7B%22rweb_video_screen_enabled%22%3Afalse%2C%22payments_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Afalse%2C%22responsive_web_jetfuel_frame%22%3Atrue%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Afalse%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_grok_imagine_annotation_enabled%22%3Atrue%2C%22responsive_web_grok_community_note_auto_translation_is_enabled%22%3Afalse%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticlePlainText%22%3Afalse%7D",
1092
+ UserTweets: "https://x.com/i/api/graphql/oRJs8SLCRNRbQzuZG93_oA/UserTweets?variables=%7B%22userId%22%3A%221806359170830172162%22%2C%22count%22%3A20%2C%22includePromotedContent%22%3Atrue%2C%22withQuickPromoteEligibilityTweetFields%22%3Atrue%2C%22withVoice%22%3Atrue%7D&features=%7B%22rweb_video_screen_enabled%22%3Afalse%2C%22payments_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22responsive_web_profile_redirect_enabled%22%3Afalse%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Atrue%2C%22responsive_web_jetfuel_frame%22%3Atrue%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Atrue%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_grok_imagine_annotation_enabled%22%3Atrue%2C%22responsive_web_grok_community_note_auto_translation_is_enabled%22%3Afalse%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticlePlainText%22%3Afalse%7D",
855
1093
  UserTweetsAndReplies: "https://x.com/i/api/graphql/Hk4KlJ-ONjlJsucqR55P7g/UserTweetsAndReplies?variables=%7B%22userId%22%3A%221806359170830172162%22%2C%22count%22%3A20%2C%22includePromotedContent%22%3Atrue%2C%22withCommunity%22%3Atrue%2C%22withVoice%22%3Atrue%7D&features=%7B%22rweb_video_screen_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Atrue%2C%22responsive_web_jetfuel_frame%22%3Afalse%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticlePlainText%22%3Afalse%7D",
856
1094
  UserLikedTweets: "https://x.com/i/api/graphql/XHTMjDbiTGLQ9cP1em-aqQ/Likes?variables=%7B%22userId%22%3A%222244196397%22%2C%22count%22%3A20%2C%22includePromotedContent%22%3Afalse%2C%22withClientEventToken%22%3Afalse%2C%22withBirdwatchNotes%22%3Afalse%2C%22withVoice%22%3Atrue%7D&features=%7B%22rweb_video_screen_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Atrue%2C%22responsive_web_jetfuel_frame%22%3Afalse%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticlePlainText%22%3Afalse%7D",
857
- UserByScreenName: "https://api.x.com/graphql/96tVxbPqMZDoYB5pmzezKA/UserByScreenName?variables=%7B%22screen_name%22%3A%22geminiapp%22%2C%22withGrokTranslatedBio%22%3Afalse%7D&features=%7B%22hidden_profile_subscriptions_enabled%22%3Atrue%2C%22payments_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22subscriptions_verification_info_is_identity_verified_enabled%22%3Atrue%2C%22subscriptions_verification_info_verified_since_enabled%22%3Atrue%2C%22highlights_tweets_tab_ui_enabled%22%3Atrue%2C%22responsive_web_twitter_article_notes_tab_enabled%22%3Atrue%2C%22subscriptions_feature_can_gift_premium%22%3Atrue%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%7D&fieldToggles=%7B%22withAuxiliaryUserLabels%22%3Atrue%7D",
858
- TweetDetail: "https://x.com/i/api/graphql/u5Tij6ERlSH2LZvCUqallw/TweetDetail?variables=%7B%22focalTweetId%22%3A%221924893675529900467%22%2C%22referrer%22%3A%22profile%22%2C%22with_rux_injections%22%3Afalse%2C%22rankingMode%22%3A%22Relevance%22%2C%22includePromotedContent%22%3Atrue%2C%22withCommunity%22%3Atrue%2C%22withQuickPromoteEligibilityTweetFields%22%3Atrue%2C%22withBirdwatchNotes%22%3Atrue%2C%22withVoice%22%3Atrue%7D&features=%7B%22rweb_video_screen_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Atrue%2C%22responsive_web_jetfuel_frame%22%3Afalse%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticleRichContentState%22%3Atrue%2C%22withArticlePlainText%22%3Afalse%2C%22withGrokAnalyze%22%3Afalse%2C%22withDisallowedReplyControls%22%3Afalse%7D",
859
- TweetResultByRestId: "https://api.x.com/graphql/wqi5M7wZ7tW-X9S2t-Mqcg/TweetResultByRestId?variables=%7B%22tweetId%22%3A%221924893675529900467%22%2C%22withCommunity%22%3Afalse%2C%22includePromotedContent%22%3Afalse%2C%22withVoice%22%3Afalse%7D&features=%7B%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Afalse%2C%22responsive_web_jetfuel_frame%22%3Atrue%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Afalse%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22payments_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_grok_imagine_annotation_enabled%22%3Atrue%2C%22responsive_web_grok_community_note_auto_translation_is_enabled%22%3Afalse%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticleRichContentState%22%3Atrue%2C%22withArticlePlainText%22%3Afalse%2C%22withGrokAnalyze%22%3Afalse%2C%22withDisallowedReplyControls%22%3Afalse%7D",
1095
+ UserByScreenName: "https://x.com/i/api/graphql/ZHSN3WlvahPKVvUxVQbg1A/UserByScreenName?variables=%7B%22screen_name%22%3A%22geminiapp%22%2C%22withGrokTranslatedBio%22%3Atrue%7D&features=%7B%22hidden_profile_subscriptions_enabled%22%3Atrue%2C%22payments_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22responsive_web_profile_redirect_enabled%22%3Afalse%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22subscriptions_verification_info_is_identity_verified_enabled%22%3Atrue%2C%22subscriptions_verification_info_verified_since_enabled%22%3Atrue%2C%22highlights_tweets_tab_ui_enabled%22%3Atrue%2C%22responsive_web_twitter_article_notes_tab_enabled%22%3Atrue%2C%22subscriptions_feature_can_gift_premium%22%3Atrue%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%7D&fieldToggles=%7B%22withAuxiliaryUserLabels%22%3Atrue%7D",
1096
+ TweetDetail: "https://x.com/i/api/graphql/YVyS4SfwYW7Uw5qwy0mQCA/TweetDetail?variables=%7B%22focalTweetId%22%3A%221985465713096794294%22%2C%22referrer%22%3A%22profile%22%2C%22with_rux_injections%22%3Afalse%2C%22rankingMode%22%3A%22Relevance%22%2C%22includePromotedContent%22%3Atrue%2C%22withCommunity%22%3Atrue%2C%22withQuickPromoteEligibilityTweetFields%22%3Atrue%2C%22withBirdwatchNotes%22%3Atrue%2C%22withVoice%22%3Atrue%7D&features=%7B%22rweb_video_screen_enabled%22%3Afalse%2C%22payments_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22responsive_web_profile_redirect_enabled%22%3Afalse%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Atrue%2C%22responsive_web_jetfuel_frame%22%3Atrue%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Atrue%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_grok_imagine_annotation_enabled%22%3Atrue%2C%22responsive_web_grok_community_note_auto_translation_is_enabled%22%3Afalse%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticleRichContentState%22%3Atrue%2C%22withArticlePlainText%22%3Afalse%2C%22withGrokAnalyze%22%3Afalse%2C%22withDisallowedReplyControls%22%3Afalse%7D",
1097
+ TweetResultByRestId: "https://api.x.com/graphql/tCVRZ3WCvoj0BVO7BKnL-Q/TweetResultByRestId?variables=%7B%22tweetId%22%3A%221985465713096794294%22%2C%22withCommunity%22%3Afalse%2C%22includePromotedContent%22%3Afalse%2C%22withVoice%22%3Afalse%7D&features=%7B%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Afalse%2C%22responsive_web_jetfuel_frame%22%3Atrue%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22payments_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22responsive_web_profile_redirect_enabled%22%3Afalse%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_grok_imagine_annotation_enabled%22%3Atrue%2C%22responsive_web_grok_community_note_auto_translation_is_enabled%22%3Afalse%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticleRichContentState%22%3Atrue%2C%22withArticlePlainText%22%3Afalse%2C%22withGrokAnalyze%22%3Afalse%2C%22withDisallowedReplyControls%22%3Afalse%7D",
860
1098
  ListTweets: "https://x.com/i/api/graphql/S1Sm3_mNJwa-fnY9htcaAQ/ListLatestTweetsTimeline?variables=%7B%22listId%22%3A%221736495155002106192%22%2C%22count%22%3A20%7D&features=%7B%22rweb_video_screen_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Atrue%2C%22responsive_web_jetfuel_frame%22%3Afalse%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D"
861
1099
  };
862
1100
  class ApiRequest {
@@ -2603,7 +2841,11 @@ class Scraper {
2603
2841
  return {
2604
2842
  fetch: this.options?.fetch,
2605
2843
  transform: this.options?.transform,
2606
- rateLimitStrategy: this.options?.rateLimitStrategy
2844
+ rateLimitStrategy: this.options?.rateLimitStrategy,
2845
+ experimental: {
2846
+ xClientTransactionId: this.options?.experimental?.xClientTransactionId,
2847
+ xpff: this.options?.experimental?.xpff
2848
+ }
2607
2849
  };
2608
2850
  }
2609
2851
  handleResponse(res) {