@tapline/client 0.2.4 → 0.2.5

package/README.md

@@ -1,6 +1,6 @@
 # @tapline/client
 
-Use `@tapline/client` to collect live data from YouTube, Airbnb, GMGN, GeckoTerminal, GoPlus Security, and Pons Family in TypeScript or JavaScript.
+Use `@tapline/client` to collect live data from YouTube, Airbnb, GMGN, GeckoTerminal, GoPlus Security, Pons Family, and Twitter (X) in TypeScript or JavaScript.
 
 ## What you can do
 
@@ -12,8 +12,9 @@ Use `@tapline/client` to collect live data from YouTube, Airbnb, GMGN, GeckoTerm
 | GeckoTerminal | Find pools, read candlesticks and swaps, inspect holders and traders, and follow market trends | [GeckoTerminal guide](https://github.com/TaplineData/tapline-typescript/blob/main/src/services/geckoterminal/README.md) |
 | GoPlus Security | Check EVM and Tron tokens and Solana mints for honeypots, taxes, owner and mint powers, holders, and liquidity | [GoPlus guide](https://github.com/TaplineData/tapline-typescript/blob/main/src/services/goplus/README.md) |
 | Pons Family | Browse and search launches, read token markets, trades and holders, follow wallets and creator fees, and read the memestock forum | [Pons Family guide](https://github.com/TaplineData/tapline-typescript/blob/main/src/services/ponsfamily/README.md) |
+| Twitter (X) | Read public X profiles with their pinned and newest posts, single posts with media, quotes and top replies, and X Communities | [Twitter guide](https://github.com/TaplineData/tapline-typescript/blob/main/src/services/twitter/README.md) |
 
-One API key and credit balance work across all six services.
+One API key and credit balance work across all seven services.
 
 ## Get started
 
@@ -172,6 +173,7 @@ Use the [Tapline API reference](https://tapline.sh/docs?utm_source=typescript_cl
 - [GeckoTerminal](https://github.com/TaplineData/tapline-typescript/blob/main/src/services/geckoterminal/README.md)
 - [GoPlus Security](https://github.com/TaplineData/tapline-typescript/blob/main/src/services/goplus/README.md)
 - [Pons Family](https://github.com/TaplineData/tapline-typescript/blob/main/src/services/ponsfamily/README.md)
+- [Twitter (X)](https://github.com/TaplineData/tapline-typescript/blob/main/src/services/twitter/README.md)
 
 ## License
 

package/dist/cjs/client.d.ts

@@ -5,6 +5,7 @@ import { GmgnClient } from './services/gmgn/client.js';
 import { GeckoterminalClient } from './services/geckoterminal/client.js';
 import { PonsfamilyClient } from './services/ponsfamily/client.js';
 import { GoplusClient } from './services/goplus/client.js';
+import { TwitterClient } from './services/twitter/client.js';
 export declare class TaplineClient {
     readonly airbnb: AirbnbClient;
     readonly youtube: YoutubeClient;
@@ -12,6 +13,7 @@ export declare class TaplineClient {
     readonly geckoterminal: GeckoterminalClient;
     readonly ponsfamily: PonsfamilyClient;
     readonly goplus: GoplusClient;
+    readonly twitter: TwitterClient;
     constructor(config?: TaplineClientConfig);
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/cjs/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;gBAElB,MAAM,GAAE,mBAAwB;CAS7C"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;gBAEpB,MAAM,GAAE,mBAAwB;CAU7C"}

package/dist/cjs/client.js

@@ -9,6 +9,7 @@ const client_js_3 = require("./services/gmgn/client.js");
 const client_js_4 = require("./services/geckoterminal/client.js");
 const client_js_5 = require("./services/ponsfamily/client.js");
 const client_js_6 = require("./services/goplus/client.js");
+const client_js_7 = require("./services/twitter/client.js");
 class TaplineClient {
     airbnb;
     youtube;
@@ -16,6 +17,7 @@ class TaplineClient {
     geckoterminal;
     ponsfamily;
     goplus;
+    twitter;
     constructor(config = {}) {
         const base = new base_js_1.BaseClient(config);
         this.airbnb = new client_js_1.AirbnbClient(base);
@@ -24,6 +26,7 @@ class TaplineClient {
         this.geckoterminal = new client_js_4.GeckoterminalClient(base);
         this.ponsfamily = new client_js_5.PonsfamilyClient(base);
         this.goplus = new client_js_6.GoplusClient(base);
+        this.twitter = new client_js_7.TwitterClient(base);
     }
 }
 exports.TaplineClient = TaplineClient;

package/dist/cjs/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";AAAA,oEAAoE;;;AAEpE,uCAAuC;AAEvC,2DAA2D;AAC3D,4DAA6D;AAC7D,yDAAuD;AACvD,kEAAyE;AACzE,+DAAmE;AACnE,2DAA2D;AAE3D,MAAa,aAAa;IACf,MAAM,CAAe;IACrB,OAAO,CAAgB;IACvB,IAAI,CAAa;IACjB,aAAa,CAAsB;IACnC,UAAU,CAAmB;IAC7B,MAAM,CAAe;IAE9B,YAAY,SAA8B,EAAE;QAC1C,MAAM,IAAI,GAAG,IAAI,oBAAU,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,wBAAY,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,yBAAa,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,sBAAU,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,IAAI,+BAAmB,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,GAAG,IAAI,4BAAgB,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,wBAAY,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF;AAjBD,sCAiBC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";AAAA,oEAAoE;;;AAEpE,uCAAuC;AAEvC,2DAA2D;AAC3D,4DAA6D;AAC7D,yDAAuD;AACvD,kEAAyE;AACzE,+DAAmE;AACnE,2DAA2D;AAC3D,4DAA6D;AAE7D,MAAa,aAAa;IACf,MAAM,CAAe;IACrB,OAAO,CAAgB;IACvB,IAAI,CAAa;IACjB,aAAa,CAAsB;IACnC,UAAU,CAAmB;IAC7B,MAAM,CAAe;IACrB,OAAO,CAAgB;IAEhC,YAAY,SAA8B,EAAE;QAC1C,MAAM,IAAI,GAAG,IAAI,oBAAU,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,wBAAY,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,yBAAa,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,sBAAU,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,IAAI,+BAAmB,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,GAAG,IAAI,4BAAgB,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,wBAAY,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,yBAAa,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;CACF;AAnBD,sCAmBC"}

package/dist/cjs/index.d.ts

@@ -8,10 +8,12 @@ export { GmgnClient } from './services/gmgn/client.js';
 export { GeckoterminalClient } from './services/geckoterminal/client.js';
 export { PonsfamilyClient } from './services/ponsfamily/client.js';
 export { GoplusClient } from './services/goplus/client.js';
+export { TwitterClient } from './services/twitter/client.js';
 export * as airbnb from './services/airbnb/index.js';
 export * as youtube from './services/youtube/index.js';
 export * as gmgn from './services/gmgn/index.js';
 export * as geckoterminal from './services/geckoterminal/index.js';
 export * as ponsfamily from './services/ponsfamily/index.js';
 export * as goplus from './services/goplus/index.js';
+export * as twitter from './services/twitter/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,UAAU,MAAM,gCAAgC,CAAC;AAC7D,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,UAAU,MAAM,gCAAgC,CAAC;AAC7D,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAC"}

package/dist/cjs/index.js

@@ -34,7 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.goplus = exports.ponsfamily = exports.geckoterminal = exports.gmgn = exports.youtube = exports.airbnb = exports.GoplusClient = exports.PonsfamilyClient = exports.GeckoterminalClient = exports.GmgnClient = exports.YoutubeClient = exports.AirbnbClient = exports.TaplineError = exports.MissingApiKeyError = exports.DEFAULT_BASE_URL = exports.BaseClient = exports.TaplineClient = void 0;
+exports.twitter = exports.goplus = exports.ponsfamily = exports.geckoterminal = exports.gmgn = exports.youtube = exports.airbnb = exports.TwitterClient = exports.GoplusClient = exports.PonsfamilyClient = exports.GeckoterminalClient = exports.GmgnClient = exports.YoutubeClient = exports.AirbnbClient = exports.TaplineError = exports.MissingApiKeyError = exports.DEFAULT_BASE_URL = exports.BaseClient = exports.TaplineClient = void 0;
 var client_js_1 = require("./client.js");
 Object.defineProperty(exports, "TaplineClient", { enumerable: true, get: function () { return client_js_1.TaplineClient; } });
 var base_js_1 = require("./base.js");
@@ -55,10 +55,13 @@ var client_js_6 = require("./services/ponsfamily/client.js");
 Object.defineProperty(exports, "PonsfamilyClient", { enumerable: true, get: function () { return client_js_6.PonsfamilyClient; } });
 var client_js_7 = require("./services/goplus/client.js");
 Object.defineProperty(exports, "GoplusClient", { enumerable: true, get: function () { return client_js_7.GoplusClient; } });
+var client_js_8 = require("./services/twitter/client.js");
+Object.defineProperty(exports, "TwitterClient", { enumerable: true, get: function () { return client_js_8.TwitterClient; } });
 exports.airbnb = __importStar(require("./services/airbnb/index.js"));
 exports.youtube = __importStar(require("./services/youtube/index.js"));
 exports.gmgn = __importStar(require("./services/gmgn/index.js"));
 exports.geckoterminal = __importStar(require("./services/geckoterminal/index.js"));
 exports.ponsfamily = __importStar(require("./services/ponsfamily/index.js"));
 exports.goplus = __importStar(require("./services/goplus/index.js"));
+exports.twitter = __importStar(require("./services/twitter/index.js"));
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,oEAAoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEpE,yCAA4C;AAAnC,0GAAA,aAAa,OAAA;AACtB,qCAAyD;AAAhD,qGAAA,UAAU,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AACrC,yCAA+D;AAAtD,+GAAA,kBAAkB,OAAA;AAAE,yGAAA,YAAY,OAAA;AAEzC,yDAA2D;AAAlD,yGAAA,YAAY,OAAA;AACrB,0DAA6D;AAApD,0GAAA,aAAa,OAAA;AACtB,uDAAuD;AAA9C,uGAAA,UAAU,OAAA;AACnB,gEAAyE;AAAhE,gHAAA,mBAAmB,OAAA;AAC5B,6DAAmE;AAA1D,6GAAA,gBAAgB,OAAA;AACzB,yDAA2D;AAAlD,yGAAA,YAAY,OAAA;AACrB,qEAAqD;AACrD,uEAAuD;AACvD,iEAAiD;AACjD,mFAAmE;AACnE,6EAA6D;AAC7D,qEAAqD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,oEAAoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEpE,yCAA4C;AAAnC,0GAAA,aAAa,OAAA;AACtB,qCAAyD;AAAhD,qGAAA,UAAU,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AACrC,yCAA+D;AAAtD,+GAAA,kBAAkB,OAAA;AAAE,yGAAA,YAAY,OAAA;AAEzC,yDAA2D;AAAlD,yGAAA,YAAY,OAAA;AACrB,0DAA6D;AAApD,0GAAA,aAAa,OAAA;AACtB,uDAAuD;AAA9C,uGAAA,UAAU,OAAA;AACnB,gEAAyE;AAAhE,gHAAA,mBAAmB,OAAA;AAC5B,6DAAmE;AAA1D,6GAAA,gBAAgB,OAAA;AACzB,yDAA2D;AAAlD,yGAAA,YAAY,OAAA;AACrB,0DAA6D;AAApD,0GAAA,aAAa,OAAA;AACtB,qEAAqD;AACrD,uEAAuD;AACvD,iEAAiD;AACjD,mFAAmE;AACnE,6EAA6D;AAC7D,qEAAqD;AACrD,uEAAuD"}

package/dist/cjs/services/twitter/client.d.ts

@@ -0,0 +1,15 @@
+import type { BaseClient } from '../../base.js';
+import type { GetCommunityParams, GetTweetParams, GetUserProfileByIdParams, GetUserProfileParams, TwitterCommunityResponse, TwitterProfileResponse, TwitterTweetDetailResponse } from './types.js';
+export declare class TwitterClient {
+    private readonly base;
+    constructor(base: BaseClient);
+    /** An X (Twitter) Community as x.com shows it to logged-out visitors, as X's Community object in the shape Scrape Creators returns it: `rest_id`, name, description, member count, `created_at` (Unix milliseconds), join policy, topic, banners, rules, creator and member facepile. `tweets` adds the 20 community posts x.com ranks by likes, flattened the way Scrape Creators flattens community posts: the post's `legacy` fields plus `id`, `view_count` and the author as `user`. This is a fixed window: x.com offers no latest feed and no further pages logged-out. A logged-out viewer is not a member, so `is_member` is false and `role` is NonMember. `success`, `credits_charged` and `credits_remaining` (the wallet balance after this charge) sit at the top level of the body, as in Scrape Creators' answers. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. A post's author (`core.user_results.result`, or `user` on a community post) carries what x.com embeds with posts plus what only the author's profile page shows: `location`, the exact join date (`core.created_at`), the bio (`legacy.description` and `profile_bio`), the bio link (`legacy.url` and `legacy.entities`), the banner (`legacy.profile_banner_url`), `legacy.pinned_tweet_ids_str`, `legacy.possibly_sensitive` and `verification.verified`. They come from the author's profile in the same response when there is one, else from the author's profile page, fetched at no extra charge and cached for 2 minutes, so they can be up to 2 minutes old. Author profiles are best-effort. An author whose profile page fails or takes more than 8 seconds keeps only what x.com embeds, and its join date comes from the timestamp inside the user id, which can run up to about 25 minutes before X's own value. Accounts created before about 2016 have ids without a timestamp, so their join date is left out only if that fetch fails or times out. Costs 2 credits. */
+    getCommunity(params: GetCommunityParams): Promise<TwitterCommunityResponse>;
+    /** One X (Twitter) post as x.com shows it to logged-out visitors, as X's Tweet object in the shape Scrape Creators returns it: `rest_id`, the author under `core.user_results.result`, `legacy` (full text, created time, counts, entities with every t.co link mapped, media with video variants and bitrates, reply and quote ids), `views`, `note_tweet` with the full text of a long post, `article`, `card`, `edit_control`, and the quoted post under `quoted_status_result`. `parent_tweets` holds the posts above a reply that x.com shows logged-out, oldest first; in samples that is only the post it replies to, so follow `legacy.in_reply_to_status_id_str` to walk further up. `replies` holds the top replies x.com shows logged-out (0 to 4 in samples, not every reply); x.com offers no further reply pages logged-out. Both lists hold Tweet objects plus their `url`. `success`, `credits_charged` and `credits_remaining` (the wallet balance after this charge) sit at the top level of the body, as in Scrape Creators' answers. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. A post's author (`core.user_results.result`, or `user` on a community post) carries what x.com embeds with posts plus what only the author's profile page shows: `location`, the exact join date (`core.created_at`), the bio (`legacy.description` and `profile_bio`), the bio link (`legacy.url` and `legacy.entities`), the banner (`legacy.profile_banner_url`), `legacy.pinned_tweet_ids_str`, `legacy.possibly_sensitive` and `verification.verified`. They come from the author's profile in the same response when there is one, else from the author's profile page, fetched at no extra charge and cached for 2 minutes, so they can be up to 2 minutes old. Author profiles are best-effort. An author whose profile page fails or takes more than 8 seconds keeps only what x.com embeds, and its join date comes from the timestamp inside the user id, which can run up to about 25 minutes before X's own value. Accounts created before about 2016 have ids without a timestamp, so their join date is left out only if that fetch fails or times out. Costs 1 credit. */
+    getTweet(params: GetTweetParams): Promise<TwitterTweetDetailResponse>;
+    /** An X (Twitter) account's public profile as x.com shows it to logged-out visitors, as X's User object in the shape Scrape Creators returns it: `rest_id`, `core` (name, handle, join date), `legacy` (bio, follower, following and post counts, avatar, banner, bio link, pinned post id), `location`, `privacy`, `verification` and `is_blue_verified`. `pinned_tweet` and `tweets` add the pinned post and the newest original posts x.com shows logged-out (4 or 5 in samples) from the same page fetch, each an X Tweet object plus its `url`. This is a fixed window: x.com offers no further pages logged-out, so there is no cursor. A protected account returns its profile with no posts. Tapline caches each profile page for 2 minutes, so a profile and its posts can be up to 2 minutes old. `success`, `credits_charged` and `credits_remaining` (the wallet balance after this charge) sit at the top level of the body, as in Scrape Creators' answers. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. A post's author (`core.user_results.result`, or `user` on a community post) carries what x.com embeds with posts plus what only the author's profile page shows: `location`, the exact join date (`core.created_at`), the bio (`legacy.description` and `profile_bio`), the bio link (`legacy.url` and `legacy.entities`), the banner (`legacy.profile_banner_url`), `legacy.pinned_tweet_ids_str`, `legacy.possibly_sensitive` and `verification.verified`. They come from the author's profile in the same response when there is one, else from the author's profile page, fetched at no extra charge and cached for 2 minutes, so they can be up to 2 minutes old. Author profiles are best-effort. An author whose profile page fails or takes more than 8 seconds keeps only what x.com embeds, and its join date comes from the timestamp inside the user id, which can run up to about 25 minutes before X's own value. Accounts created before about 2016 have ids without a timestamp, so their join date is left out only if that fetch fails or times out. Looks the account up by its numeric user id. Costs 1 credit. */
+    getUserProfileById(params: GetUserProfileByIdParams): Promise<TwitterProfileResponse>;
+    /** An X (Twitter) account's public profile as x.com shows it to logged-out visitors, as X's User object in the shape Scrape Creators returns it: `rest_id`, `core` (name, handle, join date), `legacy` (bio, follower, following and post counts, avatar, banner, bio link, pinned post id), `location`, `privacy`, `verification` and `is_blue_verified`. `pinned_tweet` and `tweets` add the pinned post and the newest original posts x.com shows logged-out (4 or 5 in samples) from the same page fetch, each an X Tweet object plus its `url`. This is a fixed window: x.com offers no further pages logged-out, so there is no cursor. A protected account returns its profile with no posts. Tapline caches each profile page for 2 minutes, so a profile and its posts can be up to 2 minutes old. `success`, `credits_charged` and `credits_remaining` (the wallet balance after this charge) sit at the top level of the body, as in Scrape Creators' answers. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. A post's author (`core.user_results.result`, or `user` on a community post) carries what x.com embeds with posts plus what only the author's profile page shows: `location`, the exact join date (`core.created_at`), the bio (`legacy.description` and `profile_bio`), the bio link (`legacy.url` and `legacy.entities`), the banner (`legacy.profile_banner_url`), `legacy.pinned_tweet_ids_str`, `legacy.possibly_sensitive` and `verification.verified`. They come from the author's profile in the same response when there is one, else from the author's profile page, fetched at no extra charge and cached for 2 minutes, so they can be up to 2 minutes old. Author profiles are best-effort. An author whose profile page fails or takes more than 8 seconds keeps only what x.com embeds, and its join date comes from the timestamp inside the user id, which can run up to about 25 minutes before X's own value. Accounts created before about 2016 have ids without a timestamp, so their join date is left out only if that fetch fails or times out. Looks the account up by its handle. Costs 1 credit. */
+    getUserProfile(params: GetUserProfileParams): Promise<TwitterProfileResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/cjs/services/twitter/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/services/twitter/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAEnM,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,mrEAAmrE;IAC7qE,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAKjF,w4EAAw4E;IACl4E,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAK3E,s2EAAs2E;IACh2E,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAK3F,61EAA61E;IACv1E,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAIpF"}

package/dist/cjs/services/twitter/client.js

@@ -0,0 +1,32 @@
+"use strict";
+// Generated by generate-client from spec/openapi.json. Do not edit.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwitterClient = void 0;
+class TwitterClient {
+    base;
+    constructor(base) {
+        this.base = base;
+    }
+    /** An X (Twitter) Community as x.com shows it to logged-out visitors, as X's Community object in the shape Scrape Creators returns it: `rest_id`, name, description, member count, `created_at` (Unix milliseconds), join policy, topic, banners, rules, creator and member facepile. `tweets` adds the 20 community posts x.com ranks by likes, flattened the way Scrape Creators flattens community posts: the post's `legacy` fields plus `id`, `view_count` and the author as `user`. This is a fixed window: x.com offers no latest feed and no further pages logged-out. A logged-out viewer is not a member, so `is_member` is false and `role` is NonMember. `success`, `credits_charged` and `credits_remaining` (the wallet balance after this charge) sit at the top level of the body, as in Scrape Creators' answers. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. A post's author (`core.user_results.result`, or `user` on a community post) carries what x.com embeds with posts plus what only the author's profile page shows: `location`, the exact join date (`core.created_at`), the bio (`legacy.description` and `profile_bio`), the bio link (`legacy.url` and `legacy.entities`), the banner (`legacy.profile_banner_url`), `legacy.pinned_tweet_ids_str`, `legacy.possibly_sensitive` and `verification.verified`. They come from the author's profile in the same response when there is one, else from the author's profile page, fetched at no extra charge and cached for 2 minutes, so they can be up to 2 minutes old. Author profiles are best-effort. An author whose profile page fails or takes more than 8 seconds keeps only what x.com embeds, and its join date comes from the timestamp inside the user id, which can run up to about 25 minutes before X's own value. Accounts created before about 2016 have ids without a timestamp, so their join date is left out only if that fetch fails or times out. Costs 2 credits. */
+    async getCommunity(params) {
+        const { community_id } = params;
+        return this.base.get(`/v1/twitter/communities/${encodeURIComponent(community_id)}`);
+    }
+    /** One X (Twitter) post as x.com shows it to logged-out visitors, as X's Tweet object in the shape Scrape Creators returns it: `rest_id`, the author under `core.user_results.result`, `legacy` (full text, created time, counts, entities with every t.co link mapped, media with video variants and bitrates, reply and quote ids), `views`, `note_tweet` with the full text of a long post, `article`, `card`, `edit_control`, and the quoted post under `quoted_status_result`. `parent_tweets` holds the posts above a reply that x.com shows logged-out, oldest first; in samples that is only the post it replies to, so follow `legacy.in_reply_to_status_id_str` to walk further up. `replies` holds the top replies x.com shows logged-out (0 to 4 in samples, not every reply); x.com offers no further reply pages logged-out. Both lists hold Tweet objects plus their `url`. `success`, `credits_charged` and `credits_remaining` (the wallet balance after this charge) sit at the top level of the body, as in Scrape Creators' answers. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. A post's author (`core.user_results.result`, or `user` on a community post) carries what x.com embeds with posts plus what only the author's profile page shows: `location`, the exact join date (`core.created_at`), the bio (`legacy.description` and `profile_bio`), the bio link (`legacy.url` and `legacy.entities`), the banner (`legacy.profile_banner_url`), `legacy.pinned_tweet_ids_str`, `legacy.possibly_sensitive` and `verification.verified`. They come from the author's profile in the same response when there is one, else from the author's profile page, fetched at no extra charge and cached for 2 minutes, so they can be up to 2 minutes old. Author profiles are best-effort. An author whose profile page fails or takes more than 8 seconds keeps only what x.com embeds, and its join date comes from the timestamp inside the user id, which can run up to about 25 minutes before X's own value. Accounts created before about 2016 have ids without a timestamp, so their join date is left out only if that fetch fails or times out. Costs 1 credit. */
+    async getTweet(params) {
+        const { tweet_id } = params;
+        return this.base.get(`/v1/twitter/tweets/${encodeURIComponent(tweet_id)}`);
+    }
+    /** An X (Twitter) account's public profile as x.com shows it to logged-out visitors, as X's User object in the shape Scrape Creators returns it: `rest_id`, `core` (name, handle, join date), `legacy` (bio, follower, following and post counts, avatar, banner, bio link, pinned post id), `location`, `privacy`, `verification` and `is_blue_verified`. `pinned_tweet` and `tweets` add the pinned post and the newest original posts x.com shows logged-out (4 or 5 in samples) from the same page fetch, each an X Tweet object plus its `url`. This is a fixed window: x.com offers no further pages logged-out, so there is no cursor. A protected account returns its profile with no posts. Tapline caches each profile page for 2 minutes, so a profile and its posts can be up to 2 minutes old. `success`, `credits_charged` and `credits_remaining` (the wallet balance after this charge) sit at the top level of the body, as in Scrape Creators' answers. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. A post's author (`core.user_results.result`, or `user` on a community post) carries what x.com embeds with posts plus what only the author's profile page shows: `location`, the exact join date (`core.created_at`), the bio (`legacy.description` and `profile_bio`), the bio link (`legacy.url` and `legacy.entities`), the banner (`legacy.profile_banner_url`), `legacy.pinned_tweet_ids_str`, `legacy.possibly_sensitive` and `verification.verified`. They come from the author's profile in the same response when there is one, else from the author's profile page, fetched at no extra charge and cached for 2 minutes, so they can be up to 2 minutes old. Author profiles are best-effort. An author whose profile page fails or takes more than 8 seconds keeps only what x.com embeds, and its join date comes from the timestamp inside the user id, which can run up to about 25 minutes before X's own value. Accounts created before about 2016 have ids without a timestamp, so their join date is left out only if that fetch fails or times out. Looks the account up by its numeric user id. Costs 1 credit. */
+    async getUserProfileById(params) {
+        const { user_id } = params;
+        return this.base.get(`/v1/twitter/users/by-id/${encodeURIComponent(user_id)}`);
+    }
+    /** An X (Twitter) account's public profile as x.com shows it to logged-out visitors, as X's User object in the shape Scrape Creators returns it: `rest_id`, `core` (name, handle, join date), `legacy` (bio, follower, following and post counts, avatar, banner, bio link, pinned post id), `location`, `privacy`, `verification` and `is_blue_verified`. `pinned_tweet` and `tweets` add the pinned post and the newest original posts x.com shows logged-out (4 or 5 in samples) from the same page fetch, each an X Tweet object plus its `url`. This is a fixed window: x.com offers no further pages logged-out, so there is no cursor. A protected account returns its profile with no posts. Tapline caches each profile page for 2 minutes, so a profile and its posts can be up to 2 minutes old. `success`, `credits_charged` and `credits_remaining` (the wallet balance after this charge) sit at the top level of the body, as in Scrape Creators' answers. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. A post's author (`core.user_results.result`, or `user` on a community post) carries what x.com embeds with posts plus what only the author's profile page shows: `location`, the exact join date (`core.created_at`), the bio (`legacy.description` and `profile_bio`), the bio link (`legacy.url` and `legacy.entities`), the banner (`legacy.profile_banner_url`), `legacy.pinned_tweet_ids_str`, `legacy.possibly_sensitive` and `verification.verified`. They come from the author's profile in the same response when there is one, else from the author's profile page, fetched at no extra charge and cached for 2 minutes, so they can be up to 2 minutes old. Author profiles are best-effort. An author whose profile page fails or takes more than 8 seconds keeps only what x.com embeds, and its join date comes from the timestamp inside the user id, which can run up to about 25 minutes before X's own value. Accounts created before about 2016 have ids without a timestamp, so their join date is left out only if that fetch fails or times out. Looks the account up by its handle. Costs 1 credit. */
+    async getUserProfile(params) {
+        const { screen_name } = params;
+        return this.base.get(`/v1/twitter/users/${encodeURIComponent(screen_name)}`);
+    }
+}
+exports.TwitterClient = TwitterClient;
+//# sourceMappingURL=client.js.map

package/dist/cjs/services/twitter/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/services/twitter/client.ts"],"names":[],"mappings":";AAAA,oEAAoE;;;AAKpE,MAAa,aAAa;IACK;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,mrEAAmrE;IACnrE,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAA2B,2BAA2B,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAChH,CAAC;IAED,w4EAAw4E;IACx4E,KAAK,CAAC,QAAQ,CAAC,MAAsB;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAA6B,sBAAsB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,s2EAAs2E;IACt2E,KAAK,CAAC,kBAAkB,CAAC,MAAgC;QACvD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAyB,2BAA2B,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,61EAA61E;IAC71E,KAAK,CAAC,cAAc,CAAC,MAA4B;QAC/C,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAyB,qBAAqB,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC;CACF;AA1BD,sCA0BC"}

package/dist/cjs/services/twitter/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export { TwitterClient } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/services/twitter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/twitter/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/cjs/services/twitter/index.js

@@ -0,0 +1,22 @@
+"use strict";
+// Generated by generate-client from spec/openapi.json. Do not edit.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwitterClient = void 0;
+__exportStar(require("./types.js"), exports);
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "TwitterClient", { enumerable: true, get: function () { return client_js_1.TwitterClient; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/services/twitter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/twitter/index.ts"],"names":[],"mappings":";AAAA,oEAAoE;;;;;;;;;;;;;;;;;AAEpE,6CAA2B;AAC3B,yCAA4C;AAAnC,0GAAA,aAAa,OAAA"}