@brandazine/solari-sdk 0.2.12 → 0.2.13

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import type { SolariToolMap, SolariToolName, SolariTools, SolariToolsWithoutRequ
 export * from "./tools.generated.js";
 export declare const DEFAULT_BASE_URL = "https://solari.sh";
 export declare const API_PREFIX = "/mcp/api/v1";
-export declare const SDK_VERSION = "0.2.12";
+export declare const SDK_VERSION = "0.2.13";
 export declare const TOKEN_ENV = "SOLARI_TOKEN";
 export interface SolariTool {
     name: string;

package/dist/index.js

@@ -1,7 +1,7 @@
 export * from "./tools.generated.js";
 export const DEFAULT_BASE_URL = "https://solari.sh";
 export const API_PREFIX = "/mcp/api/v1";
-export const SDK_VERSION = "0.2.12";
+export const SDK_VERSION = "0.2.13";
 export const TOKEN_ENV = "SOLARI_TOKEN";
 const DEFAULT_TIMEOUT_MS = 150_000;
 export class SolariError extends Error {

package/dist/tools.generated.d.ts

@@ -104,7 +104,7 @@ export interface CatalogInstagramContentSearchArgs {
     /** Only posts on or before this UTC date, YYYY-MM-DD inclusive. */
     "until"?: string | undefined;
 }
-/** Every tracked post carrying one exact tag — '#ootd' for a hashtag, '@handle' for mentions of an account — hydrated into full rows, newest-collected first with cursor pagination. Exact whole-tag matching over the entire tracked history and every region, where solari_catalog_instagram_content_search does free-text over four regions and about six months. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. The tag index refreshes once a day: when a hashtag is missing or stale here, solari_fetch_instagram_hashtag_posts collects a live page of it. Works with any signed-in SOLARI account. */
+/** Every tracked post carrying one exact tag — '#ootd' for a hashtag, '@handle' for mentions of an account — hydrated into full rows, newest-collected first with cursor pagination; like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). Exact whole-tag matching over the entire tracked history and every region, where solari_catalog_instagram_content_search does free-text over four regions and about six months. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. The tag index refreshes once a day: when a hashtag is missing or stale here, solari_fetch_instagram_hashtag_posts collects a live page of it. Works with any signed-in SOLARI account. */
 export interface CatalogInstagramTagSearchArgs {
     /** One exact tag. '#ootd' or 'ootd' searches a hashtag; '@oliveyoung_official' searches mentions of that account. No spaces, no wildcards. */
     "query": string;
@@ -206,7 +206,7 @@ export interface FetchInstagramAccountSearchArgs {
     /** Name or handle fragment, with or without a leading @. */
     "query": string;
 }
-/** Collects one page of an Instagram hashtag feed live, stores every post in the SOLARI catalog and returns them in feed order. Stored posts reach solari_catalog_instagram_tag_search only after its next daily refresh, so read this page's posts from the response itself. Every call goes out to Instagram, so use it when a hashtag is missing or stale in solari_catalog_instagram_tag_search, not as the default way to read a tag. tab picks the feed: recent (default), top, or clips for reels. One page is roughly 20 to 30 posts and takes several seconds; pass next_cursor back as cursor for the next page of the same hashtag and tab. The feed ends only when next_cursor is null: a page can come back with found 0 and a next_cursor, which means keep going. fetched_count is how many posts Instagram returned; found is lower when some could not be stored. A hashtag that is hidden, restricted, or unknown to Instagram answers is_hidden=true with no posts; Instagram does not tell these apart, so check the spelling with solari_fetch_instagram_hashtag_search. Each post carries assets with a direct-download asset_url. Works with any signed-in SOLARI account. */
+/** Collects one page of an Instagram hashtag feed live, stores every post in the SOLARI catalog and returns them in feed order. Stored posts reach solari_catalog_instagram_tag_search only after its next daily refresh, so read this page's posts from the response itself. Every call goes out to Instagram, so use it when a hashtag is missing or stale in solari_catalog_instagram_tag_search, not as the default way to read a tag. tab picks the feed: recent (default), top, or clips for reels. One page is roughly 20 to 30 posts and takes several seconds; pass next_cursor back as cursor for the next page of the same hashtag and tab. The feed ends only when next_cursor is null: a page can come back with found 0 and a next_cursor, which means keep going. fetched_count is how many posts Instagram returned; found is lower when some could not be stored. A hashtag that is hidden, restricted, or unknown to Instagram answers is_hidden=true with no posts; Instagram does not tell these apart, so check the spelling with solari_fetch_instagram_hashtag_search. Like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). Each post carries assets with a direct-download asset_url. Works with any signed-in SOLARI account. */
 export interface FetchInstagramHashtagPostsArgs {
     /** One exact hashtag, with or without a leading #. No spaces, no wildcards. */
     "hashtag": string;
@@ -227,7 +227,7 @@ export interface FetchInstagramPostArgs {
     /** Public Instagram shortcode, the segment after /p/, /reel/, or /tv/ in a post URL. Wins over url when both are set. */
     "slug"?: string | undefined;
 }
-/** Collects one tab of an Instagram account live at call time and returns the collected posts in the same call, in tab order, each with views (play_count), likes and comments, in the same item shape as solari_catalog_instagram_account_posts; like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). type picks the tab: posts (default) is the profile grid; reels is the reels tab, the one to use for view-count questions; tagged_posts is other accounts' posts that tag this account, and each of those items carries author_username and author_account_id. pages reads 1 to 3 pages of the tab per call, roughly 12 posts each, starting from the newest; when collection.next_cursor is set the tab goes further back, so call again with cursor=<next_cursor> and the same username and type to continue. Prefer this over solari_catalog_instagram_account_posts whenever completeness or freshness matters, because the stored catalog can be sparse or stale. A call usually takes 5 to 45 seconds. play_count is null when Instagram gave no view count, as for most photos. A private account returns no items and collection.skipped_reason=private. An unknown handle is collected first; found=false means Instagram has no account under that name. Everything collected is also stored in the catalog. Works with any signed-in SOLARI account. */
+/** Collects one tab of an Instagram account live at call time and returns the collected posts in the same call, in tab order, each with views (play_count), likes and comments, in the same item shape as solari_catalog_instagram_account_posts; like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). type picks the tab: posts (default) is the profile grid; reels is the reels tab, the one to use for view-count questions, though Instagram leaves some reels off that tab while still showing them on the grid, so read type=posts as well when every reel must be counted; tagged_posts is other accounts' posts that tag this account, and each of those items carries author_username and author_account_id. pages reads 1 to 3 pages of the tab per call, roughly 12 posts each, starting from the newest; when collection.next_cursor is set the tab goes further back, so call again with cursor=<next_cursor> and the same username and type to continue. Prefer this over solari_catalog_instagram_account_posts whenever completeness or freshness matters, because the stored catalog can be sparse or stale. A call usually takes 5 to 45 seconds. play_count is null when Instagram gave no view count, as for most photos. A private account returns no items and collection.skipped_reason=private. An unknown handle is collected first; found=false means Instagram has no account under that name. Everything collected is also stored in the catalog. Works with any signed-in SOLARI account. */
 export interface FetchInstagramPostsArgs {
     /** Instagram handle, with or without a leading @. */
     "username": string;
@@ -312,7 +312,7 @@ export interface FetchTiktokPostsArgs {
     /** TikTok handle, with or without a leading @. */
     "username": string;
 }
-/** Paginated row-level list of the identified sponsored posts one creator authored, newest first, with the target brand attached to each row — one row per post-brand pair, so a multi-brand post appears once per target. Each item carries post_id, slug and url, post_type, posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, and target_account_id/target_username. Filter to one brand with target (its account_id or Instagram handle). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_account_collabs, which groups the same history by brand. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
+/** Paginated row-level list of the identified sponsored posts one creator authored, newest first, with the target brand attached to each row — one row per post-brand pair, so a multi-brand post appears once per target. Each item carries post_id, slug and url, post_type, posted_at, caption text, like/comment/play counts, likes_hidden (true when the author hid likes; like_count is then null, as Instagram gives only a placeholder), media_count, is_paid_partnership, and target_account_id/target_username. Filter to one brand with target (its account_id or Instagram handle). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_account_collabs, which groups the same history by brand. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface InsightInstagramAccountAdPostsArgs {
     /** account_id of the creator (SOLARI account UUID). Provide this or username. */
     "account_id"?: string | undefined;
@@ -379,7 +379,7 @@ export interface InsightInstagramAccountDiscoverArgs {
     /** How many top usernames to preview, default 20. Values above 60 are clamped to 60. The full list is always paged separately. */
     "limit"?: number | undefined;
 }
-/** Pages the full creator list of one solari_insight_instagram_account_discover run. Each item carries account_id, username, full name, bio, follower count, 3-month median and total views, view growth, ad count, and the creator's top recent posts. Results stay available after the search, so re-sort or page without searching again. Works with any signed-in SOLARI account. */
+/** Pages the full creator list of one solari_insight_instagram_account_discover run. Each item carries account_id, username, full name, bio, follower count, 3-month median and total views, view growth, ad count, and the creator's top recent posts (their like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder)). Results stay available after the search, so re-sort or page without searching again. Works with any signed-in SOLARI account. */
 export interface InsightInstagramAccountDiscoverResultsArgs {
     /** search_id returned by solari_insight_instagram_account_discover. */
     "search_id": string;
@@ -397,7 +397,7 @@ export interface InsightInstagramAccountSimilarArgs {
     /** Number of similar accounts to return, default 50. Values above 100 are clamped to 100. */
     "limit"?: number | undefined;
 }
-/** Paginated row-level list of the identified sponsored posts targeting a brand, each hydrated with slug, caption, posted_at, like/comment counts, play_count for videos, and the authoring creator's username and account_id. sort=recent pages the full window newest-first with an exact total; sort=engagement ranks within a bounded recent window whose size is reported as ranking_window (non-null means the ordering covers a slice, not everything). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_brand_ad_stats. Takes the brand's Instagram handle (no @). Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
+/** Paginated row-level list of the identified sponsored posts targeting a brand, each hydrated with slug, caption, posted_at, like/comment counts, play_count for videos, and the authoring creator's username and account_id; like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). sort=recent pages the full window newest-first with an exact total; sort=engagement ranks within a bounded recent window whose size is reported as ranking_window (non-null means the ordering covers a slice, not everything). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_brand_ad_stats. Takes the brand's Instagram handle (no @). Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
 export interface InsightInstagramBrandAdPostsArgs {
     /** Brand Instagram handle without the leading @. */
     "username": string;
@@ -415,7 +415,7 @@ export interface InsightInstagramBrandAdStatsArgs {
     /** Brand Instagram handle without the leading @. */
     "username": string;
 }
-/** For one brand and up to 100 creator account_ids, returns each creator's sponsored posts targeting that brand — per creator: post_count, reels_count, images_count, follower_count, and the posts themselves (slug, caption, posted_at, like/comment counts) — sorted by total engagement. All-time history, one call instead of one per creator. Get creator account_ids from solari_insight_instagram_brand_top_collaborators or solari_insight_instagram_brand_overview. Identify the brand by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
+/** For one brand and up to 100 creator account_ids, returns each creator's sponsored posts targeting that brand — per creator: post_count, reels_count, images_count, follower_count, and the posts themselves (slug, caption, posted_at, like/comment counts; like_count is null when likes_hidden=true: the author hid likes and Instagram gave only a placeholder) — sorted by total engagement. All-time history, one call instead of one per creator. Get creator account_ids from solari_insight_instagram_brand_top_collaborators or solari_insight_instagram_brand_overview. Identify the brand by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface InsightInstagramBrandCollaboratorPostsArgs {
     /** Brand account_id (SOLARI account UUID). Provide this or username. */
     "account_id"?: string | undefined;
@@ -547,7 +547,7 @@ export interface InsightInstagramHashtagDetailArgs {
     /** Optional brand Instagram handle, used like brand_account_id. Ignored when brand_account_id is set. */
     "brand_username"?: string | undefined;
 }
-/** Posts carrying one hashtag inside a trend window, most viewed first or newest first — the examples behind a leaderboard entry. Each item carries post_id, slug, author account_id and username, posted_at, play count and like count. Unlike solari_catalog_instagram_tag_search, it is limited to the window and can follow a brand lens. Works with any signed-in SOLARI account. */
+/** Posts carrying one hashtag inside a trend window, most viewed first or newest first — the examples behind a leaderboard entry. Each item carries post_id, slug, author account_id and username, posted_at, play count and like count; like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). Unlike solari_catalog_instagram_tag_search, it is limited to the window and can follow a brand lens. Works with any signed-in SOLARI account. */
 export interface InsightInstagramHashtagPostsArgs {
     /** Hashtag, with or without the leading #. */
     "tag": string;
@@ -795,7 +795,7 @@ export interface SolariTools {
                 search<T = unknown>(args: CatalogInstagramContentSearchArgs): Promise<T>;
             };
             tag: {
-                /** Every tracked post carrying one exact tag — '#ootd' for a hashtag, '@handle' for mentions of an account — hydrated into full rows, newest-collected first with cursor pagination. Exact whole-tag matching over the entire tracked history and every region, where solari_catalog_instagram_content_search does free-text over four regions and about six months. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. The tag index refreshes once a day: when a hashtag is missing or stale here, solari_fetch_instagram_hashtag_posts collects a live page of it. Works with any signed-in SOLARI account. */
+                /** Every tracked post carrying one exact tag — '#ootd' for a hashtag, '@handle' for mentions of an account — hydrated into full rows, newest-collected first with cursor pagination; like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). Exact whole-tag matching over the entire tracked history and every region, where solari_catalog_instagram_content_search does free-text over four regions and about six months. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. The tag index refreshes once a day: when a hashtag is missing or stale here, solari_fetch_instagram_hashtag_posts collects a live page of it. Works with any signed-in SOLARI account. */
                 search<T = unknown>(args: CatalogInstagramTagSearchArgs): Promise<T>;
             };
         };
@@ -831,14 +831,14 @@ export interface SolariTools {
                 search<T = unknown>(args: FetchInstagramAccountSearchArgs): Promise<T>;
             };
             hashtag: {
-                /** Collects one page of an Instagram hashtag feed live, stores every post in the SOLARI catalog and returns them in feed order. Stored posts reach solari_catalog_instagram_tag_search only after its next daily refresh, so read this page's posts from the response itself. Every call goes out to Instagram, so use it when a hashtag is missing or stale in solari_catalog_instagram_tag_search, not as the default way to read a tag. tab picks the feed: recent (default), top, or clips for reels. One page is roughly 20 to 30 posts and takes several seconds; pass next_cursor back as cursor for the next page of the same hashtag and tab. The feed ends only when next_cursor is null: a page can come back with found 0 and a next_cursor, which means keep going. fetched_count is how many posts Instagram returned; found is lower when some could not be stored. A hashtag that is hidden, restricted, or unknown to Instagram answers is_hidden=true with no posts; Instagram does not tell these apart, so check the spelling with solari_fetch_instagram_hashtag_search. Each post carries assets with a direct-download asset_url. Works with any signed-in SOLARI account. */
+                /** Collects one page of an Instagram hashtag feed live, stores every post in the SOLARI catalog and returns them in feed order. Stored posts reach solari_catalog_instagram_tag_search only after its next daily refresh, so read this page's posts from the response itself. Every call goes out to Instagram, so use it when a hashtag is missing or stale in solari_catalog_instagram_tag_search, not as the default way to read a tag. tab picks the feed: recent (default), top, or clips for reels. One page is roughly 20 to 30 posts and takes several seconds; pass next_cursor back as cursor for the next page of the same hashtag and tab. The feed ends only when next_cursor is null: a page can come back with found 0 and a next_cursor, which means keep going. fetched_count is how many posts Instagram returned; found is lower when some could not be stored. A hashtag that is hidden, restricted, or unknown to Instagram answers is_hidden=true with no posts; Instagram does not tell these apart, so check the spelling with solari_fetch_instagram_hashtag_search. Like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). Each post carries assets with a direct-download asset_url. Works with any signed-in SOLARI account. */
                 posts<T = unknown>(args: FetchInstagramHashtagPostsArgs): Promise<T>;
                 /** Looks hashtags up on Instagram live by keyword and returns up to 20 candidates with the number of posts Instagram reports under each. Use it to find the exact spelling or the biggest variant of a tag before solari_catalog_instagram_tag_search or solari_fetch_instagram_hashtag_posts. Nothing is stored and there is no pagination. Works with any signed-in SOLARI account. */
                 search<T = unknown>(args: FetchInstagramHashtagSearchArgs): Promise<T>;
             };
             /** Collects one Instagram post into the SOLARI catalog by its public URL or shortcode and returns it with its author. Use it when solari_catalog_instagram_content_detail answers item=null for a link you were given and you do not know who posted it. If the post is already stored, nothing is scraped. A first-time collect takes a few seconds. The author arrives as a name-only account: call solari_fetch_instagram_account with the returned username to crawl their profile and posts. item is null when Instagram has no public post at that reference. The post carries assets with a direct-download asset_url. Works with any signed-in SOLARI account. */
             post<T = unknown>(args?: FetchInstagramPostArgs): Promise<T>;
-            /** Collects one tab of an Instagram account live at call time and returns the collected posts in the same call, in tab order, each with views (play_count), likes and comments, in the same item shape as solari_catalog_instagram_account_posts; like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). type picks the tab: posts (default) is the profile grid; reels is the reels tab, the one to use for view-count questions; tagged_posts is other accounts' posts that tag this account, and each of those items carries author_username and author_account_id. pages reads 1 to 3 pages of the tab per call, roughly 12 posts each, starting from the newest; when collection.next_cursor is set the tab goes further back, so call again with cursor=<next_cursor> and the same username and type to continue. Prefer this over solari_catalog_instagram_account_posts whenever completeness or freshness matters, because the stored catalog can be sparse or stale. A call usually takes 5 to 45 seconds. play_count is null when Instagram gave no view count, as for most photos. A private account returns no items and collection.skipped_reason=private. An unknown handle is collected first; found=false means Instagram has no account under that name. Everything collected is also stored in the catalog. Works with any signed-in SOLARI account. */
+            /** Collects one tab of an Instagram account live at call time and returns the collected posts in the same call, in tab order, each with views (play_count), likes and comments, in the same item shape as solari_catalog_instagram_account_posts; like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). type picks the tab: posts (default) is the profile grid; reels is the reels tab, the one to use for view-count questions, though Instagram leaves some reels off that tab while still showing them on the grid, so read type=posts as well when every reel must be counted; tagged_posts is other accounts' posts that tag this account, and each of those items carries author_username and author_account_id. pages reads 1 to 3 pages of the tab per call, roughly 12 posts each, starting from the newest; when collection.next_cursor is set the tab goes further back, so call again with cursor=<next_cursor> and the same username and type to continue. Prefer this over solari_catalog_instagram_account_posts whenever completeness or freshness matters, because the stored catalog can be sparse or stale. A call usually takes 5 to 45 seconds. play_count is null when Instagram gave no view count, as for most photos. A private account returns no items and collection.skipped_reason=private. An unknown handle is collected first; found=false means Instagram has no account under that name. Everything collected is also stored in the catalog. Works with any signed-in SOLARI account. */
             posts<T = unknown>(args: FetchInstagramPostsArgs): Promise<T>;
         };
         threads: {
@@ -878,7 +878,7 @@ export interface SolariTools {
         instagram: {
             account: {
                 ad: {
-                    /** Paginated row-level list of the identified sponsored posts one creator authored, newest first, with the target brand attached to each row — one row per post-brand pair, so a multi-brand post appears once per target. Each item carries post_id, slug and url, post_type, posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, and target_account_id/target_username. Filter to one brand with target (its account_id or Instagram handle). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_account_collabs, which groups the same history by brand. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
+                    /** Paginated row-level list of the identified sponsored posts one creator authored, newest first, with the target brand attached to each row — one row per post-brand pair, so a multi-brand post appears once per target. Each item carries post_id, slug and url, post_type, posted_at, caption text, like/comment/play counts, likes_hidden (true when the author hid likes; like_count is then null, as Instagram gives only a placeholder), media_count, is_paid_partnership, and target_account_id/target_username. Filter to one brand with target (its account_id or Instagram handle). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_account_collabs, which groups the same history by brand. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                     posts<T = unknown>(args?: InsightInstagramAccountAdPostsArgs): Promise<T>;
                 };
                 /** Recent ad collaborations produced by one creator within a month window. Each item is a target brand (target_account_id, target_username) with collab_count, last_posted_at, and a sample collaboration post. Returns items, has_more, and total; page with limit/offset. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Mirror view of solari_insight_instagram_brand_top_collaborators, which starts from the brand instead. Works with any signed-in SOLARI account. */
@@ -886,7 +886,7 @@ export interface SolariTools {
                 discover: {
                     /** Finds Instagram creators that fit a brief: topic phrases matched against captions, transcripts and visual style, bio traits, a reference creator to find lookalikes of, trending growth, and a product the creator should have advertised before — then filtered by follower, 3-month total view and 3-month median view ranges and excluded keywords. Use it to build a shortlist; use solari_catalog_instagram_account_search instead when you already have a name. Returns a search_id, the total found, the top usernames and result sections; page the full creator list (profile metrics and each creator's top recent posts) with solari_insight_instagram_account_discover_results. Broad briefs can take up to a minute. Works with any signed-in SOLARI account. */
                     <T = unknown>(args: InsightInstagramAccountDiscoverArgs): Promise<T>;
-                    /** Pages the full creator list of one solari_insight_instagram_account_discover run. Each item carries account_id, username, full name, bio, follower count, 3-month median and total views, view growth, ad count, and the creator's top recent posts. Results stay available after the search, so re-sort or page without searching again. Works with any signed-in SOLARI account. */
+                    /** Pages the full creator list of one solari_insight_instagram_account_discover run. Each item carries account_id, username, full name, bio, follower count, 3-month median and total views, view growth, ad count, and the creator's top recent posts (their like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder)). Results stay available after the search, so re-sort or page without searching again. Works with any signed-in SOLARI account. */
                     results<T = unknown>(args: InsightInstagramAccountDiscoverResultsArgs): Promise<T>;
                 };
                 /** Finds Instagram accounts similar to the given username based on relationship-graph overlap. Takes an Instagram handle (no @), not a UUID. Works with any signed-in SOLARI account. */
@@ -894,13 +894,13 @@ export interface SolariTools {
             };
             brand: {
                 ad: {
-                    /** Paginated row-level list of the identified sponsored posts targeting a brand, each hydrated with slug, caption, posted_at, like/comment counts, play_count for videos, and the authoring creator's username and account_id. sort=recent pages the full window newest-first with an exact total; sort=engagement ranks within a bounded recent window whose size is reported as ranking_window (non-null means the ordering covers a slice, not everything). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_brand_ad_stats. Takes the brand's Instagram handle (no @). Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
+                    /** Paginated row-level list of the identified sponsored posts targeting a brand, each hydrated with slug, caption, posted_at, like/comment counts, play_count for videos, and the authoring creator's username and account_id; like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). sort=recent pages the full window newest-first with an exact total; sort=engagement ranks within a bounded recent window whose size is reported as ranking_window (non-null means the ordering covers a slice, not everything). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_brand_ad_stats. Takes the brand's Instagram handle (no @). Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
                     posts<T = unknown>(args: InsightInstagramBrandAdPostsArgs): Promise<T>;
                     /** Exact sponsored-post and collaborating-creator counts for a brand's recent window, plus a bounded play-count sum. Use this for accurate ad-volume figures since solari_insight_instagram_brand_overview ID lists are capped; for the underlying row-level posts use solari_insight_instagram_brand_ad_posts. Takes the brand's Instagram handle (no @). Works with any signed-in SOLARI account. */
                     stats<T = unknown>(args: InsightInstagramBrandAdStatsArgs): Promise<T>;
                 };
                 collaborator: {
-                    /** For one brand and up to 100 creator account_ids, returns each creator's sponsored posts targeting that brand — per creator: post_count, reels_count, images_count, follower_count, and the posts themselves (slug, caption, posted_at, like/comment counts) — sorted by total engagement. All-time history, one call instead of one per creator. Get creator account_ids from solari_insight_instagram_brand_top_collaborators or solari_insight_instagram_brand_overview. Identify the brand by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
+                    /** For one brand and up to 100 creator account_ids, returns each creator's sponsored posts targeting that brand — per creator: post_count, reels_count, images_count, follower_count, and the posts themselves (slug, caption, posted_at, like/comment counts; like_count is null when likes_hidden=true: the author hid likes and Instagram gave only a placeholder) — sorted by total engagement. All-time history, one call instead of one per creator. Get creator account_ids from solari_insight_instagram_brand_top_collaborators or solari_insight_instagram_brand_overview. Identify the brand by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                     posts<T = unknown>(args: InsightInstagramBrandCollaboratorPostsArgs): Promise<T>;
                 };
                 lookalike: {
@@ -931,7 +931,7 @@ export interface SolariTools {
             hashtag: {
                 /** One hashtag in depth for a market and window: post count, unique creators, views, sponsored percent, share of all posts, growth against the previous window, momentum, the share series over time, the tags used together with it, and the creators who used it most (account_id, username, posts, views, followers). Use the same brand as the leaderboard to keep the same lens. Works with any signed-in SOLARI account. */
                 detail<T = unknown>(args: InsightInstagramHashtagDetailArgs): Promise<T>;
-                /** Posts carrying one hashtag inside a trend window, most viewed first or newest first — the examples behind a leaderboard entry. Each item carries post_id, slug, author account_id and username, posted_at, play count and like count. Unlike solari_catalog_instagram_tag_search, it is limited to the window and can follow a brand lens. Works with any signed-in SOLARI account. */
+                /** Posts carrying one hashtag inside a trend window, most viewed first or newest first — the examples behind a leaderboard entry. Each item carries post_id, slug, author account_id and username, posted_at, play count and like count; like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). Unlike solari_catalog_instagram_tag_search, it is limited to the window and can follow a brand lens. Works with any signed-in SOLARI account. */
                 posts<T = unknown>(args: InsightInstagramHashtagPostsArgs): Promise<T>;
                 /** Hashtag leaderboard for a market and window, in two lists: rising (share growing fastest against the previous window) and top (volume weighted by how much more it is used than usual). Each entry carries post count, unique creators, views, sponsored percent, growth multiple against the previous window, a NEW flag, a daily share series and momentum. Pass a brand to see the tags moving around that brand's creators instead of the whole market; lens and lens_reason say which view you got. Use solari_insight_instagram_hashtag_detail and solari_insight_instagram_hashtag_posts to drill into one tag. Works with any signed-in SOLARI account. */
                 trending<T = unknown>(args?: InsightInstagramHashtagTrendingArgs): Promise<T>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@brandazine/solari-sdk",
-	"version": "0.2.12",
+	"version": "0.2.13",
 	"description": "TypeScript client for the SOLARI API — creator and brand intelligence across Instagram and TikTok, plus Meta Threads profiles and posts.",
 	"license": "MIT",
 	"homepage": "https://solari.sh/api",