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
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.