@xpoz/xpoz 0.4.1 → 0.6.5

package/README.md

@@ -200,7 +200,7 @@ The following methods accept both `responseType` and `limit`:
 - `twitter.getPostsByAuthor()`, `twitter.searchPosts()`, `twitter.getUsersByKeywords()`
 - `instagram.getPostsByUser()`, `instagram.searchPosts()`, `instagram.getUsersByKeywords()`
 - `reddit.searchPosts()`
-- `tiktok.getPostsByUser()`, `tiktok.searchPosts()`, `tiktok.getUsersByKeywords()`
+- `tiktok.getPostsByUser()`, `tiktok.searchPosts()`, `tiktok.getUsersByKeywords()`, `tiktok.getPostsByHashtags()`, `tiktok.getUsersByHashtags()`
 
 These methods accept `limit` only:
 
@@ -640,6 +640,28 @@ const results = await client.tiktok.searchPosts("travel vlog", {
 });
 ```
 
+#### `getPostsByHashtags(hashtags, options?) -> Promise<PaginatedResult<TiktokPost>>`
+
+Search posts by hashtags via the indexed `hashtags` column. Pass bare alphanumeric tags (no leading `#`). Max 5 hashtags per request; OR semantics across the list.
+
+```typescript
+const results = await client.tiktok.getPostsByHashtags(["dance", "fyp"], {
+  responseType: ResponseType.Fast,
+  limit: 50,
+});
+```
+
+#### `getUsersByHashtags(hashtags, options?) -> Promise<PaginatedResult<TiktokUser>>`
+
+Find users who authored posts tagged with the given hashtags. Same input rules as `getPostsByHashtags`.
+
+```typescript
+const users = await client.tiktok.getUsersByHashtags(["sustainable_fashion"], {
+  responseType: ResponseType.Fast,
+  limit: 20,
+});
+```
+
 #### `getComments(postId, options?) -> Promise<PaginatedResult<TiktokComment>>`
 
 ```typescript
@@ -870,6 +892,9 @@ All fields are optional and typed as their respective TypeScript types. Unknown
 | `downloadCount`              | `number`  | Number of downloads          |
 | `forwardCount`               | `number`  | Number of forwards/shares    |
 | `videoThumbnail`             | `string`  | Thumbnail URL                |
+| `videoUrl`                   | `string[]` | Array of video URLs         |
+| `duration`                   | `number`  | Video duration in seconds    |
+| `hashtags`                   | `string[]` | Hashtags in the post        |
 | `postType`                   | `number`  | Post type code               |
 | `isPrivate`                  | `boolean` | Private post flag            |
 | `createdAt`                  | `string`  | Creation timestamp           |

package/dist/index.cjs

@@ -31,6 +31,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AuthenticationError: () => AuthenticationError,
+  BillingPeriod: () => BillingPeriod,
+  CreditResetFrequency: () => CreditResetFrequency,
   OperationCancelledError: () => OperationCancelledError,
   OperationFailedError: () => OperationFailedError,
   OperationTimeoutError: () => OperationTimeoutError,
@@ -296,7 +298,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.4.1";
+var VERSION = "0.6.5";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -629,13 +631,16 @@ var GET_REDDIT_SUBREDDITS_BY_KEYWORDS = "getRedditSubredditsByKeywords";
 var GET_TIKTOK_POSTS_BY_IDS = "getTiktokPostsByIds";
 var GET_TIKTOK_POSTS_BY_USER = "getTiktokPostsByUser";
 var SEARCH_TIKTOK_POSTS = "getTiktokPostsByKeywords";
+var GET_TIKTOK_POSTS_BY_HASHTAGS = "getTiktokPostsByHashtags";
 var GET_TIKTOK_COMMENTS = "getTiktokCommentsByPostId";
 var GET_TIKTOK_USER = "getTiktokUser";
 var SEARCH_TIKTOK_USERS = "searchTiktokUsers";
 var GET_TIKTOK_USERS_BY_KEYWORDS = "getTiktokUsersByKeywords";
+var GET_TIKTOK_USERS_BY_HASHTAGS = "getTiktokUsersByHashtags";
 var GET_TRACKED_ITEMS = "getTrackedItems";
 var ADD_TRACKED_ITEMS = "addTrackedItems";
 var REMOVE_TRACKED_ITEMS = "removeTrackedItems";
+var GET_ACCOUNT_DETAILS = "getAccountDetails";
 
 // src/namespaces/twitter.ts
 function parseTwitterPost(item) {
@@ -790,7 +795,8 @@ var TwitterNamespace = class extends BaseNamespace {
     const args = this.buildArgs({
       identifier,
       identifierType: options.identifierType ?? "username",
-      fields: options.fields
+      fields: options.fields,
+      forceLatest: options.forceLatest
     });
     const result = await this.callAndMaybePoll(GET_TWITTER_USER, args);
     const results = result["results"];
@@ -892,7 +898,8 @@ var InstagramNamespace = class extends BaseNamespace {
     const args = this.buildArgs({
       identifier,
       identifierType: options.identifierType ?? "username",
-      fields: options.fields
+      fields: options.fields,
+      forceLatest: options.forceLatest
     });
     const result = await this.callAndMaybePoll(GET_INSTAGRAM_USER, args);
     const results = result["results"];
@@ -1103,7 +1110,8 @@ var TiktokNamespace = class extends BaseNamespace {
     const args = this.buildArgs({
       identifier,
       identifierType: options.identifierType ?? "username",
-      fields: options.fields
+      fields: options.fields,
+      forceLatest: options.forceLatest
     });
     const result = await this.callAndMaybePoll(GET_TIKTOK_USER, args);
     const results = result["results"];
@@ -1127,13 +1135,33 @@ var TiktokNamespace = class extends BaseNamespace {
       args
     );
   }
+  async getPostsByHashtags(hashtags, options = {}) {
+    const args = this.buildArgs({ hashtags, ...options });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_POSTS_BY_HASHTAGS, args);
+    return this.buildPaginatedResult(
+      result,
+      parsePost3,
+      GET_TIKTOK_POSTS_BY_HASHTAGS,
+      args
+    );
+  }
+  async getUsersByHashtags(hashtags, options = {}) {
+    const args = this.buildArgs({ hashtags, ...options });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_USERS_BY_HASHTAGS, args);
+    return this.buildPaginatedResult(
+      result,
+      parseUser4,
+      GET_TIKTOK_USERS_BY_HASHTAGS,
+      args
+    );
+  }
 };
 
 // src/namespaces/tracking.ts
 var TrackingNamespace = class extends BaseNamespace {
   async getTrackedItems() {
     const result = await this.callTool(GET_TRACKED_ITEMS, {});
-    return result["data"] ?? [];
+    return result["results"] ?? [];
   }
   async addTrackedItems(items) {
     const args = this.buildArgs({ items });
@@ -1147,6 +1175,14 @@ var TrackingNamespace = class extends BaseNamespace {
   }
 };
 
+// src/namespaces/account.ts
+var AccountNamespace = class extends BaseNamespace {
+  async getAccountDetails() {
+    const result = await this.callTool(GET_ACCOUNT_DETAILS, {});
+    return result["data"];
+  }
+};
+
 // src/versionCheck.ts
 var NPM_REGISTRY_URL = "https://registry.npmjs.org/@xpoz/xpoz/latest";
 var CHECK_TIMEOUT_MS = 3e3;
@@ -1194,6 +1230,7 @@ var XpozClient = class {
   reddit;
   tiktok;
   tracking;
+  account;
   transport;
   versionCheck;
   constructor(options = {}) {
@@ -1213,6 +1250,7 @@ var XpozClient = class {
     this.reddit = new RedditNamespace(callTool, timeoutMs);
     this.tiktok = new TiktokNamespace(callTool, timeoutMs);
     this.tracking = new TrackingNamespace(callTool, timeoutMs);
+    this.account = new AccountNamespace(callTool, timeoutMs);
   }
   async connect() {
     await this.transport.connect();
@@ -1233,6 +1271,7 @@ var TrackedItemType = /* @__PURE__ */ ((TrackedItemType2) => {
   TrackedItemType2["Keyword"] = "keyword";
   TrackedItemType2["User"] = "user";
   TrackedItemType2["Subreddit"] = "subreddit";
+  TrackedItemType2["Hashtag"] = "hashtag";
   return TrackedItemType2;
 })(TrackedItemType || {});
 var TrackedItemPlatform = /* @__PURE__ */ ((TrackedItemPlatform2) => {
@@ -1242,9 +1281,23 @@ var TrackedItemPlatform = /* @__PURE__ */ ((TrackedItemPlatform2) => {
   TrackedItemPlatform2["TikTok"] = "tiktok";
   return TrackedItemPlatform2;
 })(TrackedItemPlatform || {});
+
+// src/types/account.ts
+var BillingPeriod = /* @__PURE__ */ ((BillingPeriod2) => {
+  BillingPeriod2["Monthly"] = "monthly";
+  BillingPeriod2["Annual"] = "annual";
+  return BillingPeriod2;
+})(BillingPeriod || {});
+var CreditResetFrequency = /* @__PURE__ */ ((CreditResetFrequency2) => {
+  CreditResetFrequency2["Monthly"] = "monthly";
+  CreditResetFrequency2["Never"] = "never";
+  return CreditResetFrequency2;
+})(CreditResetFrequency || {});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,
+  BillingPeriod,
+  CreditResetFrequency,
   OperationCancelledError,
   OperationFailedError,
   OperationTimeoutError,

package/dist/index.d.cts

@@ -191,6 +191,7 @@ declare class TwitterNamespace extends BaseNamespace {
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<TwitterUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -199,6 +200,8 @@ declare class TwitterNamespace extends BaseNamespace {
     getUserConnections(username: string, connectionType: string, options?: {
         fields?: string[];
         forceLatest?: boolean;
+        responseType?: ResponseType;
+        limit?: number;
     }): Promise<PaginatedResult<TwitterUser>>;
     getUsersByKeywords(query: string, options?: {
         fields?: string[];
@@ -315,6 +318,7 @@ declare class InstagramNamespace extends BaseNamespace {
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<InstagramUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -495,6 +499,7 @@ declare class RedditNamespace extends BaseNamespace {
     }): Promise<PaginatedResult<RedditComment>>;
     getUser(username: string, options?: {
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<RedditUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -542,6 +547,9 @@ interface TiktokPost {
     downloadCount?: number | null;
     forwardCount?: number | null;
     playCount?: number | null;
+    hashtags?: string[] | null;
+    duration?: number | null;
+    videoUrl?: string[] | null;
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
@@ -616,6 +624,7 @@ declare class TiktokNamespace extends BaseNamespace {
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<TiktokUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -629,12 +638,29 @@ declare class TiktokNamespace extends BaseNamespace {
         responseType?: ResponseType;
         limit?: number;
     }): Promise<PaginatedResult<TiktokUser>>;
+    getPostsByHashtags(hashtags: string[], options?: {
+        fields?: string[];
+        startDate?: string;
+        endDate?: string;
+        forceLatest?: boolean;
+        responseType?: ResponseType;
+        limit?: number;
+    }): Promise<PaginatedResult<TiktokPost>>;
+    getUsersByHashtags(hashtags: string[], options?: {
+        fields?: string[];
+        startDate?: string;
+        endDate?: string;
+        forceLatest?: boolean;
+        responseType?: ResponseType;
+        limit?: number;
+    }): Promise<PaginatedResult<TiktokUser>>;
 }
 
 declare enum TrackedItemType {
     Keyword = "keyword",
     User = "user",
-    Subreddit = "subreddit"
+    Subreddit = "subreddit",
+    Hashtag = "hashtag"
 }
 declare enum TrackedItemPlatform {
     Twitter = "twitter",
@@ -667,12 +693,53 @@ declare class TrackingNamespace extends BaseNamespace {
     removeTrackedItems(items: TrackedItem[]): Promise<RemoveTrackedItemsResult>;
 }
 
+declare enum BillingPeriod {
+    Monthly = "monthly",
+    Annual = "annual"
+}
+declare enum CreditResetFrequency {
+    Monthly = "monthly",
+    Never = "never"
+}
+interface PlanFeatures {
+    credits: number;
+    creditResetFrequency: CreditResetFrequency;
+    extraCreditPrice: number;
+    trackedItems?: number;
+    csvRowExportLimit: number;
+    extraCsvRowPrice: number;
+    extraTrackedItemPrice?: number;
+    maxRowsPerExport?: number;
+}
+interface AccountBilling {
+    billingPeriod: BillingPeriod;
+    nextRenewalDate: string | null;
+}
+interface AccountUsage {
+    subscriptionCreditsRemaining: number;
+    extraCreditsRemaining: number;
+    extraTrackedItems: number;
+}
+interface AccountDetails {
+    plan: {
+        name: string;
+        features: PlanFeatures;
+    };
+    billing: AccountBilling | null;
+    usage: AccountUsage;
+}
+
+declare class AccountNamespace extends BaseNamespace {
+    getAccountDetails(): Promise<AccountDetails>;
+}
+
 declare class XpozClient {
     twitter: TwitterNamespace;
     instagram: InstagramNamespace;
     reddit: RedditNamespace;
     tiktok: TiktokNamespace;
     tracking: TrackingNamespace;
+    account: AccountNamespace;
     private transport;
     private versionCheck;
     constructor(options?: {
@@ -710,8 +777,8 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.4.1";
+declare const VERSION = "0.6.5";
 
 declare function checkForUpdates(): Promise<void>;
 
-export { type AddTrackedItemsResult, AuthenticationError, type InstagramComment, type InstagramPost, type InstagramUser, OperationCancelledError, OperationFailedError, OperationTimeoutError, PaginatedResult, type PaginationInfo, type RedditComment, type RedditPost, type RedditPostWithComments, type RedditSubreddit, type RedditUser, type RemoveTrackedItemsResult, ResponseType, type SubredditWithPosts, type TiktokComment, type TiktokPost, type TiktokUser, type TrackedItem, TrackedItemPlatform, TrackedItemType, type TwitterPost, type TwitterUser, VERSION, XpozClient, XpozConnectionError, XpozError, checkForUpdates };
+export { type AccountBilling, type AccountDetails, type AccountUsage, type AddTrackedItemsResult, AuthenticationError, BillingPeriod, CreditResetFrequency, type InstagramComment, type InstagramPost, type InstagramUser, OperationCancelledError, OperationFailedError, OperationTimeoutError, PaginatedResult, type PaginationInfo, type PlanFeatures, type RedditComment, type RedditPost, type RedditPostWithComments, type RedditSubreddit, type RedditUser, type RemoveTrackedItemsResult, ResponseType, type SubredditWithPosts, type TiktokComment, type TiktokPost, type TiktokUser, type TrackedItem, TrackedItemPlatform, TrackedItemType, type TwitterPost, type TwitterUser, VERSION, XpozClient, XpozConnectionError, XpozError, checkForUpdates };

package/dist/index.d.ts

@@ -191,6 +191,7 @@ declare class TwitterNamespace extends BaseNamespace {
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<TwitterUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -199,6 +200,8 @@ declare class TwitterNamespace extends BaseNamespace {
     getUserConnections(username: string, connectionType: string, options?: {
         fields?: string[];
         forceLatest?: boolean;
+        responseType?: ResponseType;
+        limit?: number;
     }): Promise<PaginatedResult<TwitterUser>>;
     getUsersByKeywords(query: string, options?: {
         fields?: string[];
@@ -315,6 +318,7 @@ declare class InstagramNamespace extends BaseNamespace {
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<InstagramUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -495,6 +499,7 @@ declare class RedditNamespace extends BaseNamespace {
     }): Promise<PaginatedResult<RedditComment>>;
     getUser(username: string, options?: {
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<RedditUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -542,6 +547,9 @@ interface TiktokPost {
     downloadCount?: number | null;
     forwardCount?: number | null;
     playCount?: number | null;
+    hashtags?: string[] | null;
+    duration?: number | null;
+    videoUrl?: string[] | null;
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
@@ -616,6 +624,7 @@ declare class TiktokNamespace extends BaseNamespace {
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<TiktokUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -629,12 +638,29 @@ declare class TiktokNamespace extends BaseNamespace {
         responseType?: ResponseType;
         limit?: number;
     }): Promise<PaginatedResult<TiktokUser>>;
+    getPostsByHashtags(hashtags: string[], options?: {
+        fields?: string[];
+        startDate?: string;
+        endDate?: string;
+        forceLatest?: boolean;
+        responseType?: ResponseType;
+        limit?: number;
+    }): Promise<PaginatedResult<TiktokPost>>;
+    getUsersByHashtags(hashtags: string[], options?: {
+        fields?: string[];
+        startDate?: string;
+        endDate?: string;
+        forceLatest?: boolean;
+        responseType?: ResponseType;
+        limit?: number;
+    }): Promise<PaginatedResult<TiktokUser>>;
 }
 
 declare enum TrackedItemType {
     Keyword = "keyword",
     User = "user",
-    Subreddit = "subreddit"
+    Subreddit = "subreddit",
+    Hashtag = "hashtag"
 }
 declare enum TrackedItemPlatform {
     Twitter = "twitter",
@@ -667,12 +693,53 @@ declare class TrackingNamespace extends BaseNamespace {
     removeTrackedItems(items: TrackedItem[]): Promise<RemoveTrackedItemsResult>;
 }
 
+declare enum BillingPeriod {
+    Monthly = "monthly",
+    Annual = "annual"
+}
+declare enum CreditResetFrequency {
+    Monthly = "monthly",
+    Never = "never"
+}
+interface PlanFeatures {
+    credits: number;
+    creditResetFrequency: CreditResetFrequency;
+    extraCreditPrice: number;
+    trackedItems?: number;
+    csvRowExportLimit: number;
+    extraCsvRowPrice: number;
+    extraTrackedItemPrice?: number;
+    maxRowsPerExport?: number;
+}
+interface AccountBilling {
+    billingPeriod: BillingPeriod;
+    nextRenewalDate: string | null;
+}
+interface AccountUsage {
+    subscriptionCreditsRemaining: number;
+    extraCreditsRemaining: number;
+    extraTrackedItems: number;
+}
+interface AccountDetails {
+    plan: {
+        name: string;
+        features: PlanFeatures;
+    };
+    billing: AccountBilling | null;
+    usage: AccountUsage;
+}
+
+declare class AccountNamespace extends BaseNamespace {
+    getAccountDetails(): Promise<AccountDetails>;
+}
+
 declare class XpozClient {
     twitter: TwitterNamespace;
     instagram: InstagramNamespace;
     reddit: RedditNamespace;
     tiktok: TiktokNamespace;
     tracking: TrackingNamespace;
+    account: AccountNamespace;
     private transport;
     private versionCheck;
     constructor(options?: {
@@ -710,8 +777,8 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.4.1";
+declare const VERSION = "0.6.5";
 
 declare function checkForUpdates(): Promise<void>;
 
-export { type AddTrackedItemsResult, AuthenticationError, type InstagramComment, type InstagramPost, type InstagramUser, OperationCancelledError, OperationFailedError, OperationTimeoutError, PaginatedResult, type PaginationInfo, type RedditComment, type RedditPost, type RedditPostWithComments, type RedditSubreddit, type RedditUser, type RemoveTrackedItemsResult, ResponseType, type SubredditWithPosts, type TiktokComment, type TiktokPost, type TiktokUser, type TrackedItem, TrackedItemPlatform, TrackedItemType, type TwitterPost, type TwitterUser, VERSION, XpozClient, XpozConnectionError, XpozError, checkForUpdates };
+export { type AccountBilling, type AccountDetails, type AccountUsage, type AddTrackedItemsResult, AuthenticationError, BillingPeriod, CreditResetFrequency, type InstagramComment, type InstagramPost, type InstagramUser, OperationCancelledError, OperationFailedError, OperationTimeoutError, PaginatedResult, type PaginationInfo, type PlanFeatures, type RedditComment, type RedditPost, type RedditPostWithComments, type RedditSubreddit, type RedditUser, type RemoveTrackedItemsResult, ResponseType, type SubredditWithPosts, type TiktokComment, type TiktokPost, type TiktokUser, type TrackedItem, TrackedItemPlatform, TrackedItemType, type TwitterPost, type TwitterUser, VERSION, XpozClient, XpozConnectionError, XpozError, checkForUpdates };

package/dist/index.js

@@ -248,7 +248,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.4.1";
+var VERSION = "0.6.5";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -581,13 +581,16 @@ var GET_REDDIT_SUBREDDITS_BY_KEYWORDS = "getRedditSubredditsByKeywords";
 var GET_TIKTOK_POSTS_BY_IDS = "getTiktokPostsByIds";
 var GET_TIKTOK_POSTS_BY_USER = "getTiktokPostsByUser";
 var SEARCH_TIKTOK_POSTS = "getTiktokPostsByKeywords";
+var GET_TIKTOK_POSTS_BY_HASHTAGS = "getTiktokPostsByHashtags";
 var GET_TIKTOK_COMMENTS = "getTiktokCommentsByPostId";
 var GET_TIKTOK_USER = "getTiktokUser";
 var SEARCH_TIKTOK_USERS = "searchTiktokUsers";
 var GET_TIKTOK_USERS_BY_KEYWORDS = "getTiktokUsersByKeywords";
+var GET_TIKTOK_USERS_BY_HASHTAGS = "getTiktokUsersByHashtags";
 var GET_TRACKED_ITEMS = "getTrackedItems";
 var ADD_TRACKED_ITEMS = "addTrackedItems";
 var REMOVE_TRACKED_ITEMS = "removeTrackedItems";
+var GET_ACCOUNT_DETAILS = "getAccountDetails";
 
 // src/namespaces/twitter.ts
 function parseTwitterPost(item) {
@@ -742,7 +745,8 @@ var TwitterNamespace = class extends BaseNamespace {
     const args = this.buildArgs({
       identifier,
       identifierType: options.identifierType ?? "username",
-      fields: options.fields
+      fields: options.fields,
+      forceLatest: options.forceLatest
     });
     const result = await this.callAndMaybePoll(GET_TWITTER_USER, args);
     const results = result["results"];
@@ -844,7 +848,8 @@ var InstagramNamespace = class extends BaseNamespace {
     const args = this.buildArgs({
       identifier,
       identifierType: options.identifierType ?? "username",
-      fields: options.fields
+      fields: options.fields,
+      forceLatest: options.forceLatest
     });
     const result = await this.callAndMaybePoll(GET_INSTAGRAM_USER, args);
     const results = result["results"];
@@ -1055,7 +1060,8 @@ var TiktokNamespace = class extends BaseNamespace {
     const args = this.buildArgs({
       identifier,
       identifierType: options.identifierType ?? "username",
-      fields: options.fields
+      fields: options.fields,
+      forceLatest: options.forceLatest
     });
     const result = await this.callAndMaybePoll(GET_TIKTOK_USER, args);
     const results = result["results"];
@@ -1079,13 +1085,33 @@ var TiktokNamespace = class extends BaseNamespace {
       args
     );
   }
+  async getPostsByHashtags(hashtags, options = {}) {
+    const args = this.buildArgs({ hashtags, ...options });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_POSTS_BY_HASHTAGS, args);
+    return this.buildPaginatedResult(
+      result,
+      parsePost3,
+      GET_TIKTOK_POSTS_BY_HASHTAGS,
+      args
+    );
+  }
+  async getUsersByHashtags(hashtags, options = {}) {
+    const args = this.buildArgs({ hashtags, ...options });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_USERS_BY_HASHTAGS, args);
+    return this.buildPaginatedResult(
+      result,
+      parseUser4,
+      GET_TIKTOK_USERS_BY_HASHTAGS,
+      args
+    );
+  }
 };
 
 // src/namespaces/tracking.ts
 var TrackingNamespace = class extends BaseNamespace {
   async getTrackedItems() {
     const result = await this.callTool(GET_TRACKED_ITEMS, {});
-    return result["data"] ?? [];
+    return result["results"] ?? [];
   }
   async addTrackedItems(items) {
     const args = this.buildArgs({ items });
@@ -1099,6 +1125,14 @@ var TrackingNamespace = class extends BaseNamespace {
   }
 };
 
+// src/namespaces/account.ts
+var AccountNamespace = class extends BaseNamespace {
+  async getAccountDetails() {
+    const result = await this.callTool(GET_ACCOUNT_DETAILS, {});
+    return result["data"];
+  }
+};
+
 // src/versionCheck.ts
 var NPM_REGISTRY_URL = "https://registry.npmjs.org/@xpoz/xpoz/latest";
 var CHECK_TIMEOUT_MS = 3e3;
@@ -1146,6 +1180,7 @@ var XpozClient = class {
   reddit;
   tiktok;
   tracking;
+  account;
   transport;
   versionCheck;
   constructor(options = {}) {
@@ -1165,6 +1200,7 @@ var XpozClient = class {
     this.reddit = new RedditNamespace(callTool, timeoutMs);
     this.tiktok = new TiktokNamespace(callTool, timeoutMs);
     this.tracking = new TrackingNamespace(callTool, timeoutMs);
+    this.account = new AccountNamespace(callTool, timeoutMs);
   }
   async connect() {
     await this.transport.connect();
@@ -1185,6 +1221,7 @@ var TrackedItemType = /* @__PURE__ */ ((TrackedItemType2) => {
   TrackedItemType2["Keyword"] = "keyword";
   TrackedItemType2["User"] = "user";
   TrackedItemType2["Subreddit"] = "subreddit";
+  TrackedItemType2["Hashtag"] = "hashtag";
   return TrackedItemType2;
 })(TrackedItemType || {});
 var TrackedItemPlatform = /* @__PURE__ */ ((TrackedItemPlatform2) => {
@@ -1194,8 +1231,22 @@ var TrackedItemPlatform = /* @__PURE__ */ ((TrackedItemPlatform2) => {
   TrackedItemPlatform2["TikTok"] = "tiktok";
   return TrackedItemPlatform2;
 })(TrackedItemPlatform || {});
+
+// src/types/account.ts
+var BillingPeriod = /* @__PURE__ */ ((BillingPeriod2) => {
+  BillingPeriod2["Monthly"] = "monthly";
+  BillingPeriod2["Annual"] = "annual";
+  return BillingPeriod2;
+})(BillingPeriod || {});
+var CreditResetFrequency = /* @__PURE__ */ ((CreditResetFrequency2) => {
+  CreditResetFrequency2["Monthly"] = "monthly";
+  CreditResetFrequency2["Never"] = "never";
+  return CreditResetFrequency2;
+})(CreditResetFrequency || {});
 export {
   AuthenticationError,
+  BillingPeriod,
+  CreditResetFrequency,
   OperationCancelledError,
   OperationFailedError,
   OperationTimeoutError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpoz/xpoz",
-  "version": "0.4.1",
+  "version": "0.6.5",
   "description": "TypeScript SDK for the Xpoz social media intelligence platform",
   "type": "module",
   "main": "./dist/index.cjs",