Get Brand Assets
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 logos, colors, fonts, and design assets from any company's brand. Useful for partnerships, design work, and brand research.
When to Use
- User needs a company's logo
- User asks "what are [company]'s brand colors?"
- User is designing something that needs brand assets
- User wants to match a company's visual style
- Creating pitch decks or partnership materials
How It Works
Uses Brand.dev API to extract brand information directly from company websites.
Usage
Get Full Brand Data
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"brand-dev","path":"/v1/brand/retrieve","query":{"domain":"stripe.com"}}'
Get Simplified Brand Data (logo + colors)
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"brand-dev","path":"/v1/brand/retrieve-simplified","query":{"domain":"notion.so"}}'
Get Brand Fonts
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"brand-dev","path":"/v1/brand/fonts","query":{"domain":"linear.app"}}'
Get Design System/Styleguide
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"brand-dev","path":"/v1/brand/styleguide","query":{"domain":"vercel.com"}}'
Take Brand Screenshot
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"brand-dev","path":"/v1/brand/screenshot","query":{"domain":"figma.com"}}'
Parameters
- domain (required) - Company website domain (e.g., stripe.com)
Response
Full brand data includes:
- Logos - Various formats and sizes
- Colors - Primary, secondary, accent colors with hex codes
- Fonts - Font families used on the site
- Industry - Company industry/category
- Description - Company description
- Social links - Twitter, LinkedIn, etc.
Simplified data includes:
- Domain
- Company title
- Primary colors
- Logo URLs
- Backdrop images
Fonts include:
- Font family names
- Usage (headings, body, etc.)
- Fallback fonts
- Element counts
Styleguide includes:
- Color palette
- Typography scale
- Spacing values
- UI component styles
- Shadow definitions
Examples
User: "Get Notion's logo and brand colors"
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"brand-dev","path":"/v1/brand/retrieve-simplified","query":{"domain":"notion.so"}}'
User: "What fonts does Linear use?"
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"brand-dev","path":"/v1/brand/fonts","query":{"domain":"linear.app"}}'
User: "I need the full design system for Vercel"
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"brand-dev","path":"/v1/brand/styleguide","query":{"domain":"vercel.com"}}'
Tips
- Use the main company domain for best results
- Simplified endpoint is faster if you just need logo + colors
- Logo URLs are direct links you can download
- Colors are provided in hex format
- Styleguide extraction is comprehensive but takes longer