@brandazine/solari-sdk 0.2.11 → 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.11";
+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.11";
+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

@@ -11,7 +11,7 @@ export interface CatalogInstagramAccountHistoryArgs {
     /** day keeps the last point of each UTC day; all returns every recorded point. */
     "granularity"?: "day" | "all" | undefined;
 }
-/** Posts by one collected Instagram account, newest first, with pagination and filters. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). Each item has post_id (SOLARI post UUID), slug and url (public Instagram permalink), post_type (reel, video, photo, or carousel), posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, a medias array (every media of the post in carousel order, each with media_type, media/thumbnail URLs, video_duration, and tags — accounts and hashtags tagged on that media, with account_id when the tagged account is tracked), and a representative thumbnail_url. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. posts_collected_at is how far the stored posts reach, stored_post_count against profile_post_count shows whether collection is incomplete, and refreshes_regularly says whether the account is re-collected on a schedule; when the requested dates run past posts_collected_at, note explains that later posts are not in the catalog yet — an empty result then does not mean the account posted nothing, so call solari_fetch_instagram_posts to re-collect it. This reads the catalog only; found=false means the handle is not in the catalog (note says when Instagram no longer has it) — call solari_fetch_instagram_posts with that username first. 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 by one collected Instagram account, newest first, with pagination and filters. Stored posts can be sparse or stale: when completeness or freshness matters (every recent post, current reel views), call solari_fetch_instagram_posts instead, which collects them live. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). Each item has post_id (SOLARI post UUID), slug and url (public Instagram permalink), post_type (reel, video, photo, or carousel), posted_at, caption, 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, a medias array (every media in carousel order, each with media_type, media/thumbnail URLs, video_duration, and tags — accounts and hashtags tagged on it, with account_id when tracked), and a representative thumbnail_url. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. posts_collected_at is how far stored posts reach, stored_post_count below profile_post_count means collection is incomplete, and refreshes_regularly says whether it is re-collected on a schedule; when the requested dates run past posts_collected_at, note says later posts are not in the catalog yet — an empty result then does not mean the account posted nothing; collect them live with solari_fetch_instagram_posts. This reads the catalog only; found=false means the handle is not in the catalog (note says when Instagram no longer has it) — call solari_fetch_instagram_posts with that username first. 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 CatalogInstagramAccountPostsArgs {
     /** account_id of the account (SOLARI account UUID). Provide this or username. */
     "account_id"?: string | undefined;
@@ -28,7 +28,7 @@ export interface CatalogInstagramAccountPostsArgs {
     /** Only posts of this format. reel is short-form single-video; video is non-reel video. */
     "post_type"?: "reel" | "video" | "photo" | "carousel" | undefined;
 }
