ugcinc 1.3.0 → 1.4.1

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 platform URL when complete - TikTok or Instagram)
+- Get posts with filters (by accountIds, postIds, date range)
 - Get post statistics
 
 ### Tasks
@@ -112,6 +113,47 @@ 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 platform URL
+    // TikTok: https://www.tiktok.com/@username/video/social_id
+    // Instagram: https://www.instagram.com/p/social_id/
+    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"
+  // Format depends on platform (TikTok or Instagram)
+  if (response.data.postUrl) {
+    console.log(`Post 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

@@ -82,6 +82,7 @@ export interface Post {
     media_urls: string[] | null;
     music_post_id: string | null;
     scheduled_at: string | null;
+    postUrl?: string;
 }
 export interface PostStat {
     id: string;
@@ -133,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.3.0",
+  "version": "1.4.1",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",