Extract brand style
Opens a website in a browser and measures its brand style: fonts, colours, button and card shapes, the logo, and page screenshots.
Tool name: extract-brand-style.
Opens a website in a browser and measures its brand style: fonts, colours, button and card shapes, the logo, and page screenshots. Also keeps the site's own images: product shots, app screens and the hero. Stores the logos, font files, screenshots and images as brand assets and returns their assetIds. You are shown the screenshots, logos and images after the call. Takes up to a few minutes.
When to use
When building or updating the brand style guide, on the website the user chose. Then write the guide from these measurements and the images you are shown, and save it with save-brand-style-guide. When the site is another brand's, read to make ads for it, use what it returns in this chat only and never save it as this brand's guide.
Access
| Property | Value |
|---|---|
| Required scope | write |
| Publishes | No |
| Read-only | No |
| Destructive | No |
| Idempotent | No |
| Open world | Yes |
Input
| Field | Type | Required | Description |
|---|---|---|---|
url | string | Yes | The website to read, such as "koast.ai" or a full https address. At most 2048 characters. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
url | string | Yes | |
finalUrl | string | Yes | |
title | string | null | Yes | |
description | string | null | Yes | |
navLinks | object[] | Yes | At most 20 items. |
fonts | object | Yes | |
colors | object | Yes | |
shapes | object | Yes | |
logos | object[] | Yes | |
screenshots | object[] | Yes | |
images | object[] | Yes | The site's own images: product shots, app screens, the hero and its social image, stored as brand assets. Pass a url as an imageUrl reference to generate-creatives, or use it as an <img> src in render-creative html. At most 6 items. |
modelImages | object[] | Yes | Images shown to you after this call. At most 12 items. |
REST equivalent
POST /v1/brands/{brandId}/style-guide/extractions, Extract brand style. CLI: koast extract-brand-style.
List structure templates
List the user's saved STRUCTURE templates (rule-based campaign blueprints applied to pipeline cards).
Get brand style guide
Returns the active brand's style guide, when the user confirmed it, its logo, fontCss: CSS that loads the guide's fonts in an HTML layout, the website images kept by the last extract-brand-style, and taste: the images the brand's people liked, disliked or picked as references, and agencyAdAccount: whether the brand runs ads on an agency ad account from Koast, whose ads the partner also reviews, with stricter rules than Meta's.