webclaw

Brand

Extract brand identity from any website. Analyzes DOM structure and CSS to find colors, fonts, logos, and favicons.

POST/v1/brand

Extract brand identity (colors, fonts, logos) from a URL.

Request body

json
{
  "url": "https://example.com"
}
FieldTypeRequiredDescription
urlstringYesURL of the site to analyze.

Response

json
{
  "colors": [
    { "hex": "#FF5733", "usage": "Primary", "count": 15 },
    { "hex": "#2C3E50", "usage": "Text", "count": 42 },
    { "hex": "#ECF0F1", "usage": "Background", "count": 8 }
  ],
  "fonts": [
    "Inter",
    "Roboto Mono"
  ],
  "logo_url": "https://example.com/images/logo.svg",
  "favicon_url": "https://example.com/favicon.ico"
}
FieldTypeDescription
colorsarrayDetected colors with hex value, inferred usage, and occurrence count.
fontsstring[]Font families found in stylesheets and inline styles.
logo_urlstring?URL of the detected logo image, if found.
favicon_urlstring?Favicon URL from link tags or the default /favicon.ico path.
Note
Brand extraction works entirely from the HTML and inline CSS -- no headless browser is used. Colors are detected from inline styles, style tags, and common CSS patterns. Results are best on marketing pages and homepages.

Example

curl
curl -X POST https://api.webclaw.io/v1/brand \
  -H "Authorization: Bearer wc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://stripe.com"}'