Brand.dev - Brand Intelligence API

Brand.dev - Brand Intelligence API

Setup

Read your credentials from ~/.gooseworks/credentials.json:

export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login

All endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY"

Extract comprehensive brand information from any domain - logos, colors, fonts, and more.

Capabilities

• Extract fonts from website: Extract font information from a brand’s website including font families, usage statistics, fallbacks, and element/word counts
• Identify brand from transaction data: Endpoint specially designed for platforms that want to identify transaction data by the transaction title
• Retrieve NAICS code for any brand: Endpoint to classify any brand into a 2022 NAICS code
• Retrieve brand data by email address: Retrieve brand information using an email address while detecting disposable and free email addresses
• Retrieve simplified brand data by domain: Returns a simplified version of brand data containing only essential information: domain, title, colors, logos, and backdrops
• Retrieve brand data by ISIN: Retrieve brand information using an ISIN (International Securities Identification Number)
• Extract products from a brand's website: Beta feature: Extract product information from a brand’s website
• Retrieve brand data by domain: Retrieve logos, backdrops, colors, industry, description, and more from any domain
• Retrieve brand data by company name: Retrieve brand information using a company name
• Retrieve brand data by stock ticker: Retrieve brand information using a stock ticker symbol
• Extract design system and styleguide from website: Automatically extract comprehensive design system information from a brand’s website including colors, typography, spacing, shadows, and UI components
• Take screenshot of website: Capture a screenshot of a website
• Query website data using AI: Use AI to extract specific data points from a brand’s website

Usage

Extract fonts from website

Extract font information from a brand’s website including font families, usage statistics, fallbacks, and element/word counts.

Parameters:

• domain* (string) - Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The domain will be automatically normalized and validated.