-/** Full SOLARI catalog profile for one collected Instagram account: username, full name, bio, follower/following/post counts, verified flag, inferred account_type, view metrics (median and total views, ad count, month-over-month growth, region percentiles), plus embedded previews of recent posts and recent ad collaborations. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). collected_at is when the profile was last collected from Instagram and refreshes_regularly says whether it is re-collected on a schedule. This reads the catalog only; an unknown handle is not-found — call solari_fetch_instagram_account with that username first, then retry; a not-found that says the handle was renamed or deleted means Instagram has no account under that name, so search by display name instead. Works with any signed-in SOLARI account. */
+/** Full SOLARI catalog profile for one collected Instagram account: username, full name, bio, follower/following/post counts, verified flag, inferred account_type, view metrics (median and total views, ad count, month-over-month growth, region percentiles), plus embedded previews of recent posts and recent ad collaborations (their like_count is null when likes_hidden=true: the author hid likes and Instagram gave only a placeholder). Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). collected_at is when the profile was last collected from Instagram and refreshes_regularly says whether it is re-collected on a schedule. This reads the catalog only; an unknown handle is not-found — call solari_fetch_instagram_account with that username first, then retry; a not-found that says the handle was renamed or deleted means Instagram has no account under that name, so search by display name instead. Works with any signed-in SOLARI account. */
 export interface CatalogInstagramAccountProfileArgs {
     /** account_id of the account (SOLARI account UUID). Provide this or username. */
     "account_id"?: string | undefined;
@@ -48,14 +48,14 @@ export interface CatalogInstagramAccountSearchArgs {
     /** Optional region code such as KR, JP, or US. Leave unset unless the user asked for one country: it filters results to that region and drops the rest. */
     "region"?: string | undefined;
 }
-/** Batch companion to solari_catalog_instagram_content_detail: hydrates up to 100 posts by their SOLARI post UUIDs in a single call. Each row carries slug, caption, posted_at, like/comment counts, play_count for videos, and the author's username and account_id. Untracked ids are omitted, so found can be lower than requested. Feed it post_id lists from solari_insight_instagram_brand_overview (full=true), solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, or the trend feeds. 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. */
+/** Batch companion to solari_catalog_instagram_content_detail: hydrates up to 100 posts by their SOLARI post UUIDs in a single call. Each row carries slug, caption, posted_at, like/comment counts, play_count for videos, and the author's username and account_id; like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). Untracked ids are omitted, so found can be lower than requested. Feed it post_id lists from solari_insight_instagram_brand_overview (full=true), solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, or the trend feeds. 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 CatalogInstagramContentBatchArgs {
     /** SOLARI post UUIDs to hydrate, at most 100 per call. Not Instagram shortcodes/slugs. */
     "post_ids": Array<string>;
     /** Item order: posted_at descending (recent) or like+comment engagement descending. */
     "sort"?: "recent" | "engagement" | undefined;
 }
-/** Detail for one Instagram post in the SOLARI catalog, in the same item shape as solari_insight_instagram_content_trending entries. Identify the post by post_id (SOLARI post UUID from solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, solari_insight_instagram_content_trending, or solari_insight_instagram_content_rising), by slug (the public Instagram shortcode), or by url (the public post URL). This reads the catalog only; item is null when the post is not stored — call solari_fetch_instagram_post with the same url or slug to collect it and learn its author, or solari_fetch_instagram_posts when you already know the author's username. 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. */
+/** Detail for one Instagram post in the SOLARI catalog, in the same item shape as solari_insight_instagram_content_trending entries. like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). Identify the post by post_id (SOLARI post UUID from solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, solari_insight_instagram_content_trending, or solari_insight_instagram_content_rising), by slug (the public Instagram shortcode), or by url (the public post URL). This reads the catalog only; item is null when the post is not stored — call solari_fetch_instagram_post with the same url or slug to collect it and learn its author, or solari_fetch_instagram_posts when you already know the author's username. 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 CatalogInstagramContentDetailArgs {
     /** The SOLARI post_id UUID. Provide this, slug, or url. */
     "post_id"?: string | undefined;
@@ -64,7 +64,7 @@ export interface CatalogInstagramContentDetailArgs {
     /** Public Instagram post URL such as https://www.instagram.com/p/<shortcode>/ or .../reel/<shortcode>/. Ignored when post_id or slug is set. */
     "url"?: string | undefined;
 }
