postiz 2.0.7 → 2.0.8

package/README.md

@@ -172,6 +172,26 @@ postiz posts:delete <post-id>
 
 ---
 
+### Analytics
+
+**Get platform analytics**
+```bash
+postiz analytics:platform <integration-id>
+postiz analytics:platform <integration-id> -d 30
+```
+
+Returns metrics like followers, impressions, and engagement over time for a specific integration/channel. The `-d` flag specifies the number of days to look back (default: 7).
+
+**Get post analytics**
+```bash
+postiz analytics:post <post-id>
+postiz analytics:post <post-id> -d 30
+```
+
+Returns metrics like likes, comments, shares, and impressions for a specific published post.
+
+---
+
 ### Media Upload
 
 **Upload file and get URL**
@@ -483,6 +503,8 @@ The CLI interacts with these Postiz API endpoints:
 | `/public/v1/integrations` | GET | List integrations |
 | `/public/v1/integration-settings/:id` | GET | Get integration settings |
 | `/public/v1/integration-trigger/:id` | POST | Trigger integration tool |
+| `/public/v1/analytics/:integration` | GET | Get platform analytics |
+| `/public/v1/analytics/post/:postId` | GET | Get post analytics |
 | `/public/v1/upload` | POST | Upload media |
 
 ---
@@ -528,6 +550,7 @@ src/
 └── commands/
     ├── posts.ts          # Post management commands
     ├── integrations.ts   # Integration commands
+    ├── analytics.ts      # Analytics commands
     └── upload.ts         # Media upload command
 examples/                 # Example scripts and JSON files
 package.json
@@ -583,6 +606,12 @@ postiz posts:list                                  # List posts
 postiz posts:delete <id>                          # Delete post
 postiz upload <file>                              # Upload media
 
+# Analytics
+postiz analytics:platform <id>                    # Platform analytics (7 days)
+postiz analytics:platform <id> -d 30             # Platform analytics (30 days)
+postiz analytics:post <id>                        # Post analytics (7 days)
+postiz analytics:post <id> -d 30                 # Post analytics (30 days)
+
 # Help
 postiz --help                                     # Show help
 postiz posts:create --help                        # Command help

package/SKILL.md

@@ -21,6 +21,7 @@ The fundamental pattern for using Postiz CLI:
 2. **Fetch** - Use integration tools to retrieve dynamic data (flairs, playlists, companies)
 3. **Prepare** - Upload media files if needed
 4. **Post** - Create posts with content, media, and platform-specific settings
+5. **Analyze** - Track performance with platform and post-level analytics
 
 ```bash
 # 1. Discover
@@ -35,6 +36,10 @@ postiz upload image.jpg
 
 # 4. Post
 postiz posts:create -c "Content" -m "image.jpg" -i "<integration-id>"
+
+# 5. Analyze
+postiz analytics:platform <integration-id> -d 30
+postiz analytics:post <post-id> -d 7
 ```
 
 ---
@@ -112,6 +117,24 @@ postiz posts:list --startDate "2024-01-01T00:00:00Z" --endDate "2024-12-31T23:59
 postiz posts:delete <post-id>
 ```
 
+### Analytics
+
+```bash
+# Get platform analytics (default: last 7 days)
+postiz analytics:platform <integration-id>
+
+# Get platform analytics for last 30 days
+postiz analytics:platform <integration-id> -d 30
+
+# Get post analytics (default: last 7 days)
+postiz analytics:post <post-id>
+
+# Get post analytics for last 30 days
+postiz analytics:post <post-id> -d 30
+```
+
+Returns an array of metrics (e.g. Followers, Impressions, Likes, Comments) with daily data points and percentage change over the period.
+
 ### Media Upload
 
 **⚠️ IMPORTANT:** Always upload files to Postiz before using them in posts. Many platforms (TikTok, Instagram, YouTube) **require verified URLs** and will reject external links.
@@ -608,6 +631,12 @@ postiz posts:list                                  # List posts
 postiz posts:delete <id>                          # Delete post
 postiz upload <file>                              # Upload media
 
+# Analytics
+postiz analytics:platform <id>                    # Platform analytics (7 days)
+postiz analytics:platform <id> -d 30             # Platform analytics (30 days)
+postiz analytics:post <id>                        # Post analytics (7 days)
+postiz analytics:post <id> -d 30                 # Post analytics (30 days)
+
 # Help
 postiz --help                                     # Show help
 postiz posts:create --help                        # Command help

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postiz",
-  "version": "2.0.7",
+  "version": "2.0.8",
   "description": "Postiz CLI - Command line interface for the Postiz social media scheduling API",
   "main": "dist/index.js",
   "bin": {