@apteva/integrations 0.3.10 → 0.3.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apteva/integrations",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "description": "Local integrations, connections, and webhooks for Apteva. Self-contained app templates, OAuth engine, and trigger provider.",
   "author": "Apteva <hello@apteva.com>",
   "license": "Elastic-2.0",

package/src/apps/socialcast.json

@@ -205,7 +205,7 @@
     },
     {
       "name": "create_post",
-      "description": "Create and publish a post to one or more connected social media platforms simultaneously. Supports text, images, videos, and links. To schedule a post for later, set scheduled_for to an ISO 8601 timestamp and optionally timezone (e.g., 'America/New_York'). Platform-specific overrides allow customizing content per platform (e.g., Reddit title, YouTube description, TikTok privacy).",
+      "description": "Create and publish a post to one or more connected social media platforms simultaneously. Supports text, images, videos, and links.\n\nMedia capabilities per platform:\n- Instagram: Single image, single video (Reel), or CAROUSEL (2-10 images/videos mixed). Pass multiple items in media_urls for carousel.\n- Facebook: Text, single image, MULTI-PHOTO (2+ images posted as album), single video, or link post.\n- Twitter/X: Text with up to 4 media attachments (images, GIFs, or 1 video). Media is uploaded automatically.\n- TikTok: Single video or PHOTO CAROUSEL (up to 35 images). Use overrides for privacy, comments, music.\n- YouTube: Single video upload with title, description, tags, privacy.\n- Pinterest: Single image with title, description, board, and link.\n- Reddit: Text (self) or link post to a subreddit.\n- LinkedIn: Text post with optional visibility setting.\n- Telegram: Text or single image with optional parse mode.\n\nTo schedule a post for later, set scheduled_for to an ISO 8601 timestamp and optionally timezone (e.g., 'America/New_York').",
       "method": "POST",
       "path": "/posts",
       "input_schema": {
@@ -217,7 +217,7 @@
           },
           "media_urls": {
             "type": "array",
-            "description": "Media attachments — array of objects with url, type (image/video), and optional alt_text",
+            "description": "Media attachments. Pass multiple images for carousel/album posts (Instagram up to 10, Facebook unlimited, TikTok up to 35). Each item needs url, type (image/video), and optional alt_text.",
             "items": {
               "type": "object",
               "properties": {
@@ -266,7 +266,7 @@
           },
           "platform_overrides": {
             "type": "object",
-            "description": "Per-platform overrides keyed by platform name. Only include platforms you want to customize. Available fields per platform: youtube: {title, description, tags (array), privacyStatus (public/unlisted/private), categoryId (default 22=People & Blogs)}. reddit: {title, subreddit, text, nsfw}. pinterest: {title, description, board_id}. tiktok: {title, text, privacyLevel}. linkedin: {text, visibility}. facebook: {text, title (video only)}. twitter: {text}. instagram: {text}. telegram: {text, chatId, parseMode}. All fields are optional — omitted fields fall back to the main post text.",
+            "description": "Per-platform overrides keyed by platform name. Only include platforms you want to customize. Available fields per platform: youtube: {title, description, tags (array), privacyStatus (public/unlisted/private), categoryId}. reddit: {title, subreddit, text, nsfw}. pinterest: {title, description, board_id}. tiktok: {title, text, privacyLevel (PUBLIC_TO_EVERYONE/MUTUAL_FOLLOW_FRIENDS/FOLLOWER_OF_CREATOR/SELF_ONLY), disableComment (bool), autoAddMusic (bool)}. linkedin: {text, visibility}. facebook: {text, title (video only)}. twitter: {text}. instagram: {text}. telegram: {text, chatId, parseMode}. All fields are optional — omitted fields fall back to the main post text.",
             "properties": {
               "twitter": {
                 "type": "object"
@@ -447,7 +447,7 @@
     },
     {
       "name": "get_post_analytics",
-      "description": "Fetch analytics and engagement metrics for a published post across all platforms. Returns impressions, reach, likes, comments, shares, views, saves, and clicks where available. Supported: Instagram, Facebook, YouTube, TikTok, Pinterest. No analytics API: Twitter, LinkedIn, Reddit, Telegram.",
+      "description": "Fetch analytics and engagement metrics for a published post across all platforms. Returns impressions, reach, likes, comments, shares, views, saves, clicks, quotes, and bookmarks where available. Supported: Instagram, Facebook, YouTube, TikTok, Pinterest, Twitter/X. No analytics API: LinkedIn, Reddit, Telegram.",
       "method": "GET",
       "path": "/posts/%7B%7Bid%7D%7D/analytics",
       "input_schema": {
@@ -463,6 +463,42 @@
         ]
       }
     },
+    {
+      "name": "account_insights",
+      "description": "Get page-level insights and historical stats for a connected social account. Returns follower growth, reach, impressions, engagement metrics, and top content over a date range. Supported: Instagram (reach, followers, engagement, interactions), Facebook (page impressions, reach, engagement, fans), YouTube (subscribers, views, watch time), TikTok (followers, views, likes, shares), Twitter/X (followers, following, tweet count + recent tweet engagement), Pinterest (impressions, engagement, pin clicks, outbound clicks, saves + top pins). Unsupported: LinkedIn, Reddit, Telegram.",
+      "method": "GET",
+      "path": "/accounts/%7B%7Bid%7D%7D/insights",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Social account ID to get insights for"
+          },
+          "start_date": {
+            "type": "string",
+            "description": "Start date in YYYY-MM-DD format (defaults to 7 days ago)"
+          },
+          "end_date": {
+            "type": "string",
+            "description": "End date in YYYY-MM-DD format (defaults to today)"
+          },
+          "period": {
+            "type": "string",
+            "enum": [
+              "day",
+              "week",
+              "days_28"
+            ],
+            "description": "Aggregation period (Instagram/Facebook only)",
+            "default": "day"
+          }
+        },
+        "required": [
+          "id"
+        ]
+      }
+    },
     {
       "name": "account_health",
       "description": "Check the connection health of one or all connected social accounts. Verifies that OAuth tokens are still valid by calling each platform's profile API. Pass a specific account ID or 'all' to check all active accounts.",