Skip to content

List brands

The apps and brands the library's videos promote, most videos first: each with the slug List videos and Get brand take, its store and website links, icon, video and creator counts and page URL. Only brands with enough public videos from more than one creator, or from their own account, are listed. 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

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.

Response fields

  • brandsarray of Brand

    Each with slug, name, kind, genre, description, video_count, creator_count, top_viral_factor, icon, app_store_url, play_store_url, website, url.

Responses

  • 200

    Every published app and brand, with its slug and video count.

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

  • 429

    Rate limit exceeded; wait Retry-After seconds. Body: Problem.

  • 500

    The request failed on our side. Body: Problem.