ugcinc 1.2.2 → 1.4.0

package/README.md

@@ -52,7 +52,8 @@ For complete API documentation, including all endpoints, parameters, and example
 ### Posts
 - Create video posts
 - Create slideshow posts
-- Get post status
+- Get post status (includes TikTok URL when complete)
+- Get posts with filters (by accountIds, postIds, date range)
 - Get post statistics
 
 ### Tasks
@@ -112,6 +113,44 @@ const response = await client.posts.createVideo({
 });
 ```
 
+**Get posts with filters:**
+```typescript
+// Get specific posts by ID
+const response = await client.posts.getPosts({
+  postIds: ['post-uuid-1', 'post-uuid-2']
+});
+
+// Get posts by account
+const response = await client.posts.getPosts({
+  accountIds: ['account-uuid']
+});
+
+if (response.ok) {
+  response.data.forEach(post => {
+    console.log(`Post ${post.id}: ${post.status}`);
+    // For complete posts, postUrl will contain the TikTok video link
+    if (post.postUrl) {
+      console.log(`Watch at: ${post.postUrl}`);
+    }
+  });
+}
+```
+
+**Check post status:**
+```typescript
+const response = await client.posts.getStatus({
+  postId: 'post-uuid'
+});
+
+if (response.ok) {
+  console.log(`Status: ${response.data.status}`);
+  // postUrl is available when status is "complete"
+  if (response.data.postUrl) {
+    console.log(`TikTok URL: ${response.data.postUrl}`);
+  }
+}
+```
+
 ## TypeScript Support
 
 This package is written in TypeScript and provides full type definitions:

package/dist/posts.d.ts

@@ -18,6 +18,7 @@ export declare class PostsClient extends BaseClient {
     getStatus(params: GetPostStatusParams): Promise<ApiResponse<{
         post_id: string;
         status: string;
+        postUrl?: string;
     }>>;
     /**
      * Create a video post

package/dist/types.d.ts

@@ -81,6 +81,8 @@ export interface Post {
     caption: string | null;
     media_urls: string[] | null;
     music_post_id: string | null;
+    scheduled_at: string | null;
+    postUrl?: string;
 }
 export interface PostStat {
     id: string;
@@ -132,6 +134,7 @@ export interface GetTasksParams {
 }
 export interface GetPostsParams {
     accountIds?: string[];
+    postIds?: string[];
     startDate?: string;
     endDate?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc",
-  "version": "1.2.2",
+  "version": "1.4.0",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",