Skip to main content
POST
Get Brand Intelligence Social Own Insights Route

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

brand_id
string<uuid>
required

Body

application/json

The brand's OWN organic-social slice. Carries no cohort at all.

Deliberately NOT a subject field on SocialGroupInsightsRequest. The own-brand subject is exactly one domain and the server derives it from the Brand row; a request that could also name its own subject would need a "do the two agree?" check, and that is the kind of check somebody eventually forgets. With no domains field there is nothing to disagree with.

group_label is absent for the same reason: there is no group.

window_days
enum<integer>
default:30
Available options:
7,
30,
90
platforms
enum<string>[]
Maximum array length: 6
Available options:
youtube,
x,
linkedin,
instagram,
facebook,
tiktok

Response

Successful Response

brand_id
string<uuid>
required
generated_at
string<date-time>
required
group_key
string
required
window
SocialWindow · object
required

Equal, half-open UTC comparison windows: [start, end).

module
string
default:social
Allowed value: "social"
group_label
string | null
cohort_domains
string[]
platforms
enum<string>[]
Available options:
youtube,
x,
linkedin,
instagram,
facebook,
tiktok
coverage
SocialCoveragePanel · object
pulse
SocialPulsePanel · object
format_mix
SocialFormatMixPanel · object
platform_footprint
SocialPlatformFootprintPanel · object
brand_leaderboard
SocialBrandLeaderboardPanel · object
publishing_rhythm
SocialPublishingRhythmPanel · object
topics_hashtags
SocialTopicsHashtagsPanel · object
top_posts
SocialTopPostsPanel · object
findings
ModuleRuleFinding · object[]
provenance
SocialInsightsProvenance · object
activity
SocialActivityRecency · object

Measured history that exists OUTSIDE the comparison window.

Without this the surface cannot tell "we have never measured this cohort" apart from "we measured it for weeks and acquisition then stalled", and it renders the first sentence for the second situation -- a confident lie about a cohort holding hundreds of captured posts. Every field is scoped to the analysed cohort and platform lens, so it answers exactly the question the empty panels raise.

sample_basis_notice
string
default:Computed from canonical public posts observed in stored competitor snapshots. Post counts and visible interactions are lower bounds, not complete platform firehoses; unavailable public metrics remain null.