Get brand
One published brand with its stats (videos, creators, views, median and top viral factor, platform split), its top hooks, the creators making its videos and how its videos split across niches, formats, visual formats and hook tactics. Its videos are List videos with brand. Needs an account (any plan). Each request counts against the team's call allowance, shared with MCP; past it, a 402.
/api/v1/brands/{slug}Authentication
OAuth token, API key or signed-in session, sent as Authorization: Bearer <token> (a session rides on its cookie). An OAuth token needs mcp:read. See authentication.
Path parameters
slugstringrequiredA brand slug from List brands.
Response fields
slugstringPass as
brandto List videos, or to Get brand.namestringkindenumOne of
app,ecom,other.genrestring or nullThe App Store genre ("Education"), when it has one.
descriptionstring or nullFor apps: "<Genre> app by <Developer>" from the store listing.
video_countintegerPublic viral videos promoting it.
creator_countintegerDistinct creator accounts among them.
top_viral_factornumber or nullThe best viral factor among its videos.
iconstring or null (uri)The app icon.
app_store_urlstring or null (uri)Its App Store listing.
play_store_urlstring or null (uri)Its Google Play listing.
websitestring or null (uri)Its website.
urlstring (uri)The brand's page on this site, /brands/{slug}. Link the reader here.
statsobjectWith
video_count,creator_count,total_views,median_viral_factor,top_viral_factor,tiktok_count,instagram_count.hooksarray of objectThe opening lines of its most viral videos, one per distinct hook.
creatorsarray of objectThe accounts with the most videos for it.
nichesarray of objectEach with
slug,name,url,videoCount.formatsarray of objectA video can have several formats.
visual_formatsarray of objectHow the videos are shot and edited (up to three per video).
hook_tacticsarray of objectThe attention device of the first seconds.
videos_urlstring (uri)List videos for this brand, most viral first.
Responses
- 200
One app or brand: its numbers, hooks, creators and mix. Body:
BrandDetail. - 401
No account: send an API key, an OAuth access token or a session cookie. WWW-Authenticate names the protected-resource metadata. Body:
Problem. - 402
The team's call allowance is used up (
quota_exceeded), or the account has no plan and so no calls (no_plan), or an account with no plan asked past a list's first page (plan_limit);resolutionsays what to do and links the plans page. Body:Problem. - 403
The token lacks mcp:read. Body:
Problem. - 404
No such niche, format, brand, creator, page or endpoint. Body:
Problem. - 429
Rate limit exceeded; wait Retry-After seconds. Body:
Problem. - 500
The request failed on our side. Body:
Problem.