@xpoz/xpoz 0.4.1 → 0.4.2

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

@@ -296,7 +296,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.4.1";
+var VERSION = "0.4.2";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -629,10 +629,12 @@ 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";
@@ -1127,6 +1129,26 @@ 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

package/dist/index.d.cts

@@ -199,6 +199,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[];
@@ -542,6 +544,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;
@@ -629,6 +634,22 @@ 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 {
@@ -710,7 +731,7 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.4.1";
+declare const VERSION = "0.4.2";
 
 declare function checkForUpdates(): Promise<void>;
 

package/dist/index.d.ts

@@ -199,6 +199,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[];
@@ -542,6 +544,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;
@@ -629,6 +634,22 @@ 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 {
@@ -710,7 +731,7 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.4.1";
+declare const VERSION = "0.4.2";
 
 declare function checkForUpdates(): Promise<void>;
 

package/dist/index.js

@@ -248,7 +248,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.4.1";
+var VERSION = "0.4.2";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -581,10 +581,12 @@ 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";
@@ -1079,6 +1081,26 @@ 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

package/package.json

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