scavio 0.23.1 → 0.24.0

package/README.md

@@ -785,13 +785,16 @@ await client.tiktokShop.resolve({ url: "https://vt.tiktok.com/ZT2AHoGsE/" });
 
 ### Instagram
 
-Credit cost varies by endpoint, in three tiers:
+20 endpoints. Typical credit cost per call:
 
 | Credits | Methods |
 |---|---|
-| 2 | `userPosts` |
-| 8 | `post`, `commentReplies` |
-| 10 | `profile`, `userReels`, `userTagged`, `userStories`, `postComments`, `searchUsers`, `searchHashtags`, `userFollowers`, `userFollowings` |
+| 1 | `profile`, `musicPosts` (per page), `userReels`, `userTagged` (2 the first time a username is looked up) |
+| 2 | `userPosts`, `userStories`, `post`, `postComments`, `commentReplies`, `searchUsers`, `searchHashtags`, `userFollowers`, `userFollowings`, `userHighlights`, `highlightStories`, `searchReels`, `searchMusic`, `searchLocations`, `userSimilar`, `postLikers` |
+| 8 | `searchUsers` / `searchHashtags` when a `cursor` is sent |
+
+A request can cost up to 10 when it needs extra work; `credits_used` in the
+response is the exact charge.
 
 ```typescript
 // User profile
@@ -802,23 +805,33 @@ await client.instagram.userPosts({ username: "instagram", count: 12 });
 await client.instagram.userReels({ username: "instagram" });
 await client.instagram.userTagged({ username: "instagram" });
 
-// User stories
+// User stories, highlights and the stories saved in one highlight
 await client.instagram.userStories({ username: "instagram" });
+await client.instagram.userHighlights({ username: "natgeo" });
+await client.instagram.highlightStories({ highlight_id: "highlight:18149897764550869" });
 
-// Post detail (by url, media_id, or shortcode)
+// Post detail (by url, media_id, or shortcode) and who liked it
 await client.instagram.post({ shortcode: "DUajw4YkorV" });
+await client.instagram.postLikers({ shortcode: "DUajw4YkorV" });
 
 // Post comments and replies
 await client.instagram.postComments({ shortcode: "DUajw4YkorV", sort_order: "newest" });
 await client.instagram.commentReplies({ media_id: "123", comment_id: "456" });
 
-// Search
+// Search users, hashtags, Reels and places
 await client.instagram.searchUsers({ keyword: "justin" });
 await client.instagram.searchHashtags({ keyword: "fashion" });
+await client.instagram.searchReels({ keyword: "latte art" });
+await client.instagram.searchLocations({ keyword: "central park" });
+
+// Audio: find a track, then the Reels that use it
+await client.instagram.searchMusic({ keyword: "espresso" });
+await client.instagram.musicPosts({ music_id: "1747512212697470" });
 
-// Followers / followings
+// Followers / followings / similar accounts
 await client.instagram.userFollowers({ username: "instagram", count: 50 });
 await client.instagram.userFollowings({ username: "instagram" });
+await client.instagram.userSimilar({ username: "mrbeast" });
 ```
 
 ### Threads

package/dist/index.cjs

@@ -232,7 +232,7 @@ function parseRetryAfter(header) {
 var BASE_URL = "https://api.scavio.dev";
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_MAX_RETRIES = 2;
-var SDK_VERSION = true ? "0.23.1" : "0.0.0";
+var SDK_VERSION = true ? "0.24.0" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -812,42 +812,86 @@ var InstagramNamespace = class {
     this.client = client;
   }
   client;
+  /** Get a user profile by username or user_id. 1 credit. */
   async profile(options) {
     return this.client._post("/api/v1/instagram/profile", options);
   }
+  /** Get a user's posts, about 12 per page; page with `data.pagination_token`. 2 credits per page. */
   async userPosts(options) {
     return this.client._post("/api/v1/instagram/user/posts", options);
   }
+  /** Get a user's Reels. 1 credit (2 the first time a username is looked up). */
   async userReels(options) {
     return this.client._post("/api/v1/instagram/user/reels", options);
   }
+  /** Get posts a user is tagged in. 1 credit (2 the first time a username is looked up). */
   async userTagged(options) {
     return this.client._post("/api/v1/instagram/user/tagged", options);
   }
+  /** Get a user's active stories. 2 credits. */
   async userStories(options) {
     return this.client._post("/api/v1/instagram/user/stories", options);
   }
+  /** Get a single post by url, media_id or shortcode. 2 credits. */
   async post(options) {
     return this.client._post("/api/v1/instagram/post", options);
   }
+  /** Get comments on a post; page with `next_min_id`. 2 credits per page. */
   async postComments(options) {
     return this.client._post("/api/v1/instagram/post/comments", options);
   }
+  /** Get replies to a comment. 2 credits. */
   async commentReplies(options) {
     return this.client._post("/api/v1/instagram/post/comments/replies", options);
   }
+  /** Search users by keyword. 2 credits; 8 when a `cursor` is sent. */
   async searchUsers(options) {
     return this.client._post("/api/v1/instagram/search/users", options);
   }
+  /** Search hashtags by keyword. 2 credits; 8 when a `cursor` is sent. */
   async searchHashtags(options) {
     return this.client._post("/api/v1/instagram/search/hashtags", options);
   }
+  /** Get a user's followers; page with `next_max_id`. 2 credits per page. */
   async userFollowers(options) {
     return this.client._post("/api/v1/instagram/user/followers", options);
   }
+  /** Get the accounts a user follows; page with `next_max_id`. 2 credits per page. */
   async userFollowings(options) {
     return this.client._post("/api/v1/instagram/user/followings", options);
   }
+  /** List a user's story highlights (id, title, cover, item count). 2 credits. */
+  async userHighlights(options) {
+    return this.client._post("/api/v1/instagram/user/highlights", options);
+  }
+  /** Get every story saved in one highlight, with media URLs. 2 credits. */
+  async highlightStories(options) {
+    return this.client._post("/api/v1/instagram/highlight/stories", options);
+  }
+  /** Search Reels by keyword; page with `pagination_token`. 2 credits per page. */
+  async searchReels(options) {
+    return this.client._post("/api/v1/instagram/search/reels", options);
+  }
+  /** Search audio tracks by song or artist; returns the id `musicPosts` takes. 2 credits. */
+  async searchMusic(options) {
+    return this.client._post("/api/v1/instagram/search/music", options);
+  }
+  /** Get the Reels that use an audio track, plus its total reel count. 1 credit per page. */
+  async musicPosts(options) {
+    return this.client._post("/api/v1/instagram/music/posts", options);
+  }
+  /** Search places by name (id, name, address, coordinates). 2 credits. */
+  async searchLocations(options) {
+    return this.client._post("/api/v1/instagram/search/locations", options);
+  }
+  /** Get accounts similar to a user. Most creator accounts have them; some brand accounts return none. 2 credits. */
+  async userSimilar(options) {
+    return this.client._post("/api/v1/instagram/user/similar", options);
+  }
+  /** Get accounts that liked a post (up to about 1,000) and its total like count. 2 credits. */
+  async postLikers(options) {
+    return this.client._post("/api/v1/instagram/post/likers", options);
+  }
 };
 
 // src/namespaces/walmart.ts