-/** Recorded engagement of Instagram posts over time, for growth curves and engagement comparisons. Each item is one post (post_id, slug, url, posted_at, account_id, username) with points: like_count, comment_count, play_count, reshare_count, likes_hidden, and deleted, oldest first, each with captured_at: the moment the catalog collected those values. Choose posts with post_ids, slugs, or urls (up to 50 combined; missing lists the ones not in the catalog — collect them with solari_fetch_instagram_post), or give an account (account_id or username) to trace its newest posts, narrowed by posted_since/posted_until and limit (default 20, max 50). since/until narrow the recorded points (UTC dates, inclusive). granularity=day (default) keeps the last point of each UTC day per post; all returns every point; truncated=true means older points were dropped. Posts are re-collected mostly in their first days, so older posts have few points. likes_hidden=true means the author hid like and view counts, but like_count is usually still present, so do not drop those posts from comparisons. This reads the catalog only. Works with any signed-in SOLARI account. */
+/** Recorded engagement of Instagram posts over time, for growth curves and engagement comparisons. Each item is one post (post_id, slug, url, posted_at, account_id, username) with points: like_count, comment_count, play_count, reshare_count, likes_hidden, and deleted, oldest first, each with captured_at: the moment the catalog collected those values. Choose posts with post_ids, slugs, or urls (up to 50 combined; missing lists the ones not in the catalog — collect them with solari_fetch_instagram_post), or give an account (account_id or username) to trace its newest posts, narrowed by posted_since/posted_until and limit (default 20, max 50). since/until narrow the recorded points (UTC dates, inclusive). granularity=day (default) keeps the last point of each UTC day per post; all returns every point; truncated=true means older points were dropped. Posts are re-collected mostly in their first days, so older posts have few points. likes_hidden=true means the author hid like counts: Instagram then returns a placeholder instead of the real number, so like_count comes back null — do not treat it as a measured value or as zero likes. This reads the catalog only. Works with any signed-in SOLARI account. */
 export interface CatalogInstagramContentHistoryArgs {
     /** SOLARI post UUIDs. Combine with slugs and urls, up to 50 posts in total. */
     "post_ids"?: Array<string> | undefined;
@@ -89,7 +89,7 @@ export interface CatalogInstagramContentHistoryArgs {
     /** day keeps the last point of each UTC day per post; all returns every recorded point. */
     "granularity"?: "day" | "all" | undefined;
 }
-/** Lexical keyword search over tracked posts: matches captions, creator bios, and video transcription text (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, author account_id/username, caption, transcription text, engagement counts, and score — feed post_id into solari_catalog_instagram_content_detail or solari_catalog_instagram_content_batch and the account reference into the account tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). 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. */
+/** Lexical keyword search over tracked posts: matches captions, creator bios, and video transcription text (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, author account_id/username, caption, transcription text, engagement counts (like_count is null when likes_hidden=true: the author hid likes and Instagram gave only a placeholder), and score — feed post_id into solari_catalog_instagram_content_detail or solari_catalog_instagram_content_batch and the account reference into the account tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). 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 CatalogInstagramContentSearchArgs {
     /** Free-text keyword query matched against captions, creator bios, and video transcriptions. */
     "query": string;
@@ -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,10 +227,16 @@ 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 posts for one Instagram account into the SOLARI catalog by exact username. This is not a post listing: use solari_catalog_instagram_account_posts to read stored rows. An account collected within the last day is not scraped again unless only a few of its posts are stored (stored_post_count well below profile_post_count); an older or sparsely collected copy is re-collected now with its posts queued right away (refreshed=true), and a handle the catalog only knows by name from a tag or mention is crawled the same way. posts_collected_at tells how far the stored posts reach. A first-time ingest can take several seconds and the posts land shortly after, so re-read the catalog after a short wait. 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;
+    /** Tab to collect: posts (profile grid, default), reels (reels tab, use for view counts), or tagged_posts (other accounts' posts that tag this account). */
+    "type"?: "posts" | "reels" | "tagged_posts" | undefined;
+    /** Pages of the tab to collect, default 1, roughly 12 posts per page. Values above 3 are clamped to 3. */
+    "pages"?: number | undefined;
+    /** collection.next_cursor from a previous call with the same username and type; continues further back instead of starting from the newest posts. */
+    "cursor"?: string | undefined;
 }
 /** Reads one Meta Threads account by exact username and returns its profile: display name, biography, follower count, verified and private flags, bio links, profile picture and URL. When you only know a name, find the handle with solari_fetch_threads_account_search first. A handle SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds, and fetched_on_demand=true marks that case; repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned; collected_at says when. Media URLs right after a collection may be temporary, so read them promptly. Nothing is enrolled in ongoing tracking. A handle with no Threads profile answers a not-found error. Works with any signed-in SOLARI account. */
 export interface FetchThreadsAccountArgs {
@@ -306,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;
@@ -373,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;
@@ -391,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;
@@ -409,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;
@@ -476,7 +482,7 @@ export interface InsightInstagramContentAggregateArgs {
     /** Maximum groups returned when group_by is set, default 20. Values above 50 are clamped to 50. */
     "limit"?: number | undefined;
 }
-/** Instagram posts whose recent performance is accelerating faster than baseline in the region. Same shape as solari_insight_instagram_content_trending including cursor pagination and optional brand personalization via a brand account_id or username. 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. */
+/** Instagram posts whose recent performance is accelerating faster than baseline in the region. Same shape as solari_insight_instagram_content_trending including cursor pagination and optional brand personalization via a brand account_id or username. like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). 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 InsightInstagramContentRisingArgs {
     /** Region code such as KR, JP, or US. */
     "region"?: string | undefined;
@@ -515,7 +521,7 @@ export interface InsightInstagramContentTrendClustersArgs {
     /** Rerank clusters by brand affinity when account_id is provided. */
     "brand_aware"?: boolean | undefined;
 }
-/** Instagram posts currently trending in the region, enriched with creator profile fields. Supports cursor pagination via next_cursor from the previous response. Optionally personalizes ranking with a brand account_id or username. 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. Use solari_insight_instagram_content_rising for velocity-led accelerating posts instead. */
+/** Instagram posts currently trending in the region, enriched with creator profile fields. like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). Supports cursor pagination via next_cursor from the previous response. Optionally personalizes ranking with a brand account_id or username. 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. Use solari_insight_instagram_content_rising for velocity-led accelerating posts instead. */
 export interface InsightInstagramContentTrendingArgs {
     /** Region code such as KR, JP, or US. */
     "region"?: string | undefined;
@@ -541,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;
@@ -771,25 +777,25 @@ export interface SolariTools {
             account: {
                 /** Recorded profile values of one collected Instagram account over time, for follower growth and trend comparisons. points lists follower_count, following_count, post_count, is_verified, and is_private, oldest first, each with captured_at: the moment the catalog collected those values. current holds the catalog's current values, and current.collected_at says when the profile was last collected from Instagram; check it before treating the numbers as today's. granularity=day (default) keeps the last point of each UTC day; all returns every recorded point. The range is since/until (UTC dates, inclusive) and defaults to the last 90 days; truncated=true means older points were dropped, so narrow since. Points exist only when the account was collected, so gaps are normal, and most accounts have no points from 2025-08-26 to 2025-09-27. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_instagram_account first, which cannot backfill past values. Works with any signed-in SOLARI account. */
                 history<T = unknown>(args?: CatalogInstagramAccountHistoryArgs): Promise<T>;
-                /** Posts by one collected Instagram account, newest first, with pagination and filters. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). Each item has post_id (SOLARI post UUID), slug and url (public Instagram permalink), post_type (reel, video, photo, or carousel), posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, a medias array (every media of the post in carousel order, each with media_type, media/thumbnail URLs, video_duration, and tags — accounts and hashtags tagged on that media, with account_id when the tagged account is tracked), and a representative thumbnail_url. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. posts_collected_at is how far the stored posts reach, stored_post_count against profile_post_count shows whether collection is incomplete, and refreshes_regularly says whether the account is re-collected on a schedule; when the requested dates run past posts_collected_at, note explains that later posts are not in the catalog yet — an empty result then does not mean the account posted nothing, so call solari_fetch_instagram_posts to re-collect it. This reads the catalog only; found=false means the handle is not in the catalog (note says when Instagram no longer has it) — call solari_fetch_instagram_posts with that username first. 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 by one collected Instagram account, newest first, with pagination and filters. Stored posts can be sparse or stale: when completeness or freshness matters (every recent post, current reel views), call solari_fetch_instagram_posts instead, which collects them live. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). Each item has post_id (SOLARI post UUID), slug and url (public Instagram permalink), post_type (reel, video, photo, or carousel), posted_at, caption, 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, a medias array (every media in carousel order, each with media_type, media/thumbnail URLs, video_duration, and tags — accounts and hashtags tagged on it, with account_id when tracked), and a representative thumbnail_url. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. posts_collected_at is how far stored posts reach, stored_post_count below profile_post_count means collection is incomplete, and refreshes_regularly says whether it is re-collected on a schedule; when the requested dates run past posts_collected_at, note says later posts are not in the catalog yet — an empty result then does not mean the account posted nothing; collect them live with solari_fetch_instagram_posts. This reads the catalog only; found=false means the handle is not in the catalog (note says when Instagram no longer has it) — call solari_fetch_instagram_posts with that username first. 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?: CatalogInstagramAccountPostsArgs): Promise<T>;
-                /** Full SOLARI catalog profile for one collected Instagram account: username, full name, bio, follower/following/post counts, verified flag, inferred account_type, view metrics (median and total views, ad count, month-over-month growth, region percentiles), plus embedded previews of recent posts and recent ad collaborations. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). collected_at is when the profile was last collected from Instagram and refreshes_regularly says whether it is re-collected on a schedule. This reads the catalog only; an unknown handle is not-found — call solari_fetch_instagram_account with that username first, then retry; a not-found that says the handle was renamed or deleted means Instagram has no account under that name, so search by display name instead. Works with any signed-in SOLARI account. */
+                /** Full SOLARI catalog profile for one collected Instagram account: username, full name, bio, follower/following/post counts, verified flag, inferred account_type, view metrics (median and total views, ad count, month-over-month growth, region percentiles), plus embedded previews of recent posts and recent ad collaborations (their like_count is null when likes_hidden=true: the author hid likes and Instagram gave only a placeholder). Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). collected_at is when the profile was last collected from Instagram and refreshes_regularly says whether it is re-collected on a schedule. This reads the catalog only; an unknown handle is not-found — call solari_fetch_instagram_account with that username first, then retry; a not-found that says the handle was renamed or deleted means Instagram has no account under that name, so search by display name instead. Works with any signed-in SOLARI account. */
                 profile<T = unknown>(args?: CatalogInstagramAccountProfileArgs): Promise<T>;
                 /** Resolves a brand/creator name or Instagram handle to candidate tracked accounts via fast deterministic index search — like a typeahead, all candidates are returned — and also searches profile bio text. query_type picks what the query is matched against: auto (default) matches handles by prefix and profile display names (Korean or English) by text match; username or full_name narrows to just one of those; bio runs a full-text search over profile bio text, which is how you discover accounts by what they say about themselves ("skincare", "협찬 문의", "コスメ") rather than by name. Ranked by match quality and follower count. Returns found plus items ordered best-first (items[0] is the top match), each with account_id (the SOLARI account UUID every other tool takes), username, full_name, biography, follower_count, region, is_verified, and profile_pic_url; found=false with empty items means nothing matched. In the name modes the query must actually appear in the handle or display name — phonetic aliases and abbreviations do not resolve, so retry with the native spelling (for example the English brand name). Set brands_only=true when resolving a brand name to filter out fan and meme accounts; pair it with query_type=bio to sweep a category of brands. Leave region unset unless the user asked for one country — it drops every account outside that region. Works with any signed-in SOLARI account. Use this first to resolve any entity mentioned by name. */
                 search<T = unknown>(args: CatalogInstagramAccountSearchArgs): Promise<T>;
             };
             content: {
-                /** Batch companion to solari_catalog_instagram_content_detail: hydrates up to 100 posts by their SOLARI post UUIDs in a single call. Each row carries slug, caption, posted_at, like/comment counts, play_count for videos, and the author's username and account_id. Untracked ids are omitted, so found can be lower than requested. Feed it post_id lists from solari_insight_instagram_brand_overview (full=true), solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, or the trend feeds. 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. */
+                /** Batch companion to solari_catalog_instagram_content_detail: hydrates up to 100 posts by their SOLARI post UUIDs in a single call. Each row carries slug, caption, posted_at, like/comment counts, play_count for videos, and the author's username and account_id; like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). Untracked ids are omitted, so found can be lower than requested. Feed it post_id lists from solari_insight_instagram_brand_overview (full=true), solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, or the trend feeds. 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. */
                 batch<T = unknown>(args: CatalogInstagramContentBatchArgs): Promise<T>;
-                /** Detail for one Instagram post in the SOLARI catalog, in the same item shape as solari_insight_instagram_content_trending entries. Identify the post by post_id (SOLARI post UUID from solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, solari_insight_instagram_content_trending, or solari_insight_instagram_content_rising), by slug (the public Instagram shortcode), or by url (the public post URL). This reads the catalog only; item is null when the post is not stored — call solari_fetch_instagram_post with the same url or slug to collect it and learn its author, or solari_fetch_instagram_posts when you already know the author's username. 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. */
+                /** Detail for one Instagram post in the SOLARI catalog, in the same item shape as solari_insight_instagram_content_trending entries. like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). Identify the post by post_id (SOLARI post UUID from solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, solari_insight_instagram_content_trending, or solari_insight_instagram_content_rising), by slug (the public Instagram shortcode), or by url (the public post URL). This reads the catalog only; item is null when the post is not stored — call solari_fetch_instagram_post with the same url or slug to collect it and learn its author, or solari_fetch_instagram_posts when you already know the author's username. 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. */
                 detail<T = unknown>(args?: CatalogInstagramContentDetailArgs): Promise<T>;
-                /** Recorded engagement of Instagram posts over time, for growth curves and engagement comparisons. Each item is one post (post_id, slug, url, posted_at, account_id, username) with points: like_count, comment_count, play_count, reshare_count, likes_hidden, and deleted, oldest first, each with captured_at: the moment the catalog collected those values. Choose posts with post_ids, slugs, or urls (up to 50 combined; missing lists the ones not in the catalog — collect them with solari_fetch_instagram_post), or give an account (account_id or username) to trace its newest posts, narrowed by posted_since/posted_until and limit (default 20, max 50). since/until narrow the recorded points (UTC dates, inclusive). granularity=day (default) keeps the last point of each UTC day per post; all returns every point; truncated=true means older points were dropped. Posts are re-collected mostly in their first days, so older posts have few points. likes_hidden=true means the author hid like and view counts, but like_count is usually still present, so do not drop those posts from comparisons. This reads the catalog only. Works with any signed-in SOLARI account. */
+                /** Recorded engagement of Instagram posts over time, for growth curves and engagement comparisons. Each item is one post (post_id, slug, url, posted_at, account_id, username) with points: like_count, comment_count, play_count, reshare_count, likes_hidden, and deleted, oldest first, each with captured_at: the moment the catalog collected those values. Choose posts with post_ids, slugs, or urls (up to 50 combined; missing lists the ones not in the catalog — collect them with solari_fetch_instagram_post), or give an account (account_id or username) to trace its newest posts, narrowed by posted_since/posted_until and limit (default 20, max 50). since/until narrow the recorded points (UTC dates, inclusive). granularity=day (default) keeps the last point of each UTC day per post; all returns every point; truncated=true means older points were dropped. Posts are re-collected mostly in their first days, so older posts have few points. likes_hidden=true means the author hid like counts: Instagram then returns a placeholder instead of the real number, so like_count comes back null — do not treat it as a measured value or as zero likes. This reads the catalog only. Works with any signed-in SOLARI account. */
                 history<T = unknown>(args?: CatalogInstagramContentHistoryArgs): Promise<T>;
-                /** Lexical keyword search over tracked posts: matches captions, creator bios, and video transcription text (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, author account_id/username, caption, transcription text, engagement counts, and score — feed post_id into solari_catalog_instagram_content_detail or solari_catalog_instagram_content_batch and the account reference into the account tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). 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. */
+                /** Lexical keyword search over tracked posts: matches captions, creator bios, and video transcription text (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, author account_id/username, caption, transcription text, engagement counts (like_count is null when likes_hidden=true: the author hid likes and Instagram gave only a placeholder), and score — feed post_id into solari_catalog_instagram_content_detail or solari_catalog_instagram_content_batch and the account reference into the account tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). 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. */
                 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>;
             };
         };
@@ -825,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 posts for one Instagram account into the SOLARI catalog by exact username. This is not a post listing: use solari_catalog_instagram_account_posts to read stored rows. An account collected within the last day is not scraped again unless only a few of its posts are stored (stored_post_count well below profile_post_count); an older or sparsely collected copy is re-collected now with its posts queued right away (refreshed=true), and a handle the catalog only knows by name from a tag or mention is crawled the same way. posts_collected_at tells how far the stored posts reach. A first-time ingest can take several seconds and the posts land shortly after, so re-read the catalog after a short wait. 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: {
@@ -872,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. */
@@ -880,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. */
@@ -888,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: {
@@ -911,7 +917,7 @@ export interface SolariTools {
             content: {
                 /** Counts and engagement rollups over tracked posts, for questions answered by numbers rather than by individual posts: posts per account per month, which hashtags dominate a topic, average likes by format. Group by account, post_type, hashtag, mention, caption_keyword, or transcription_keyword, and optionally split each group by day, week, or month. post_count always comes back; request metrics for like/comment/view sums and averages, mean follower count, and distinct account counts. Narrow the set with a free-text query, usernames, hashtags, mentions, or post_types. Filtering by mentions and grouping by account answers which accounts tagged a given handle. Coverage: regions KR, JP, US, and TW, holding roughly the most recent 6 months — a since older than that is clamped and the applied value is echoed back. Buckets are largest-first; truncated=true means more groups existed than limit returned. Use solari_catalog_instagram_content_search when the posts themselves are needed instead of counts. Works with any signed-in SOLARI account. */
                 aggregate<T = unknown>(args?: InsightInstagramContentAggregateArgs): Promise<T>;
-                /** Instagram posts whose recent performance is accelerating faster than baseline in the region. Same shape as solari_insight_instagram_content_trending including cursor pagination and optional brand personalization via a brand account_id or username. 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. */
+                /** Instagram posts whose recent performance is accelerating faster than baseline in the region. Same shape as solari_insight_instagram_content_trending including cursor pagination and optional brand personalization via a brand account_id or username. like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). 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. */
                 rising<T = unknown>(args?: InsightInstagramContentRisingArgs): Promise<T>;
                 /** Instagram posts that look and read like one given post — same subject, format and mood — ranked best first, for collecting references around a post you already have. Each item carries post_id, slug, author account_id, thumbnail and media URL, media type, play count, posted_at and is_ad (whether it was identified as sponsored). Identify the post by post_id (SOLARI post UUID from any content tool). Covers roughly the last 4 months; pages reach at most 180 results. Use solari_insight_instagram_brand_lookalike_content to start from a brand's ads instead. Works with any signed-in SOLARI account. */
                 similar<T = unknown>(args: InsightInstagramContentSimilarArgs): Promise<T>;
@@ -919,13 +925,13 @@ export interface SolariTools {
                     /** The SOLARI trend digest: recent content trend clusters for a region with cluster metadata and member posts, optionally reranked by brand affinity when a brand account_id or username is supplied. Works with any signed-in SOLARI account. */
                     clusters<T = unknown>(args?: InsightInstagramContentTrendClustersArgs): Promise<T>;
                 };
-                /** Instagram posts currently trending in the region, enriched with creator profile fields. Supports cursor pagination via next_cursor from the previous response. Optionally personalizes ranking with a brand account_id or username. 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. Use solari_insight_instagram_content_rising for velocity-led accelerating posts instead. */
+                /** Instagram posts currently trending in the region, enriched with creator profile fields. like_count is null when likes_hidden=true (the author hid likes and Instagram gave only a placeholder). Supports cursor pagination via next_cursor from the previous response. Optionally personalizes ranking with a brand account_id or username. 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. Use solari_insight_instagram_content_rising for velocity-led accelerating posts instead. */
                 trending<T = unknown>(args?: InsightInstagramContentTrendingArgs): Promise<T>;
             };
             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.11",
+	"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",