@scrapecreators/cli 1.0.27 → 1.0.28

package/api-config/instagram-apis.js

@@ -9,7 +9,7 @@ export const instagramBaseApis = {
       description:
         "Gets public Instagram profile data, recent posts, and related accounts",
       fullDescription:
-        "Retrieves comprehensive public Instagram profile information including biography, bio links, follower and following counts, verification status, and profile picture URLs. Also returns recent timeline posts with engagement metrics such as likes, comments, and video view counts, plus a list of related profiles. Useful for account overview, audience analysis, or discovering similar creators.",
+        "Retrieves comprehensive public Instagram profile information including biography, bio links, follower and following counts, verification status, and profile picture URLs. Also returns recent timeline posts with engagement metrics such as likes, comments, and video view counts, plus a list of related profiles. Useful for account overview, audience analysis, or discovering similar creators. Instagram may return media_count as null or return only the current post batch in edge_owner_to_timeline_media.count. Use Profile Post Count when you specifically need the total number of posts.",
       path: "/v1/instagram/profile",
       responseFields: [
         {
@@ -574,12 +574,20 @@ export const instagramBaseApis = {
     {
       name: "Posts",
       method: "GET",
-      description: "Get a persons public posts. *Play counts can sometimes be inaccurate* Play counts are Instagram-only. When a Reel is also cross-posted to Facebook, Instagram (behind login) shows you the combined IG + FB views. But this API will only return the Instagram views. [Read about it on Reddit](https://www.reddit.com/r/InstagramMarketing/comments/1cu2dge/whats_the_point_of_having_facebook_views_on/)",
+      description: "Get a persons public posts (which includes reels). The published time is returned in `items[].created_at` as an ISO 8601 UTC date. The original Unix timestamp is still available in `items[].taken_at`. *Play counts can sometimes be inaccurate* Play counts are Instagram-only. When a Reel is also cross-posted to Facebook, Instagram (behind login) shows you the combined IG + FB views. But this API will only return the Instagram views. [Read about it on Reddit](https://www.reddit.com/r/InstagramMarketing/comments/1cu2dge/whats_the_point_of_having_facebook_views_on/)",
       fullDescription:
-        "Returns a paginated feed of a user's public Instagram posts, including photos, videos, and carousels. Each item includes media type, shortcode, caption text, like count, comment count, play count, video URLs, image URLs, and tagged users. Play counts reflect Instagram-only views and exclude cross-posted Facebook views. Supports cursor-based pagination via next_max_id for scrolling through the full timeline.",
+        "Returns a paginated feed of a user's public Instagram posts, including reels, photos, videos, and carousels. Each item includes media type, shortcode, caption text, like count, comment count, play count, video URLs, image URLs, tagged users, and the published time in `items[].created_at` as an ISO 8601 UTC date. The original Unix timestamp remains available in `items[].taken_at`. Play counts reflect Instagram-only views and exclude cross-posted Facebook views. Supports cursor-based pagination via next_max_id for scrolling through the full timeline.",
       path: "/v2/instagram/user/posts",
       paginationField: "next_max_id",
       responseFields: [
+        {
+          path: "items[0].created_at",
+          description: "Human-readable published time in ISO 8601 UTC format.",
+        },
+        {
+          path: "items[0].taken_at",
+          description: "Original published time as a Unix timestamp in seconds.",
+        },
         {
           path: "items[0].video_versions[0].url",
           description: "If the post is video, this is the URL of the video",
@@ -620,6 +628,7 @@ export const instagramBaseApis = {
             has_privately_liked: false,
             filter_type: 0,
             taken_at: 1743438570,
+            created_at: "2025-03-31T16:29:30.000Z",
             usertags: {
               in: [
                 {
@@ -1373,13 +1382,64 @@ export const instagramBaseApis = {
         },
       ],
     },
+    {
+      name: "User Tagged Posts",
+      method: "GET",
+      description: "Get public Instagram posts that a user is tagged in.",
+      fullDescription:
+        "Returns up to 10 public posts per page from an Instagram user's Tagged tab. Each item is a flat post object with its shortcode, caption, media type, engagement counts, media URLs, and owner details. Keep passing the returned cursor to fetch additional pages until has_more is false.",
+      path: "/v1/instagram/user/tagged-posts",
+      paginationField: "cursor",
+      params: [
+        {
+          name: "user_id",
+          type: "string",
+          required: true,
+          description: "Numeric Instagram user ID.",
+          placeholder: "325734299",
+        },
+        {
+          name: "cursor",
+          type: "string",
+          required: false,
+          description: "Cursor returned by the previous response.",
+          placeholder: "3953374600788032611",
+        },
+      ],
+      sampleResponse: {
+        success: true,
+        credits_remaining: 999,
+        posts: [
+          {
+            pk: "3953402310668919030",
+            code: "DbdTnSdoSD2",
+            media_type: 1,
+            caption: {
+              pk: "18139631029604360",
+              text: "You get the best of both worlds ig",
+            },
+            comment_count: 0,
+            like_count: 3,
+            view_count: null,
+            user: {
+              pk: "13320148665",
+              id: "13320148665",
+              username: "oceanecosplay",
+            },
+            url: "https://www.instagram.com/p/DbdTnSdoSD2/",
+          },
+        ],
+        cursor: "3953374600788032611",
+        has_more: true,
+      },
+    },
     {
       name: "Reels",
       method: "GET",
       description:
-        "Get all public reels from a profile. Can provide a user_id or handle, but for faster response times, use user_id. This won't include pinned reels right now. And I'm not sure why, but it looks like IG doesn't return the description of the reel on this endpoint :( You'll have to use the post detail endpoint to get that. *Play counts can sometimes be inaccurate* Play counts are Instagram-only. When a Reel is also cross-posted to Facebook, Instagram (behind login) shows you the combined IG + FB views. But this API will only return the Instagram views. [Read about it on Reddit](https://www.reddit.com/r/InstagramMarketing/comments/1cu2dge/whats_the_point_of_having_facebook_views_on/)",
+        "Get all public reels from a profile. The published time is returned in `items[].media.created_at` as an ISO 8601 UTC date. With `trim=true`, use `items[].created_at`. The original Unix timestamp remains available as `taken_at`. Can provide a user_id or handle, but for faster response times, use user_id. This won't include pinned reels right now. And I'm not sure why, but it looks like IG doesn't return the description of the reel on this endpoint :( You'll have to use the post detail endpoint to get that. *Play counts can sometimes be inaccurate* Play counts are Instagram-only. When a Reel is also cross-posted to Facebook, Instagram (behind login) shows you the combined IG + FB views. But this API will only return the Instagram views. [Read about it on Reddit](https://www.reddit.com/r/InstagramMarketing/comments/1cu2dge/whats_the_point_of_having_facebook_views_on/)",
       fullDescription:
-        "Returns a paginated list of a user's public Instagram reels (short-form videos). Each reel includes its shortcode, play count, like count, comment count, video versions with download URLs, thumbnail image, and owner info. Note that reel captions are not returned by this endpoint. Play counts are Instagram-only views and exclude cross-posted Facebook views. Supports cursor-based pagination via max_id; providing a user_id instead of a handle yields faster responses.",
+        "Returns a paginated list of a user's public Instagram reels (short-form videos). Each reel includes its shortcode, play count, like count, comment count, video versions with download URLs, thumbnail image, owner info, and the published time in `items[].media.created_at` as an ISO 8601 UTC date. With `trim=true`, use `items[].created_at`. The original Unix timestamp remains available as `taken_at`. Note that reel captions are not returned by this endpoint. Play counts are Instagram-only views and exclude cross-posted Facebook views. Supports cursor-based pagination via max_id; providing a user_id instead of a handle yields faster responses.",
       path: "/v1/instagram/user/reels",
       paginationField: "max_id",
       sampleResponse: {
@@ -1387,6 +1447,7 @@ export const instagramBaseApis = {
           {
             media: {
               taken_at: 1736294201,
+              created_at: "2025-01-07T23:56:41.000Z",
               pk: "3540614075954356349",
               id: "3540614075954356349_2700692569",
               fbid: "17882057793200056",
@@ -1744,6 +1805,7 @@ export const instagramBaseApis = {
             id: "3641924023820356866_21393171",
             code: "DKKtpqaxg0C",
             taken_at: 1748371310,
+            created_at: "2025-05-27T18:41:50.000Z",
             caption: {
               bit_flags: 0,
               created_at: 1748371312,
@@ -1979,6 +2041,16 @@ export const instagramBaseApis = {
           "QVFEWFlDdGNOamdwbVdNM2pLY1NJRndSZ2tCbWp6WDV0TWxaYl9WNVktZU1BTUxWMlg1c2JFenNDanJVZ2NudWFjR28zRG93a3ByTExXaHJMbTA0aVJBZg==",
       },
       responseFields: [
+        {
+          path: "items[0].media.created_at",
+          description:
+            "Human-readable published time in ISO 8601 UTC format. With trim=true, use items[0].created_at.",
+        },
+        {
+          path: "items[0].media.taken_at",
+          description:
+            "Original published time as a Unix timestamp in seconds. With trim=true, use items[0].taken_at.",
+        },
         {
           path: "items[0].media.play_count",
           description: "This is views for the reel.",
@@ -2027,18 +2099,26 @@ export const instagramBaseApis = {
       name: "Post/Reel Info",
       method: "GET",
       description:
-        "Retrieve public post/reel details. *Play counts can sometimes be inaccurate* Play counts are Instagram-only. When a Reel is also cross-posted to Facebook, Instagram (behind login) shows you the combined IG + FB views. But this API will only return the Instagram views. [Read about it on Reddit](https://www.reddit.com/r/InstagramMarketing/comments/1cu2dge/whats_the_point_of_having_facebook_views_on/)",
+        "Retrieve public post/reel details. The published time is returned in `data.xdt_shortcode_media.created_at` as an ISO 8601 UTC date. The original Unix timestamp remains available in `data.xdt_shortcode_media.taken_at_timestamp`. *Play counts can sometimes be inaccurate* Play counts are Instagram-only. When a Reel is also cross-posted to Facebook, Instagram (behind login) shows you the combined IG + FB views. But this API will only return the Instagram views. [Read about it on Reddit](https://www.reddit.com/r/InstagramMarketing/comments/1cu2dge/whats_the_point_of_having_facebook_views_on/)",
       fullDescription:
-        "Fetches detailed metadata for a single Instagram post or reel by shortcode or URL. Returns caption text, like count, comment count, video URL, video play count, video duration, display images, owner info, tagged users, and carousel sidecar children when applicable. Play counts are Instagram-only views and exclude cross-posted Facebook views.",
+        "Fetches detailed metadata for a single Instagram post or reel by shortcode or URL. Returns caption text, like count, comment count, video URL, video play count, video duration, display images, owner info, tagged users, carousel sidecar children when applicable, and the published time in `data.xdt_shortcode_media.created_at` as an ISO 8601 UTC date. The original Unix timestamp remains available in `data.xdt_shortcode_media.taken_at_timestamp`. Play counts are Instagram-only views and exclude cross-posted Facebook views. Set `include_play_count=false` to omit the play count and skip its additional fetch for a faster response.",
       path: "/v1/instagram/post",
       responseFields: [
+        {
+          path: "data.xdt_shortcode_media.created_at",
+          description: "Human-readable published time in ISO 8601 UTC format.",
+        },
+        {
+          path: "data.xdt_shortcode_media.taken_at_timestamp",
+          description: "Original published time as a Unix timestamp in seconds.",
+        },
         {
           path: "data.xdt_shortcode_media.video_url",
           description: "If the post is video, this is the URL of the video",
         },
         {
           path: "data.xdt_shortcode_media.video_play_count",
-          description: "Views (only for reels)",
+          description: "Views (only for reels). Omitted when `include_play_count=false`.",
         },
         {
           path: "data.xdt_shortcode_media.edge_media_preview_like.count",
@@ -2211,6 +2291,7 @@ export const instagramBaseApis = {
             },
             comments_disabled: false,
             commenting_disabled_for_viewer: false,
+            created_at: "2025-02-10T18:00:35.000Z",
             taken_at_timestamp: 1739210435,
             edge_media_preview_like: { count: 153, edges: [] },
             edge_media_to_sponsor_user: { edges: [] },
@@ -2641,6 +2722,13 @@ export const instagramBaseApis = {
           placeholder: false,
           credits: 10,
         },
+        {
+          name: "include_play_count",
+          type: "boolean",
+          required: false,
+          description: "Set to false to omit `video_play_count` and skip its additional fetch for a faster response. Defaults to true.",
+          placeholder: true,
+        },
       ],
     },
     {
@@ -3385,13 +3473,137 @@ export const instagramBaseApis = {
     //     ],
     //   },
     // },
+    {
+      name: "Search Instagram",
+      method: "GET",
+      description:
+        "Find users, hashtags, and places with Instagram's native search. Use this for account or entity lookup; it returns one page and does not return posts.",
+      fullDescription:
+        "Use this for Instagram-native account, hashtag, or place lookup. It returns ranked users, hashtags, places, and keyword suggestions from Instagram itself. It is not Google-indexed, does not require an Instagram login, returns one page only, and does not return posts. For an Instagram-curated topic page with posts, use /v1/instagram/search/popular. For broader profile discovery from Google-indexed bios and captions, use /v1/instagram/search/profiles.",
+      path: "/v1/instagram/search",
+      params: [
+        {
+          name: "query",
+          type: "string",
+          required: true,
+          description: "The username, hashtag, place, or keyword to search for.",
+          placeholder: "nike",
+        },
+      ],
+      sampleResponse: {
+        success: true,
+        credits_remaining: 100,
+        data: {
+          query: "nike",
+          users: [
+            {
+              position: 0,
+              id: "13460080",
+              username: "nike",
+              full_name: "Nike",
+              is_verified: true,
+              profile_pic_url: "https://instagram.example.com/nike.jpg",
+            },
+          ],
+          hashtags: [
+            {
+              position: 2,
+              id: "17841562978125529",
+              name: "nikewomen",
+              media_count: 2036828,
+              search_result_subtitle: null,
+            },
+          ],
+          places: [
+            {
+              position: 51,
+              id: "715603272",
+              name: "Nike",
+              title: "Nike",
+              subtitle: "",
+              facebook_places_id: "106068296090172",
+            },
+          ],
+          keywords: [],
+          rank_token: "a6e9cded-6c3e-41be-a6b1-9fa5295a30d5",
+        },
+      },
+    },
+    {
+      name: "Popular Search",
+      method: "GET",
+      description:
+        "Explore an Instagram topic and its curated posts. Use this when you want the Popular page's generated description, sources, suggested terms, media count, and paginated posts.",
+      fullDescription:
+        "Use this to explore an Instagram topic and the posts Instagram curates for it. It scrapes the public /popular/{query} page without requiring an Instagram login. The first page returns the topic title, numeric total media count, Instagram's generated description and sources, suggested terms, posts, and an opaque cursor. Pass that cursor with the same query to fetch more posts. Later pages return query, posts, cursor, and has_more only. For an exact hashtag through Google-indexed results, use /v1/instagram/search/hashtag. For reels only, use /v2/instagram/reels/search. Each successful request costs 1 credit.",
+      path: "/v1/instagram/search/popular",
+      params: [
+        {
+          name: "query",
+          type: "string",
+          required: true,
+          description: "The Popular topic to search for.",
+          placeholder: "basketball",
+        },
+        {
+          name: "cursor",
+          type: "string",
+          required: false,
+          description:
+            "The opaque cursor returned by the previous response. Use it with the same query to fetch the next page of posts.",
+          placeholder: "opaque-cursor-from-response",
+        },
+      ],
+      sampleResponse: {
+        success: true,
+        credits_remaining: 99,
+        credits_charged: 1,
+        query: "basketball",
+        title: "Basketball",
+        total_media_count: 8800000,
+        description: {
+          plain_text:
+            "James Naismith invented basketball in December 1891 in Springfield, Massachusetts as an indoor winter activity.",
+          source_uris: [
+            "https://en.wikipedia.org/wiki/Outline_of_basketball",
+          ],
+          linked_terms: [],
+        },
+        suggested_terms: [
+          "the tallest basketball player",
+          "thats my man basketball",
+          "jason williams basketball player",
+        ],
+        posts: [
+          {
+            id: "POLARIS_3892957342260916992",
+            shortcode: "DYGkBO3NfMA",
+            url: "https://www.instagram.com/reel/DYGkBO3NfMA/",
+            type: "reel",
+            caption: "😂😂 #meta #pov #hooper #basketball",
+            display_url: "https://instagram.example.com/basketball-cover.jpg",
+            video_url: "https://instagram.example.com/basketball-video.mp4",
+            play_count: 11993988,
+            owner: {
+              id: "17841409679275910",
+              username: "lukaceo",
+              is_verified: false,
+              profile_pic_url:
+                "https://instagram.example.com/lukaceo-profile.jpg",
+            },
+          },
+        ],
+        cursor: "opaque-cursor-from-response",
+        has_more: true,
+      },
+    },
     {
       name: "Search Hashtag Posts",
       method: "GET",
       description:
-        "Search for public Instagram posts by hashtag. Uses Google Search to find indexed posts/reels, then scrapes the public Instagram pages. This avoids Instagram login-gated search and only uses public data.",
+        "Find Google-indexed public Instagram posts for an exact hashtag. Use this when you know the hashtag and want date filters or pagination.",
       fullDescription:
-        "Finds public Instagram posts for a hashtag using Google Search, then returns post details such as caption, play count when available, like count, comment count, owner, and post time. Results depend on what Google has indexed, so this is best-effort and not a complete Instagram-native hashtag search. Pass media_type=reels if you only want reels. Use date_posted for recent posts and pass the returned cursor to fetch the next page.",
+        "Use this when you know the exact hashtag and want Google-indexed public Instagram posts or reels, optional date filters, and pagination. It returns post details such as caption, engagement, owner, and post time. Results are best-effort and not a complete Instagram-native hashtag feed. For an Instagram-curated topic page with generated context and suggested terms, use /v1/instagram/search/popular. Pass media_type=reels to only return reels. Cursors are limited to pages 1 through 11; cursor 12 or greater returns a 400 response.",
       path: "/v1/instagram/search/hashtag",
       params: [
         {
@@ -3421,7 +3633,7 @@ export const instagramBaseApis = {
           name: "cursor",
           type: "string",
           required: false,
-          description: "The cursor returned by the previous response. In this version, it is the next Google results page number.",
+          description: "The cursor returned by the previous response. It is the next Google results page number and cannot exceed 11; cursor 12 or greater returns a 400 response.",
           placeholder: "2",
         },
       ],
@@ -3442,8 +3654,6 @@ export const instagramBaseApis = {
             "video_url": "https://scontent-ord5-2.cdninstagram.com/o1/v/t2/f2/m86/AQNG_gCzevxl8xiNB2lVRlcV8c3o3r2ZyeLeWfaY4eaHdyRX3_Z1mty2jrHuH5Z66vTC5SXrhmpdG5re9MNyf1jCtWVyPKAWQFQ037o.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_ohc=ByTiQjuOr9wQ7kNvwGpBh0x&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTEyMDQ3OTIyMDA0MTUwMSwiYXNzZXRfYWdlX2RheXMiOjI2NCwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjY1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=638842146c84456b&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC80QTQ2OURBNUJBQTE1RjdFODZFRjQxRThCOUU1RTNBOV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC83NDQ4NjQwMTg0MjI1MjdfODI5Mjc2OTQ2ODc2ODI3MDk4OC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmupyc3rzE_QMVAigCQzMsF0BQbul41P30GBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&_nc_gid=tAUZdiRnIdGjcNvGfTjMvg&_nc_ss=7a22e&_nc_zt=28&oh=00_Af6Z6PbM9b2RWG7EdCufc8MOp-pcmhJu3EMKtd_pzJaopw&oe=6A193955",
             "has_audio": false,
             "accessibility_caption": null,
-            "video_view_count": 148581,
-            "video_play_count": 593055,
             "product_type": "clips",
             "video_duration": 65.733,
             "clips_music_attribution_info": {
@@ -3607,8 +3817,6 @@ export const instagramBaseApis = {
             "video_url": "https://scontent-mia3-3.cdninstagram.com/o1/v/t2/f2/m86/AQP-dJROb1RW6mt2HO6rqPKhUN-R0M9RSjgR90483nKJLqoM8VMl-0EDaym5Rs0T0lFFo4iSC5S5JroQMHi_LoU1Yh7MByctDUq2rHo.mp4?_nc_cat=109&_nc_sid=5e9851&_nc_ht=scontent-mia3-3.cdninstagram.com&_nc_ohc=jhHcKAQGJiwQ7kNvwGmCH4u&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgwMjI3MjQ3NjI4MTg0NzQsImFzc2V0X2FnZV9kYXlzIjo0NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjg1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=e040d8d00e2dc40b&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8wMzRDNzAxMEM2ODZDQUU1RUE4Q0JFMzJFRTEyMERBQl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0YwNDIxOThBM0VBRDMzQTgxRDNGQzA2QUZCODNEQjhCX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbU3vq10-SDQBUCKAJDMywXQFVZmZmZmZoYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=YD_Zc4FAN30v4fHL3lOgfw&_nc_ss=7a22e&_nc_zt=28&oh=00_Af4i9UTMzKBF1CWLsrCpPWFNBMny8wS91rv7XyzFvw24ng&oe=6A193ED6",
             "has_audio": true,
             "accessibility_caption": null,
-            "video_view_count": 770,
-            "video_play_count": 1650,
             "product_type": "clips",
             "video_duration": 85.419,
             "clips_music_attribution_info": {
@@ -3648,9 +3856,9 @@ export const instagramBaseApis = {
       name: "Search Instagram Profiles",
       method: "GET",
       description:
-        "Find Instagram profiles by keyword using Google-indexed public Instagram pages.",
+        "Find profiles from Google-indexed bios and captions. Use this for broader creator discovery; use /v1/instagram/search for Instagram-native account lookup.",
       fullDescription:
-        "Searches Google for public Instagram results matching a keyword or phrase, then returns matching public profiles. Profile-page matches are marked matched_from=profile. Reel/post caption matches are enriched into the creator profile and marked matched_from=caption. This is best-effort and depends on what Google has indexed; it is not a complete native Instagram profile search.",
+        "Use this for broad creator discovery from keywords found in Google-indexed Instagram profile pages, bios, and post captions. Profile-page matches are marked matched_from=profile; caption matches are enriched into the creator profile and marked matched_from=caption. This is best-effort and can paginate, but it is not Instagram-native or complete. For Instagram's own ranked account results, use /v1/instagram/search. Cursors are limited to pages 1 through 11; cursor 12 or greater returns a 400 response.",
       path: "/v1/instagram/search/profiles",
       params: [
         {
@@ -3664,7 +3872,7 @@ export const instagramBaseApis = {
           name: "cursor",
           type: "string",
           required: false,
-          description: "The cursor returned by the previous response. In this version, it is the next Google results page number.",
+          description: "The cursor returned by the previous response. It is the next Google results page number and cannot exceed 11; cursor 12 or greater returns a 400 response.",
           placeholder: "2",
         },
       ],
@@ -3761,9 +3969,9 @@ export const instagramBaseApis = {
       name: "Search Reels",
       method: "GET",
       description:
-        "Search for reels by keyword. Uses Google Search to find reels. This is because IG puts search behind the login, and we only scrape public data",
+        "Find Google-indexed Instagram reels by keyword. Use this when you only want reels and need date filters or pagination.",
       fullDescription:
-        "Searches for Instagram reels matching a keyword or phrase via Google Search, bypassing Instagram's login-gated search. Returns a list of reels with shortcode, caption, thumbnail, video URL, play count, like count, comment count, video duration, owner details, location, and audio attribution info. Play counts are Instagram-only views and exclude cross-posted Facebook views. Supports page-based pagination for browsing additional results.",
+        "Use this when you only want Google-indexed Instagram reels matching a keyword or phrase, with optional date filters and pagination. It returns reel media, engagement, owner, location, and audio details. Results are best-effort rather than a complete Instagram-native search. For Instagram-curated topic posts, use /v1/instagram/search/popular. For an exact hashtag across posts and reels, use /v1/instagram/search/hashtag. Pages 1 through 11 are supported; page 12 or greater returns a 400 response.",
       path: "/v2/instagram/reels/search",
       params: [
         {
@@ -3777,15 +3985,15 @@ export const instagramBaseApis = {
           name: "date_posted",
           type: "select",
           required: false,
-          description: "Date posted",
-          options: ["last-hour", "last-day", "last-week", "last-month", "last-year"],
-          placeholder: "last-hour",
+          description: "Google-indexed date window. Recent hour/day filters are not supported because Google does not index Instagram reels reliably enough in those windows.",
+          options: ["last-week", "last-month", "last-year"],
+          placeholder: "last-week",
         },
         {
           name: "page",
           type: "number",
           required: false,
-          description: "The page number to return.",
+          description: "The page number to return. Must be between 1 and 11; page 12 or greater returns a 400 response.",
           placeholder: 1,
         },
       ],
@@ -3808,8 +4016,6 @@ export const instagramBaseApis = {
               "https://scontent-sjc3-1.cdninstagram.com/o1/v/t2/f2/m86/AQPtJA5EnMaKK-MNttf3RtYeQCVd-RvC7-juqeJiRkM3tKOkES_-1_ejsPDHgHGZ-xl4in8i3l38K12FlyUWKsieKzs2fGzo1GYOYJI.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_ohc=YBLRFw3fFXcQ7kNvwGKHSNS&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6Nzg4NjQ4MjQzNTUwNjIxLCJhc3NldF9hZ2VfZGF5cyI6MTA1LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NzUsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=8331fe48c9c9d742&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC85NjQ3MjM4QTg3QjMzMzVCNEVBNDI2NEUzRTIyRTNBRV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HRGFlcnlEbFRCTkhBbXdGQUk1d0lORGFpWEk3YnFfRUFBQUYVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmuubGpq_R5gIVAigCQzMsF0BS7MzMzMzNGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&_nc_gid=rIrCBBTCedpkbi2BFdOeJA&_nc_zt=28&oh=00_Afnoz52f0MquXCMwfTVoxg7ArrUBU0IM-BhI13EbDc8qKg&oe=695618AE",
             has_audio: false,
             accessibility_caption: null,
-            video_view_count: 21808,
-            video_play_count: 46018,
             product_type: "clips",
             video_duration: 75.7,
             clips_music_attribution_info: {
@@ -3982,8 +4188,6 @@ export const instagramBaseApis = {
               "https://instagram.fjau2-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQMGznAPGhcSD2V0mwaf-FG2EZJ2y8OO0-NaXzzePzZsktazCSmUBKiRUMQwRCs4f3hajvZe9J0kqn6tMNEoZkqIa3_3VORgBKZTaFY.mp4?_nc_cat=103&_nc_oc=AdlOjWBrhYJ5_tH_G0NgrsGmMwladCYG_uKMlWZpc3XjffSG1-N1Ql8PB5bibwJ1ghM&_nc_sid=5e9851&_nc_ht=instagram.fjau2-1.fna.fbcdn.net&_nc_ohc=uji5XQuEMl4Q7kNvwHXgBf0&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNTc2LmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6NzA4OTMwMTEyMDExMDc2LCJhc3NldF9hZ2VfZGF5cyI6NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjc3LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=c8400c88801d2050&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9ENDQ2OEIwRjVCQUY0NjdFMkUxMkM5RjhERDdERTBBMV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HTlRSQXlUa2s5S3AxTThFQUh0NzhBU1gwZW9LYnN0VEFRQUYVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmiO3595SxwgIVAigCQzMsF0BTSp--dsi0GBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&_nc_gid=aUx3RrOXcjBr2cA8SlA4sQ&_nc_zt=28&oh=00_AfmLbRxcBwEdb3HYqfUn-rjQvS8bP26kMKK5fRC9ePBVAQ&oe=69563678",
             has_audio: true,
             accessibility_caption: null,
-            video_view_count: 1437,
-            video_play_count: 2905,
             product_type: "clips",
             video_duration: 77.166,
             clips_music_attribution_info: {
@@ -4136,8 +4340,6 @@ export const instagramBaseApis = {
               "https://scontent-sjc6-1.cdninstagram.com/o1/v/t2/f2/m86/AQONqqxKabff9BZRO7uaH5BXwMh8BXSlRwnMcLRLe5oqcqYkeSKi0MxuMJ8HZRDkT2y36sOu5bmYPEg8-CczNflliC4uhmdf1gElZ8Y.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-sjc6-1.cdninstagram.com&_nc_ohc=3-ncb8NjkgEQ7kNvwHkyBCh&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTkxNjY3MjEzNTc3ODE0MiwiYXNzZXRfYWdlX2RheXMiOjExNSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjU5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=49d2cb7a8533f053&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9ERDQxQjIwMzUxMTg0RjAxNjI5NDQ2QTI5RUE5NTA4OF92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HRFRiWWlBai0yOXZXX0lEQUIzUkxUVTZwbnNaYnFfRUFBQUYVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmvL3unIDN5wYVAigCQzMsF0BNt2yLQ5WBGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&_nc_gid=K2ngcS-IqRjRHUvD236sDQ&_nc_zt=28&oh=00_Afny6XlXH8a5lIeV7vyIgobLzhbCJOd3KcMZ-DYexwOUyg&oe=69562279",
             has_audio: true,
             accessibility_caption: null,
-            video_view_count: 110684,
-            video_play_count: 271876,
             product_type: "clips",
             video_duration: 59.433,
             clips_music_attribution_info: {
@@ -5454,7 +5656,7 @@ export const instagramBaseApis = {
       method: "GET",
       description: "Get comments from an Instagram post or reel. Not gonna lie, this is one of our most error prone endpoints. You should expect ~90% success rate.",
       fullDescription:
-        "Retrieves comments on a public Instagram post or reel. Each comment includes the comment text, creation timestamp, and commenter details such as username, user ID, verification status, and profile picture URL. Supports cursor-based pagination to load additional comment pages.",
+        "Retrieves comments on a public Instagram post or reel. Each comment includes the comment text, creation timestamp, reply count when Instagram provides it, and commenter details such as username, user ID, verification status, and profile picture URL. `child_comment_count` can be null when Instagram does not expose the count publicly. Set `include_replies=true` to fetch the first page of replies for every returned comment. This adds `replies`, `replies_cursor`, and `has_more_replies` to each comment. This option always costs 15 credits because Scrape Creators makes a separate Instagram replies request for every comment in the response. It is possible that no replies are returned, but you will still be charged 15 credits because those reply lookups were performed. This option is much slower than a normal comments request and may time out at 29 seconds. Supports cursor-based pagination to load additional comment pages.",
       path: "/v2/instagram/post/comments",
       params: [
         {
@@ -5472,16 +5674,30 @@ export const instagramBaseApis = {
             "The cursor to get more comments. Get 'cursor' from previous response.",
           placeholder: "eyJjYWNoZWRfY29tbWVud...",
         },
+        {
+          name: "include_replies",
+          type: "boolean",
+          required: false,
+          description:
+            "Set to true to include replies for every returned comment. This always costs 15 credits because each comment requires a separate Instagram replies request. You will still be charged 15 credits if no replies are returned. This is much slower and may time out at 29 seconds.",
+          placeholder: "true",
+          credits: 15,
+        },
       ],
       sampleResponse: {
         success: true,
         credits_remaining: 33929114,
+        credits_charged: 15,
         comments: [
           {
             id: "18051843701642870",
             text: '"...but who wants to know people who don\'t love animals anyway?". ❤️',
             created_at: "2025-09-16T17:03:04.000Z",
             "comment_like_count": 0,
+            "child_comment_count": 0,
+            replies: [],
+            replies_cursor: null,
+            has_more_replies: false,
             user: {
               is_verified: false,
               id: "46773599357",
@@ -5498,6 +5714,10 @@ export const instagramBaseApis = {
             text: "What a lovely lady, I'm with her who wants to know anyone who doesn't love animals ❤️👏",
             created_at: "2025-09-16T19:53:21.000Z",
             "comment_like_count": 0,
+            "child_comment_count": 0,
+            replies: [],
+            replies_cursor: null,
+            has_more_replies: false,
             user: {
               is_verified: false,
               id: "45139684051",
@@ -5513,6 +5733,61 @@ export const instagramBaseApis = {
         cursor: "AQHSpoi6HyDbzYRMzrD.........",
       },
     },
+    {
+      name: "Comment Replies",
+      method: "GET",
+      description: "Get replies to an Instagram comment.",
+      fullDescription:
+        "Retrieves the public replies to a specific Instagram comment. Pass the post or reel URL and the parent comment's `id` from the Comments endpoint. Returns reply text, timestamps, engagement counts, parent comment ID, and user details. Paginate with `cursor` when `has_more` is true.",
+      path: "/v1/instagram/post/comment/replies",
+      paginationField: "cursor",
+      params: [
+        {
+          name: "url",
+          type: "string",
+          required: true,
+          description: "The Instagram post or reel URL",
+          placeholder: "https://www.instagram.com/reel/C8rKmYvsrck",
+        },
+        {
+          name: "comment_id",
+          type: "string",
+          required: true,
+          description: "The parent comment ID from the Comments endpoint",
+          placeholder: "18038110327814211",
+        },
+        {
+          name: "cursor",
+          type: "string",
+          required: false,
+          description: "The cursor to get more replies. Get `cursor` from the previous response.",
+          placeholder: "QVFDc29...",
+        },
+      ],
+      sampleResponse: {
+        success: true,
+        credits_remaining: 100,
+        comments: [
+          {
+            id: "18277034998224667",
+            text: "@username Thanks for the reply!",
+            comment_like_count: null,
+            child_comment_count: 0,
+            created_at: "2024-06-28T06:20:32.000Z",
+            parent_comment_id: "18038110327814211",
+            user: {
+              id: "25621023419",
+              pk: "25621023419",
+              username: "username",
+              is_verified: false,
+              profile_pic_url: "https://instagram.fosu2-2.fna.fbcdn.net/....jpg",
+            },
+          },
+        ],
+        cursor: null,
+        has_more: false,
+      },
+    },
     // {
     //   name: "Reels (We handle pagination)",
     //   method: "GET",
@@ -6529,6 +6804,41 @@ export const instagramBaseApis = {
         is_fit_green: true,
       },
     },
+    {
+      name: "Profile Post Count",
+      method: "GET",
+      description: "Gets the total number of posts on an Instagram profile",
+      fullDescription:
+        "Returns the total post count shown on a public Instagram profile. Use this endpoint when Profile returns media_count as null or edge_owner_to_timeline_media.count contains only the current batch size. This endpoint makes a separate Instagram profile-page request so it does not add latency to the main Profile endpoint. Instagram does not expose this metadata for every profile; unavailable counts return an error without deducting a credit.",
+      path: "/v1/instagram/profile/post-count",
+      responseFields: [
+        {
+          path: "data.handle",
+          description: "Instagram handle",
+        },
+        {
+          path: "data.media_count",
+          description: "Total number of posts shown on the profile",
+        },
+      ],
+      params: [
+        {
+          name: "handle",
+          type: "string",
+          required: true,
+          placeholder: "lifestyleperfume",
+          description: "Instagram handle",
+        },
+      ],
+      sampleResponse: {
+        success: true,
+        credits_remaining: 100,
+        data: {
+          handle: "lifestyleperfume",
+          media_count: 2774,
+        },
+      },
+    },
     {
       name: "Embed HTML",
       method: "GET",