x-twitter-scraper 0.3.2 → 0.3.3

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.
Files changed (11) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/README.md +8 -5
  3. package/package.json +4 -1
  4. package/resources/x/accounts.d.mts +10 -10
  5. package/resources/x/accounts.d.ts +10 -10
  6. package/src/resources/x/accounts.ts +10 -10
  7. package/src/version.ts +1 -1
  8. package/version.d.mts +1 -1
  9. package/version.d.ts +1 -1
  10. package/version.js +1 -1
  11. package/version.mjs +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.3.3 (2026-05-10)
4
+
5
+ Full Changelog: [v0.3.2...v0.3.3](https://github.com/Xquik-dev/x-twitter-scraper-typescript/compare/v0.3.2...v0.3.3)
6
+
7
+ ### Bug Fixes
8
+
9
+ * include bug tracker metadata in the npm package
10
+
3
11
  ## 0.3.2 (2026-05-05)
4
12
 
5
13
  Full Changelog: [v0.3.1...v0.3.2](https://github.com/Xquik-dev/x-twitter-scraper-typescript/compare/v0.3.1...v0.3.2)
package/README.md CHANGED
@@ -1,18 +1,21 @@
1
- # Xquik TypeScript SDK for X (Twitter) Scraper API
1
+ # X (Twitter) Scraper TypeScript SDK: Tweet Search, Profile Tweets, Followers & Posting
2
+
3
+ [![Ask DeepWiki](https://deepwiki.com/badge.svg?url=https%3A%2F%2Fgithub.com%2FXquik-dev%2Fx-twitter-scraper-typescript)](https://deepwiki.com/Xquik-dev/x-twitter-scraper-typescript)
4
+ <a href="https://nothumansearch.ai/site/xquik.com" target="_blank" rel="noopener"><img src="https://nothumansearch.ai/badge/xquik.com.svg" alt="NHS Agentic Readiness Score" height="28"></a>
2
5
 
3
6
  [![NPM version](<https://img.shields.io/npm/v/x-twitter-scraper.svg?label=npm%20(stable)>)](https://npmjs.org/package/x-twitter-scraper) ![npm bundle size](https://img.shields.io/bundlephobia/minzip/x-twitter-scraper)
4
7
 
5
- Xquik TypeScript SDK for the X (Twitter) Scraper API: typed REST, HMAC webhooks, MCP, and docs at https://docs.xquik.com/api-reference/overview.
8
+ Xquik TypeScript SDK for the X (Twitter) Scraper API, a Twitter API SDK and X API alternative for typed tweet search, advanced Twitter search queries, profile tweets, user lookup, follower export, media download, media upload, monitoring, webhooks, MCP, and posting automation.
6
9
 
7
- Use it to search tweets, look up users, monitor accounts, run giveaway draws, and connect AI agents to X data without maintaining scraping infrastructure.
10
+ Use it to get tweets from profiles, search tweets by keyword or operator query, send tweets, post replies, like, repost, follow, DM, run giveaway draws, and connect AI agents to X data without maintaining scraping infrastructure.
8
11
 
9
12
  [SDK API](api.md) | [REST API Docs](https://docs.xquik.com/api-reference/overview) | [OpenAPI Spec](https://xquik.com/openapi.json) | [Webhooks](https://docs.xquik.com/api-reference/webhooks/create) | [MCP Server](https://xquik.com/mcp) | [Python SDK](https://github.com/Xquik-dev/x-twitter-scraper-python)
10
13
 
11
14
  It is generated with [Stainless](https://www.stainless.com/).
12
15
 
13
- ## Tweet Search & User Lookup
16
+ ## Tweet Search, Profile Tweets & User Lookup
14
17
 
15
- Build TypeScript services that search tweets, fetch user profiles, check follower relationships, download media, and inspect timeline data through one typed REST client.
18
+ Build TypeScript services that search tweets, get tweets from profiles, fetch user profiles, check follower relationships, export followers, download media, and inspect timeline data through one typed REST client.
16
19
 
17
20
  ## Real-Time Monitoring & Webhooks
18
21
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "x-twitter-scraper",
3
- "version": "0.3.2",
3
+ "version": "0.3.3",
4
4
  "description": "Official TypeScript SDK for the Xquik X (Twitter) Scraper API, webhooks, monitoring, and agent workflows",
5
5
  "author": "X Twitter Scraper <support@xquik.com>",
6
6
  "types": "./index.d.ts",
@@ -11,6 +11,9 @@
11
11
  "type": "git",
12
12
  "url": "git+https://github.com/Xquik-dev/x-twitter-scraper-typescript.git"
13
13
  },
14
+ "bugs": {
15
+ "url": "https://github.com/Xquik-dev/x-twitter-scraper-typescript/issues"
16
+ },
14
17
  "keywords": [
15
18
  "x-api",
16
19
  "twitter-api",
package/resources/x/accounts.d.mts CHANGED
@@ -104,8 +104,8 @@ export interface XAccountDetail {
104
104
  }
105
105
  /**
106
106
  * Sanitized X account summary returned by connect and reauth. Includes an optional
107
- * `loginCountry` field surfaced only when the declared proxy region had no Driver
108
- * capacity and the login fell back to a single US consumer device for this
107
+ * `loginCountry` field surfaced only when the selected login region was
108
+ * temporarily unavailable and the login used a one-time US session for this
109
109
  * one-time action. Future activity continues to use the selected `proxy_country`;
110
110
  * the field is omitted on normal logins.
111
111
  */
@@ -117,9 +117,9 @@ export interface AccountCreateResponse {
117
117
  xUserId: string;
118
118
  xUsername: string;
119
119
  /**
120
- * ISO-3166-1 alpha-2 country code of the Driver consumer device used for this
121
- * login. Present only when the US fallback was triggered because Driver had no
122
- * capacity in the declared region. Omitted otherwise.
120
+ * ISO-3166-1 alpha-2 country code of the login service session used for this
121
+ * login. Present only when the US fallback was triggered because the selected
122
+ * login region was temporarily unavailable. Omitted otherwise.
123
123
  */
124
124
  loginCountry?: string;
125
125
  }
@@ -137,8 +137,8 @@ export interface AccountBulkRetryResponse {
137
137
  }
138
138
  /**
139
139
  * Sanitized X account summary returned by connect and reauth. Includes an optional
140
- * `loginCountry` field surfaced only when the declared proxy region had no Driver
141
- * capacity and the login fell back to a single US consumer device for this
140
+ * `loginCountry` field surfaced only when the selected login region was
141
+ * temporarily unavailable and the login used a one-time US session for this
142
142
  * one-time action. Future activity continues to use the selected `proxy_country`;
143
143
  * the field is omitted on normal logins.
144
144
  */
@@ -150,9 +150,9 @@ export interface AccountReauthResponse {
150
150
  xUserId: string;
151
151
  xUsername: string;
152
152
  /**
153
- * ISO-3166-1 alpha-2 country code of the Driver consumer device used for this
154
- * login. Present only when the US fallback was triggered because Driver had no
155
- * capacity in the declared region. Omitted otherwise.
153
+ * ISO-3166-1 alpha-2 country code of the login service session used for this
154
+ * login. Present only when the US fallback was triggered because the selected
155
+ * login region was temporarily unavailable. Omitted otherwise.
156
156
  */
157
157
  loginCountry?: string;
158
158
  }
package/resources/x/accounts.d.ts CHANGED
@@ -104,8 +104,8 @@ export interface XAccountDetail {
104
104
  }
105
105
  /**
106
106
  * Sanitized X account summary returned by connect and reauth. Includes an optional
107
- * `loginCountry` field surfaced only when the declared proxy region had no Driver
108
- * capacity and the login fell back to a single US consumer device for this
107
+ * `loginCountry` field surfaced only when the selected login region was
108
+ * temporarily unavailable and the login used a one-time US session for this
109
109
  * one-time action. Future activity continues to use the selected `proxy_country`;
110
110
  * the field is omitted on normal logins.
111
111
  */
@@ -117,9 +117,9 @@ export interface AccountCreateResponse {
117
117
  xUserId: string;
118
118
  xUsername: string;
119
119
  /**
120
- * ISO-3166-1 alpha-2 country code of the Driver consumer device used for this
121
- * login. Present only when the US fallback was triggered because Driver had no
122
- * capacity in the declared region. Omitted otherwise.
120
+ * ISO-3166-1 alpha-2 country code of the login service session used for this
121
+ * login. Present only when the US fallback was triggered because the selected
122
+ * login region was temporarily unavailable. Omitted otherwise.
123
123
  */
124
124
  loginCountry?: string;
125
125
  }
@@ -137,8 +137,8 @@ export interface AccountBulkRetryResponse {
137
137
  }
138
138
  /**
139
139
  * Sanitized X account summary returned by connect and reauth. Includes an optional
140
- * `loginCountry` field surfaced only when the declared proxy region had no Driver
141
- * capacity and the login fell back to a single US consumer device for this
140
+ * `loginCountry` field surfaced only when the selected login region was
141
+ * temporarily unavailable and the login used a one-time US session for this
142
142
  * one-time action. Future activity continues to use the selected `proxy_country`;
143
143
  * the field is omitted on normal logins.
144
144
  */
@@ -150,9 +150,9 @@ export interface AccountReauthResponse {
150
150
  xUserId: string;
151
151
  xUsername: string;
152
152
  /**
153
- * ISO-3166-1 alpha-2 country code of the Driver consumer device used for this
154
- * login. Present only when the US fallback was triggered because Driver had no
155
- * capacity in the declared region. Omitted otherwise.
153
+ * ISO-3166-1 alpha-2 country code of the login service session used for this
154
+ * login. Present only when the US fallback was triggered because the selected
155
+ * login region was temporarily unavailable. Omitted otherwise.
156
156
  */
157
157
  loginCountry?: string;
158
158
  }
package/src/resources/x/accounts.ts CHANGED
@@ -141,8 +141,8 @@ export interface XAccountDetail {
141
141
 
142
142
  /**
143
143
  * Sanitized X account summary returned by connect and reauth. Includes an optional
144
- * `loginCountry` field surfaced only when the declared proxy region had no Driver
145
- * capacity and the login fell back to a single US consumer device for this
144
+ * `loginCountry` field surfaced only when the selected login region was
145
+ * temporarily unavailable and the login used a one-time US session for this
146
146
  * one-time action. Future activity continues to use the selected `proxy_country`;
147
147
  * the field is omitted on normal logins.
148
148
  */
@@ -160,9 +160,9 @@ export interface AccountCreateResponse {
160
160
  xUsername: string;
161
161
 
162
162
  /**
163
- * ISO-3166-1 alpha-2 country code of the Driver consumer device used for this
164
- * login. Present only when the US fallback was triggered because Driver had no
165
- * capacity in the declared region. Omitted otherwise.
163
+ * ISO-3166-1 alpha-2 country code of the login service session used for this
164
+ * login. Present only when the US fallback was triggered because the selected
165
+ * login region was temporarily unavailable. Omitted otherwise.
166
166
  */
167
167
  loginCountry?: string;
168
168
  }
@@ -184,8 +184,8 @@ export interface AccountBulkRetryResponse {
184
184
 
185
185
  /**
186
186
  * Sanitized X account summary returned by connect and reauth. Includes an optional
187
- * `loginCountry` field surfaced only when the declared proxy region had no Driver
188
- * capacity and the login fell back to a single US consumer device for this
187
+ * `loginCountry` field surfaced only when the selected login region was
188
+ * temporarily unavailable and the login used a one-time US session for this
189
189
  * one-time action. Future activity continues to use the selected `proxy_country`;
190
190
  * the field is omitted on normal logins.
191
191
  */
@@ -203,9 +203,9 @@ export interface AccountReauthResponse {
203
203
  xUsername: string;
204
204
 
205
205
  /**
206
- * ISO-3166-1 alpha-2 country code of the Driver consumer device used for this
207
- * login. Present only when the US fallback was triggered because Driver had no
208
- * capacity in the declared region. Omitted otherwise.
206
+ * ISO-3166-1 alpha-2 country code of the login service session used for this
207
+ * login. Present only when the US fallback was triggered because the selected
208
+ * login region was temporarily unavailable. Omitted otherwise.
209
209
  */
210
210
  loginCountry?: string;
211
211
  }
package/src/version.ts CHANGED
@@ -1 +1 @@
1
- export const VERSION = '0.3.2'; // x-release-please-version
1
+ export const VERSION = '0.3.3'; // x-release-please-version
package/version.d.mts CHANGED
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.3.2";
1
+ export declare const VERSION = "0.3.3";
2
2
  //# sourceMappingURL=version.d.mts.map
package/version.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.3.2";
1
+ export declare const VERSION = "0.3.3";
2
2
  //# sourceMappingURL=version.d.ts.map
package/version.js CHANGED
@@ -1,5 +1,5 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.VERSION = void 0;
4
- exports.VERSION = '0.3.2'; // x-release-please-version
4
+ exports.VERSION = '0.3.3'; // x-release-please-version
5
5
  //# sourceMappingURL=version.js.map
package/version.mjs CHANGED
@@ -1,2 +1,2 @@
1
- export const VERSION = '0.3.2'; // x-release-please-version
1
+ export const VERSION = '0.3.3'; // x-release-please-version
2
2
  //# sourceMappingURL=version.mjs.map