@apteva/integrations 0.3.13 → 0.3.15

package/src/apps/twitter-api.json

@@ -46,7 +46,7 @@
       "name": "get_user_by_username",
       "description": "Look up an X user by their username (handle) to get their profile info and user ID",
       "method": "GET",
-      "path": "/2/users/by/username/%7B%7Busername%7D%7D",
+      "path": "/2/users/by/username/{username}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -69,7 +69,7 @@
       "name": "get_tweet",
       "description": "Get a single post by its ID with full details including metrics, author info, and referenced posts",
       "method": "GET",
-      "path": "/2/tweets/%7B%7Btweet_id%7D%7D",
+      "path": "/2/tweets/{tweet_id}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -151,7 +151,7 @@
       "name": "delete_tweet",
       "description": "Delete a tweet by its ID. Must be the authenticated user's own tweet.",
       "method": "DELETE",
-      "path": "/2/tweets/%7B%7Btweet_id%7D%7D",
+      "path": "/2/tweets/{tweet_id}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -229,7 +229,7 @@
       "name": "get_user_tweets",
       "description": "Get tweets posted by a specific user. Returns their timeline of original tweets and retweets.",
       "method": "GET",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/tweets",
+      "path": "/2/users/{user_id}/tweets",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -275,7 +275,7 @@
       "name": "get_user_mentions",
       "description": "Get tweets that mention a specific user by their user ID",
       "method": "GET",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/mentions",
+      "path": "/2/users/{user_id}/mentions",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -314,7 +314,7 @@
       "name": "get_home_timeline",
       "description": "Get the authenticated user's reverse-chronological home timeline (tweets from followed accounts)",
       "method": "GET",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/timelines/reverse_chronological",
+      "path": "/2/users/{user_id}/timelines/reverse_chronological",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -362,7 +362,7 @@
       "name": "get_followers",
       "description": "Get a list of users who follow the specified user",
       "method": "GET",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/followers",
+      "path": "/2/users/{user_id}/followers",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -396,7 +396,7 @@
       "name": "get_following",
       "description": "Get a list of users that the specified user follows",
       "method": "GET",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/following",
+      "path": "/2/users/{user_id}/following",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -430,7 +430,7 @@
       "name": "follow_user",
       "description": "Follow a user. Requires the authenticated user's ID and the target user's ID.",
       "method": "POST",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/following",
+      "path": "/2/users/{user_id}/following",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -453,7 +453,7 @@
       "name": "unfollow_user",
       "description": "Unfollow a user. Requires the authenticated user's ID and the target user's ID.",
       "method": "DELETE",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/following/%7B%7Btarget_user_id%7D%7D",
+      "path": "/2/users/{user_id}/following/{target_user_id}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -476,7 +476,7 @@
       "name": "like_tweet",
       "description": "Like a tweet. Requires the authenticated user's ID and the tweet ID.",
       "method": "POST",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/likes",
+      "path": "/2/users/{user_id}/likes",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -499,7 +499,7 @@
       "name": "unlike_tweet",
       "description": "Remove a like from a tweet",
       "method": "DELETE",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/likes/%7B%7Btweet_id%7D%7D",
+      "path": "/2/users/{user_id}/likes/{tweet_id}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -522,7 +522,7 @@
       "name": "retweet",
       "description": "Retweet a tweet. Requires the authenticated user's ID and the tweet ID.",
       "method": "POST",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/retweets",
+      "path": "/2/users/{user_id}/retweets",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -545,7 +545,7 @@
       "name": "undo_retweet",
       "description": "Remove a retweet",
       "method": "DELETE",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/retweets/%7B%7Btweet_id%7D%7D",
+      "path": "/2/users/{user_id}/retweets/{tweet_id}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -568,7 +568,7 @@
       "name": "get_bookmarks",
       "description": "Get the authenticated user's bookmarked tweets",
       "method": "GET",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/bookmarks",
+      "path": "/2/users/{user_id}/bookmarks",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -607,7 +607,7 @@
       "name": "add_bookmark",
       "description": "Add a tweet to the authenticated user's bookmarks",
       "method": "POST",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/bookmarks",
+      "path": "/2/users/{user_id}/bookmarks",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -630,7 +630,7 @@
       "name": "remove_bookmark",
       "description": "Remove a tweet from the authenticated user's bookmarks",
       "method": "DELETE",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/bookmarks/%7B%7Btweet_id%7D%7D",
+      "path": "/2/users/{user_id}/bookmarks/{tweet_id}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -653,7 +653,7 @@
       "name": "get_liked_tweets",
       "description": "Get tweets liked by a specific user",
       "method": "GET",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/liked_tweets",
+      "path": "/2/users/{user_id}/liked_tweets",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -692,7 +692,7 @@
       "name": "get_liking_users",
       "description": "Get users who liked a specific tweet",
       "method": "GET",
-      "path": "/2/tweets/%7B%7Btweet_id%7D%7D/liking_users",
+      "path": "/2/tweets/{tweet_id}/liking_users",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -726,7 +726,7 @@
       "name": "get_retweeters",
       "description": "Get users who retweeted a specific tweet",
       "method": "GET",
