ugcinc 1.0.4 → 1.0.5

package/README.md

@@ -68,7 +68,7 @@ if (response.ok) {
 
 #### Refresh Account Statistics
 
-Fetch live statistics from TikTok API and create new stat records.
+Fetch live statistics from TikTok/Instagram API and create new stat records.
 
 ```typescript
 const response = await client.accounts.refreshStats({
@@ -220,7 +220,7 @@ if (response.ok) {
 
 #### Refresh Post Statistics
 
-Fetch live statistics from TikTok API and create new stat records.
+Fetch live statistics from TikTok/Instagram API and create new stat records.
 
 ```typescript
 const response = await client.posts.refreshStats({
@@ -461,7 +461,7 @@ const response = await client.accounts.getStats({
 
 #### `client.accounts.refreshStats(params?)`
 
-Refresh account statistics by fetching live data from TikTok API.
+Refresh account statistics by fetching live data from TikTok/Instagram API.
 
 **Endpoint:** `POST /accounts/stats/refresh`
 
@@ -476,10 +476,10 @@ Refresh account statistics by fetching live data from TikTok API.
 
 **Returns:** `ApiResponse<AccountStat[]>`
 
-Returns an array of newly created AccountStat objects with live data from TikTok. This endpoint fetches fresh statistics directly from the TikTok API and creates new stat records in the database. Use this when you need up-to-date metrics instead of historical data.
+Returns an array of newly created AccountStat objects with live data from TikTok or Instagram. This endpoint fetches fresh statistics directly from the platform APIs and creates new stat records in the database. Use this when you need up-to-date metrics instead of historical data. The API automatically determines which platform to query based on the account type.
 
 **Key Differences from `getStats()`:**
-- `refreshStats()` fetches **live data** from TikTok API and creates new records
+- `refreshStats()` fetches **live data** from TikTok/Instagram API and creates new records
 - `getStats()` retrieves **historical data** from your database
 
 **Example:**
@@ -687,7 +687,7 @@ Returns an array of Post objects (videos and slideshows) for the specified accou
   account_id: string;      // Account that posted this
   type: 'video' | 'slideshow';  // Post type
   status: string;          // Current post status
-  post_url: string | null;      // URL to the live post
+  social_id: string | null;     // Platform post ID (TikTok video ID or Instagram reel code)
   caption: string | null;       // Post caption/description
   media_urls: string[] | null;  // URLs to media files
   music_post_id: string | null; // Associated music/audio ID
@@ -700,7 +700,7 @@ Returns an array of Post objects (videos and slideshows) for the specified accou
 | `account_id` | `string` | ID of the account that created this post |
 | `type` | `'video' \| 'slideshow'` | Type of post content |
 | `status` | `string` | Current status: `'scheduled'`, `'pending'`, `'complete'`, or `'failed'` |
-| `post_url` | `string \| null` | URL to the live post on the platform (available after posting) |
+| `social_id` | `string \| null` | Platform-specific post ID (TikTok video ID or Instagram reel code, available after posting) |
 | `caption` | `string \| null` | Post caption/description text (max 500 characters) |
 | `media_urls` | `string[] \| null` | Array of URLs to video/image files used in the post |
 | `music_post_id` | `string \| null` | ID of the music/audio track used in the post |
@@ -855,7 +855,7 @@ if (response.ok) {
 
 #### `client.posts.refreshStats(params?)`
 
-Refresh post statistics by fetching live data from TikTok API.
+Refresh post statistics by fetching live data from TikTok/Instagram API.
 
 **Endpoint:** `POST /post/stats/refresh`
 
@@ -867,13 +867,13 @@ Refresh post statistics by fetching live data from TikTok API.
 
 **Returns:** `ApiResponse<PostStat[]>`
 
-Returns an array of newly created PostStat objects with live data from TikTok. This endpoint fetches fresh statistics directly from the TikTok API and creates new stat records in the database. Use this when you need up-to-date engagement metrics instead of historical data.
+Returns an array of newly created PostStat objects with live data from TikTok or Instagram. This endpoint fetches fresh statistics directly from the platform APIs and creates new stat records in the database. Use this when you need up-to-date engagement metrics instead of historical data. The API automatically determines which platform to query based on the account type.
 
 **Key Differences from `getStats()`:**
-- `refreshStats()` fetches **live data** from TikTok API and creates new records
+- `refreshStats()` fetches **live data** from TikTok/Instagram API and creates new records
 - `getStats()` retrieves **historical data** from your database
 
-**Important:** Posts must have a valid `post_url` to refresh statistics. The endpoint extracts the TikTok post ID from the URL to fetch live metrics.
+**Important:** Posts must have a valid `social_id` (TikTok video ID or Instagram reel code) to refresh statistics. The endpoint uses this ID to fetch live metrics from the platform.
 
 **Example:**
 

package/dist/accounts.d.ts

@@ -13,7 +13,7 @@ export declare class AccountsClient extends BaseClient {
      */
     getStats(params?: GetAccountStatsParams): Promise<ApiResponse<AccountStat[]>>;
     /**
-     * Refresh account statistics from TikTok API
+     * Refresh account statistics from TikTok/Instagram API
      */
     refreshStats(params?: RefreshAccountStatsParams): Promise<ApiResponse<AccountStat[]>>;
     /**

package/dist/accounts.js

@@ -19,7 +19,7 @@ class AccountsClient extends base_1.BaseClient {
         return this.post('/accounts/stats', params ?? {});
     }
     /**
-     * Refresh account statistics from TikTok API
+     * Refresh account statistics from TikTok/Instagram API
      */
     async refreshStats(params) {
         return this.post('/accounts/stats/refresh', params ?? {});

package/dist/posts.d.ts

@@ -17,7 +17,7 @@ export declare class PostsClient extends BaseClient {
      */
     getStats(params?: GetPostStatsParams): Promise<ApiResponse<PostStat[]>>;
     /**
-     * Refresh post statistics from TikTok API
+     * Refresh post statistics from TikTok/Instagram API
      */
     refreshStats(params?: RefreshPostStatsParams): Promise<ApiResponse<PostStat[]>>;
     /**

package/dist/posts.js

@@ -25,7 +25,7 @@ class PostsClient extends base_1.BaseClient {
         return this.post('/post/stats', params ?? {});
     }
     /**
-     * Refresh post statistics from TikTok API
+     * Refresh post statistics from TikTok/Instagram API
      */
     async refreshStats(params) {
         return this.post('/post/stats/refresh', params ?? {});

package/dist/types.d.ts

@@ -75,7 +75,7 @@ export interface Post {
     account_id: string;
     type: PostType;
     status: string;
-    post_url: string | null;
+    social_id: string | null;
     caption: string | null;
     media_urls: string[] | null;
     music_post_id: string | null;

package/package.json

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