@brandazine/solari-sdk 0.2.3 → 0.2.4

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.3";
+export declare const SDK_VERSION = "0.2.4";
 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.3";
+export const SDK_VERSION = "0.2.4";
 export const TOKEN_ENV = "SOLARI_TOKEN";
 const DEFAULT_TIMEOUT_MS = 150_000;
 export class SolariError extends Error {

package/dist/tools.generated.d.ts

@@ -476,7 +476,7 @@ export interface InsightInstagramHashtagTrendingArgs {
     /** Entries kept per list, default 30. Values above 100 are clamped to 100; top_total and rising_total give the full sizes. */
     "limit"?: number | undefined;
 }
-/** Brand leaderboard for a market: brands ranked by how the content that tags or mentions them performs — total views by default, or views per post, post count, creator count, likes, sponsored views or organic views. Each row carries the sponsored subset and the organic median views per post, so the sponsored share reads per brand. Narrow to a category with scope; pass a brand to get its own rank as me, or find_username to locate any brand. Data is a daily snapshot (snapshot_at). Works with any signed-in SOLARI account. */
+/** Brand leaderboard for a market: brands ranked by how the content that tags or mentions them performs — total views by default, or views per post, post count, creator count, likes, sponsored views or organic views. Each row splits that content into sponsored and organic (not sponsored): sponsored_post_count, sponsored_total_plays and sponsored_median_plays for the sponsored part, organic_post_count, organic_total_plays and organic_median_plays for the rest, and sponsored_share (sponsored posts over all posts). Answer organic-only questions from this split, and get organic example posts from solari_insight_instagram_ranking_posts with kind=organic. Narrow to a category with scope; pass a brand to get its own rank as me, or find_username to locate any brand. Data is a daily snapshot (snapshot_at). Works with any signed-in SOLARI account. */
 export interface InsightInstagramRankingBrandsArgs {
     /** Market. */
     "region"?: "KR" | "JP" | "US" | undefined;
@@ -499,7 +499,7 @@ export interface InsightInstagramRankingBrandsArgs {
     /** Pagination offset, default 0. */
     "offset"?: number | undefined;
 }
-/** Creator leaderboard for a market: creators who make brand-tagged content, ranked within a category so a specialist is not beaten by a large account with one post in it. Sort by total views, views per post, likes, number of brands worked with, sponsored views, reach (views per follower), lift (views per post against the creator's own usual median) or one-month view growth; the last three are null when a creator's baseline is too small. Each row carries the sponsored subset and the organic median. kind=magazine ranks magazine and media accounts instead. Brand-owned, agency and shop accounts are excluded. Data is a daily snapshot (snapshot_at). Works with any signed-in SOLARI account. */
+/** Creator leaderboard for a market: creators who make brand-tagged content, ranked within a category so a specialist is not beaten by a large account with one post in it. Sort by total views, views per post, likes, number of brands worked with, sponsored views, reach (views per follower), lift (views per post against the creator's own usual median) or one-month view growth; the last three are null when a creator's baseline is too small. Each row splits the creator's content into sponsored and organic the same way as the brand board: sponsored_* and organic_* post counts, total views and views per post, plus sponsored_share. kind=magazine ranks magazine and media accounts instead. Brand-owned, agency and shop accounts are excluded. Data is a daily snapshot (snapshot_at). Works with any signed-in SOLARI account. */
 export interface InsightInstagramRankingCreatorsArgs {
     /** Market (the creator's own region). */
     "region"?: "KR" | "JP" | undefined;
@@ -526,7 +526,7 @@ export interface InsightInstagramRankingCreatorsArgs {
     /** Pagination offset, default 0. */
     "offset"?: number | undefined;
 }
-/** Where one Instagram account stands, without knowing whether it is a brand or a creator: for each board it appears on (brand, creator), its rank, pool size and top percentile in every category it belongs to, plus its overall row. Ranked by total views with the loosest filters. A side is null when the account is not on that board. Works with any signed-in SOLARI account. */
+/** Where one Instagram account stands, without knowing whether it is a brand or a creator: for each board it appears on (brand, creator), its rank, pool size and top percentile in every category it belongs to, plus its overall row with the sponsored and organic split (organic_post_count, organic_total_plays, organic_median_plays, sponsored_share). The quickest way to answer how one brand's organic content performs. Ranked by total views with the loosest filters. A side is null when the account is not on that board. Works with any signed-in SOLARI account. */
 export interface InsightInstagramRankingFindArgs {
     /** Instagram handle, with or without a leading @. */
     "username": string;
@@ -535,7 +535,7 @@ export interface InsightInstagramRankingFindArgs {
     /** Window in days: 30 or 90. */
     "days"?: number | undefined;
 }
-/** The best-performing posts behind one leaderboard row — the evidence for a brand's or creator's number — each marked sponsored or not. Pass the row's account_id with the same board, region, days (and scope for creators) the list used; kind=sponsored keeps the sponsored subset only. Works with any signed-in SOLARI account. */
+/** The best-performing posts behind one leaderboard row — the evidence for a brand's or creator's number — each marked sponsored or not. Pass the row's account_id with the same board, region, days (and scope for creators) the list used. kind=sponsored keeps the sponsored subset; kind=organic keeps the posts that are not sponsored. A row keeps its top 6 posts by views, so kind=organic returns the organic ones among those (checked_top_posts says how many were checked) and can come back short or empty when sponsored posts fill the top. Works with any signed-in SOLARI account. */
 export interface InsightInstagramRankingPostsArgs {
     /** Which leaderboard the row came from. */
     "board": "brand" | "creator";
@@ -547,8 +547,8 @@ export interface InsightInstagramRankingPostsArgs {
     "days"?: number | undefined;
     /** Creator board only: the same scope the list used. Omitted: 'all'. */
     "scope"?: string | undefined;
-    /** All top posts, or the sponsored subset. */
-    "kind"?: "all" | "sponsored" | undefined;
+    /** all = the row's top posts, sponsored = its top sponsored posts, organic = its top posts that are not sponsored. */
+    "kind"?: "all" | "sponsored" | "organic" | undefined;
     /** Maximum posts, default 6. Values above 12 are clamped to 12. */
     "limit"?: number | undefined;
 }
@@ -794,13 +794,13 @@ export interface SolariTools {
                 trending<T = unknown>(args?: InsightInstagramHashtagTrendingArgs): Promise<T>;
             };
             ranking: {
-                /** Brand leaderboard for a market: brands ranked by how the content that tags or mentions them performs — total views by default, or views per post, post count, creator count, likes, sponsored views or organic views. Each row carries the sponsored subset and the organic median views per post, so the sponsored share reads per brand. Narrow to a category with scope; pass a brand to get its own rank as me, or find_username to locate any brand. Data is a daily snapshot (snapshot_at). Works with any signed-in SOLARI account. */
+                /** Brand leaderboard for a market: brands ranked by how the content that tags or mentions them performs — total views by default, or views per post, post count, creator count, likes, sponsored views or organic views. Each row splits that content into sponsored and organic (not sponsored): sponsored_post_count, sponsored_total_plays and sponsored_median_plays for the sponsored part, organic_post_count, organic_total_plays and organic_median_plays for the rest, and sponsored_share (sponsored posts over all posts). Answer organic-only questions from this split, and get organic example posts from solari_insight_instagram_ranking_posts with kind=organic. Narrow to a category with scope; pass a brand to get its own rank as me, or find_username to locate any brand. Data is a daily snapshot (snapshot_at). Works with any signed-in SOLARI account. */
                 brands<T = unknown>(args?: InsightInstagramRankingBrandsArgs): Promise<T>;
-                /** Creator leaderboard for a market: creators who make brand-tagged content, ranked within a category so a specialist is not beaten by a large account with one post in it. Sort by total views, views per post, likes, number of brands worked with, sponsored views, reach (views per follower), lift (views per post against the creator's own usual median) or one-month view growth; the last three are null when a creator's baseline is too small. Each row carries the sponsored subset and the organic median. kind=magazine ranks magazine and media accounts instead. Brand-owned, agency and shop accounts are excluded. Data is a daily snapshot (snapshot_at). Works with any signed-in SOLARI account. */
+                /** Creator leaderboard for a market: creators who make brand-tagged content, ranked within a category so a specialist is not beaten by a large account with one post in it. Sort by total views, views per post, likes, number of brands worked with, sponsored views, reach (views per follower), lift (views per post against the creator's own usual median) or one-month view growth; the last three are null when a creator's baseline is too small. Each row splits the creator's content into sponsored and organic the same way as the brand board: sponsored_* and organic_* post counts, total views and views per post, plus sponsored_share. kind=magazine ranks magazine and media accounts instead. Brand-owned, agency and shop accounts are excluded. Data is a daily snapshot (snapshot_at). Works with any signed-in SOLARI account. */
                 creators<T = unknown>(args?: InsightInstagramRankingCreatorsArgs): Promise<T>;
-                /** Where one Instagram account stands, without knowing whether it is a brand or a creator: for each board it appears on (brand, creator), its rank, pool size and top percentile in every category it belongs to, plus its overall row. Ranked by total views with the loosest filters. A side is null when the account is not on that board. Works with any signed-in SOLARI account. */
+                /** Where one Instagram account stands, without knowing whether it is a brand or a creator: for each board it appears on (brand, creator), its rank, pool size and top percentile in every category it belongs to, plus its overall row with the sponsored and organic split (organic_post_count, organic_total_plays, organic_median_plays, sponsored_share). The quickest way to answer how one brand's organic content performs. Ranked by total views with the loosest filters. A side is null when the account is not on that board. Works with any signed-in SOLARI account. */
                 find<T = unknown>(args: InsightInstagramRankingFindArgs): Promise<T>;
-                /** The best-performing posts behind one leaderboard row — the evidence for a brand's or creator's number — each marked sponsored or not. Pass the row's account_id with the same board, region, days (and scope for creators) the list used; kind=sponsored keeps the sponsored subset only. Works with any signed-in SOLARI account. */
+                /** The best-performing posts behind one leaderboard row — the evidence for a brand's or creator's number — each marked sponsored or not. Pass the row's account_id with the same board, region, days (and scope for creators) the list used. kind=sponsored keeps the sponsored subset; kind=organic keeps the posts that are not sponsored. A row keeps its top 6 posts by views, so kind=organic returns the organic ones among those (checked_top_posts says how many were checked) and can come back short or empty when sponsored posts fill the top. Works with any signed-in SOLARI account. */
                 posts<T = unknown>(args: InsightInstagramRankingPostsArgs): Promise<T>;
             };
         };

package/package.json

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