-      "path": "/2/tweets/%7B%7Btweet_id%7D%7D/retweeted_by",
+      "path": "/2/tweets/{tweet_id}/retweeted_by",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -760,7 +760,7 @@
       "name": "mute_user",
       "description": "Mute a user. Muted users' posts will not appear in your timeline.",
       "method": "POST",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/muting",
+      "path": "/2/users/{user_id}/muting",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -783,7 +783,7 @@
       "name": "unmute_user",
       "description": "Unmute a previously muted user",
       "method": "DELETE",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/muting/%7B%7Btarget_user_id%7D%7D",
+      "path": "/2/users/{user_id}/muting/{target_user_id}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -806,7 +806,7 @@
       "name": "get_muted_users",
       "description": "Get the list of users the authenticated user has muted",
       "method": "GET",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/muting",
+      "path": "/2/users/{user_id}/muting",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -840,7 +840,7 @@
       "name": "block_user",
       "description": "Block a user. Blocked users cannot follow you or view your posts.",
       "method": "POST",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/blocking",
+      "path": "/2/users/{user_id}/blocking",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -863,7 +863,7 @@
       "name": "unblock_user",
       "description": "Unblock a previously blocked user",
       "method": "DELETE",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/blocking/%7B%7Btarget_user_id%7D%7D",
+      "path": "/2/users/{user_id}/blocking/{target_user_id}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -886,7 +886,7 @@
       "name": "get_blocked_users",
       "description": "Get the list of users the authenticated user has blocked",
       "method": "GET",
-      "path": "/2/users/%7B%7Buser_id%7D%7D/blocking",
+      "path": "/2/users/{user_id}/blocking",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -920,7 +920,7 @@
       "name": "send_dm",
       "description": "Send a direct message to a specific user. Creates a one-on-one DM conversation if one doesn't exist.",
       "method": "POST",
-      "path": "/2/dm_conversations/with/%7B%7Bparticipant_id%7D%7D/messages",
+      "path": "/2/dm_conversations/with/{participant_id}/messages",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -943,7 +943,7 @@
       "name": "send_dm_to_conversation",
       "description": "Send a direct message to an existing DM conversation (one-on-one or group). Use the conversation ID from a previous DM lookup.",
       "method": "POST",
-      "path": "/2/dm_conversations/%7B%7Bdm_conversation_id%7D%7D/messages",
+      "path": "/2/dm_conversations/{dm_conversation_id}/messages",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -1105,7 +1105,7 @@
       "name": "upload_append",
       "description": "Append a chunk of data to an in-progress chunked upload. Call sequentially with incrementing segment_index (starting at 0) until all data is uploaded.",
       "method": "POST",
-      "path": "/2/media/upload/%7B%7Bmedia_id%7D%7D/append",
+      "path": "/2/media/upload/{media_id}/append",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -1133,7 +1133,7 @@
       "name": "upload_finalize",
       "description": "Finalize a chunked media upload after all chunks have been appended. If response includes processing_info with state 'pending' or 'in_progress', wait check_after_secs then check status again. Once state is 'succeeded', use the media_id to post a tweet.",
       "method": "POST",
-      "path": "/2/media/upload/%7B%7Bmedia_id%7D%7D/finalize",
+      "path": "/2/media/upload/{media_id}/finalize",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -1146,6 +1146,62 @@
           "media_id"
         ]
       }
+    },
+    {
+      "name": "get_tweet_analytics",
+      "description": "Get engagement metrics for one or more tweets. Returns public_metrics (impressions, likes, retweets, replies, quotes, bookmarks) and optionally non_public_metrics and organic_metrics (requires tweet owner auth). Up to 100 tweet IDs per request.\n\nExample:\n{\n  \"tweetIds\": [\"1234567890\", \"0987654321\"],\n  \"include_non_public\": true\n}",
+      "method": "GET",
+      "path": "/get-tweet-analytics",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "tweetIds": {
+            "type": "array",
+            "description": "Array of tweet IDs to get analytics for (max 100)",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 100
+          },
+          "tweetId": {
+            "type": "string",
+            "description": "Single tweet ID (alternative to tweetIds array)"
+          },
+          "include_non_public": {
+            "type": "boolean",
+            "description": "Include non_public_metrics and organic_metrics (requires tweet owner authentication)",
+            "default": false
+          }
+        }
+      }
+    },
+    {
+      "name": "get_account_analytics",
+      "description": "Get account-level analytics for an X/Twitter user. Returns profile public_metrics (followers, following, tweet count, listed count) and optionally aggregated engagement metrics from recent original tweets (total impressions, likes, retweets, replies, quotes, bookmarks, and average engagement rate).\n\nExample:\n{\n  \"userId\": \"1234567890\",\n  \"include_recent_tweets\": true,\n  \"recent_tweet_count\": 20\n}",
+      "method": "GET",
+      "path": "/get-account-analytics",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "description": "X/Twitter user ID"
+          },
+          "include_recent_tweets": {
+            "type": "boolean",
+            "description": "Include recent tweets and engagement summary",
+            "default": true
+          },
+          "recent_tweet_count": {
+            "type": "integer",
+            "description": "Number of recent tweets to analyze (max 100)",
+            "default": 10
+          }
+        },
+        "required": [
+          "userId"
+        ]
+      }
     }
   ]
 }