Skip to content

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.

get/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

Response fields

  • slugstring

    Pass as brand to List videos, or to Get brand.

  • namestring

  • kindenum

    One of app, ecom, other.

  • genrestring or null

    The App Store genre ("Education"), when it has one.

  • descriptionstring or null

    For apps: "<Genre> app by <Developer>" from the store listing.

  • video_countinteger

    Public viral videos promoting it.

  • creator_countinteger

    Distinct creator accounts among them.

  • top_viral_factornumber or null

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

  • statsobject

    With video_count, creator_count, total_views, median_viral_factor, top_viral_factor, tiktok_count, instagram_count.

  • hooksarray of object

    The opening lines of its most viral videos, one per distinct hook.

  • creatorsarray of object

    The accounts with the most videos for it.

  • nichesarray of object

    Each with slug, name, url, videoCount.

  • formatsarray of object

    A video can have several formats.

  • visual_formatsarray of object

    How the videos are shot and edited (up to three per video).

  • hook_tacticsarray of object

    The 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); resolution says 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.