Skip to content
MSO CloudDocumentation

Market and social intelligence

On this page

The third-party estimate plane, kept apart from first-party validation and from chat.

marketIntel#

Source: apps/web/src/server/routers/market-intel.ts

Procedure Type Access Description
marketIntel.trendSeries query brandProcedure Market trajectory per estimate window + own GMV/NMV overlay (org basis).
marketIntel.creatorMomentum query brandProcedure Creator momentum across windows: leaders, risers, newcomers.
marketIntel.productOpportunities query brandProcedure Market product list joined to own catalog: whitespace + weekly momentum.
marketIntel.comboLeaderboard query brandProcedure Top combo recipes + listings in the category market, by revenue (3p_derived, to_validate).
marketIntel.priceBands query brandProcedure —
marketIntel.launchVelocity query brandProcedure —
marketIntel.freshness query brandProcedure Most-recent snapshot capture for the platform — the staleness badge input.
marketIntel.competitorTrends query brandProcedure Competitor ranking movement across windows: top series, movers, entrants.
marketIntel.watchlistCard query brandProcedure Card: latest weekly value + delta per watched entity.
marketIntel.signals query authedProcedure Tier-ranked "what changed this week" signals (estimates).
marketIntel.industry.shops.list query brandProcedure Ranked shops for a month, a month range or the whole span, with search, sort, quick filters and paging.
marketIntel.industry.shops.detail365 query brandProcedure One shop's 365-day capture: totals, powder brand share, products, creators, videos, lives.
marketIntel.industry.shops.overview query brandProcedure Monthly totals of the ranked shops: seller type, channel and attribution mix, cap notes.
marketIntel.industry.shops.detail query brandProcedure One shop: monthly rank and revenue, channel and attribution split, the cohort creators and products through it.
marketIntel.industry.content.page query brandProcedure One server page of the live / video sample: filters, sort, totals, recorded counts.
marketIntel.industry.content.stats query brandProcedure The sample aggregates under the list's own filters (account type, quick filter and, for videos, brand / form through linked products), so the KPIs and charts follow the table.
marketIntel.industry.content.item query brandProcedure One session / video: figures, creator, linked products with their brand and form.
marketIntel.industry.contentSessions.available query brandProcedure Whether the org holds top-session captures (the pages fall back to the creator source when not).
marketIntel.industry.contentSessions.page query brandProcedure —
marketIntel.industry.contentSessions.summary query brandProcedure —
marketIntel.industry.contentSessions.item query brandProcedure —
marketIntel.industry.catalog query brandProcedure Industries, captured months (vendor windows), detail window and account types the org holds.
marketIntel.industry.topCreators query brandProcedure Top creators for a month or the whole span, by industry and account type (estimates).
marketIntel.industry.topProducts query brandProcedure Top products for a month or the whole span (Σ monthly lists, a lower bound), by industry, each with its estimated brand.
marketIntel.industry.productDetail query brandProcedure One product: its monthly ranks and revenue, and the creator-detail cohort's sellers of it.
marketIntel.industry.topVideos query brandProcedure Top videos of the creator-detail cohort over its window, by industry and account type.
marketIntel.industry.topLives query brandProcedure Top livestreams of the creator-detail cohort over its window, by industry and account type.
marketIntel.industry.creatorProfile query brandProcedure One creator: window totals, monthly ranks, shops, products, videos and lives.
marketIntel.industry.productLinks query brandProcedure One product's cross-links: the shop that sells it and the videos / lives that sold it.
marketIntel.industry.reportConfig query brandProcedure The org's report config as the page controls need it: industries (ordered, labelled), focus brands, dictionary presence.
marketIntel.industry.overview query brandProcedure Monthly top-product revenue, channel mix, account-type split and creator concentration per industry.
marketIntel.industry.productsPage query brandProcedure One page of the product ranking with brand / form / type / text filters, sort and total count.
marketIntel.industry.priceBands query brandProcedure Revenue by unit-price band with the product list's brand / form / search / period filters.
marketIntel.industry.creatorsPage query brandProcedure One page of the creator ranking per industry (or one merged list), with rank band, cohort tier, account type, text and cohort brand filters.
marketIntel.industry.brands.splits query brandProcedure Brand split by channel, product form and (cohort) selling shop type, the unrecognised part apart.
marketIntel.industry.brands.detail query brandProcedure One brand: monthly share, channel and form split, price bands, top products and cohort sellers.
marketIntel.industry.brandLeague query brandProcedure Brand league: rank, share, Δ points vs the previous window, 12-month spark, products, cohort sellers, main channel.
marketIntel.industry.topMovers query brandProcedure Products and brands with the largest revenue change, month over previous month.
marketIntel.industry.tierBrandShares query brandProcedure Brand split of the creator-detail cohort by creator rank band, per industry and account type.
marketIntel.industry.channelMatrix query brandProcedure Share by channel and rank band: shop lists (brand shops / retailers) and creator cohorts at ranks 1–100, 101–200, top 200.
marketIntel.industry.prospects query brandProcedure Top-N creators of the period with a 365-day profile who sold none of the focus brand (per industry).
marketIntel.industry.brandShare query brandProcedure Brand share of top-product revenue by the label layer (powder by default), with coverage and monthly lines.
marketIntel.industry.creatorBrandMix query brandProcedure One creator's own product revenue split by brand, focus brands always present.
marketIntel.industry.cohortBrandMix query brandProcedure The creator-detail cohort's brand split, plus each creator's main brand and focus revenue.
marketIntel.industry.contentStats query brandProcedure Live / video sample aggregates (start hour, month, account type, length, ad share); no identities.
marketIntel.industry.topContentMonth query brandProcedure One ICT month of the live / video sample, ranked by revenue (the month view of topLives/topVideos).
marketIntel.ingestExport mutation rateLimitedBrandProcedure, owner or admin —
marketIntel.ingestShopeeJson mutation rateLimitedBrandProcedure, owner or admin —
marketIntel.deleteSnapshot mutation rateLimitedBrandProcedure, owner or admin Remove one snapshot (children cascade).
marketIntel.creatorClassification query brandProcedure —
marketIntel.setCreatorTypeOverride mutation rateLimitedBrandProcedure, owner or admin Record the human classification for one or many creators (Layer 2).
marketIntel.clearCreatorTypeOverride mutation rateLimitedBrandProcedure, owner or admin Drop the human classification and fall back to the machine's opinion.
marketIntel.snapshots query brandProcedure Ingested snapshots, newest first — the admin "what data do we have".
marketIntel.periods query brandProcedure Available estimate windows (for the period picker), newest first.
marketIntel.platforms query brandProcedure Which marketplaces have ingested market data (drives the platform tab).
marketIntel.livestream query brandProcedure —
marketIntel.overview query brandProcedure —
marketIntel.decomposition query brandProcedure —
marketIntel.diagnosticScan query brandProcedure —
marketIntel.demandShift query brandProcedure —
marketIntel.bundleAnalysis query brandProcedure —
marketIntel.platformContribution query brandProcedure —
marketIntel.leverSweep query brandProcedure —
marketIntel.benchmarkTriad query authedProcedure —
marketIntel.socialPanel query brandProcedure —
marketIntel.socialReport query authedProcedure —
marketIntel.socialBuzzComposition query brandProcedure —
marketIntel.competitors.list query brandProcedure —
marketIntel.competitors.suggestions query authedProcedure Ranked competitor suggestions from the brand's category-scoped market-data shop history + 1P profile, excluding the own shop and any already-listed or dismissed shop.
marketIntel.competitors.searchShops query brandProcedure Search the category-scoped market-data shops by name (manual add).
marketIntel.competitors.add mutation rateLimitedBrandProcedure Add (or re-activate) a shop on the watchlist — accept a suggestion or a manual pick.
marketIntel.competitors.dismiss mutation rateLimitedBrandProcedure, owner or admin Dismiss a suggestion — keep a row marked dismissed so it is never re-suggested.
marketIntel.competitors.remove mutation rateLimitedBrandProcedure, owner or admin Remove a shop from the watchlist entirely (it may be suggested again).
marketIntel.watchedCreators.list query brandProcedure —
marketIntel.watchedCreators.search query brandProcedure Search the estimate-plane creators by handle or name (manual add).
marketIntel.watchedCreators.add mutation rateLimitedBrandProcedure Add (or re-activate) a creator on the watchlist — a manual pick or an accepted suggestion.
marketIntel.watchedCreators.remove mutation rateLimitedBrandProcedure Remove a creator from the watchlist entirely (it may be searched/added again).
marketIntel.settings query brandProcedure Org-level Market Intelligence comparison basis (GMV default | NMV).
marketIntel.updateDemoMask mutation rateLimitedBrandProcedure —
marketIntel.updateComparisonBasis mutation rateLimitedBrandProcedure, owner or admin Set the org-level comparison basis (owner / org-admin only).
marketIntel.enabledMarketDataConnectors query brandProcedure —
marketIntel.marketDataConnector query brandProcedure —
marketIntel.saveMarketDataConnector mutation rateLimitedBrandProcedure, owner or admin —
marketIntel.testMarketDataConnector mutation authedProcedure, owner or admin Validate connectivity with one cheap category/rank call.
marketIntel.getInsightConfig query brandProcedure —
marketIntel.updateInsightConfig mutation rateLimitedBrandProcedure, owner or admin Save the org's AI-Insight configuration (owner / org-admin only).
marketIntel.insightStatus query brandProcedure Whether the AI insight is available for this org: an AI plugin (catalog category 'ai_decision') must be enabled for the org and an AI provider must be configured.
marketIntel.insight query brandProcedure Cached AI narrative for a window, or null while (re)generating.
marketIntel.requestInsight mutation rateLimitedBrandProcedure —

socialListening#

Source: apps/web/src/server/routers/social-listening.ts

Procedure Type Access Description
socialListening.report query orgProcedure —

socialTrends#

Source: apps/web/src/server/routers/social-trends.ts

Procedure Type Access Description
socialTrends.feedBoard query orgProcedure The ranked board of the asked window and slice: one state read and one slice read.
socialTrends.feedHistory query orgProcedure The rank lines of the board's trends over every stored cycle (one read); the page derives movement and the bump chart.
socialTrends.feedDetail query orgProcedure One trend: figures per window, keywords, sample posts and its rank history in the asked window (one read).
socialTrends.latestRanking query orgProcedure Most recent snapshot, ordered by rank, with rank movement vs the previous snapshot computed from two bounded reads (no cartesian join).
socialTrends.rankingHistory query orgProcedure —
socialTrends.topicPosts query orgProcedure Top posts for a topic, ranked by engagement (nulls last).: buyer PII is not present here — these are public social posts stored verbatim.
socialTrends.dailyTopTopics query orgProcedure Per ICT ranking day, the day's #1 (best-rank) topic + its buzz over the [from,to] window — the summary that backs the period picker.