Change log

📝 New Feedback Widget: We’ve added a feedback widget to our developer portal to make it easier for you to share suggestions, report issues, and help us improve the API.

🛡️ Improved API Security & Error Handling: We’ve significantly enhanced our API’s error handling capabilities and implemented robust protection against potential DDoS attacks to ensure better service reliability and security.

Key Improvements:

• Enhanced Invalid Endpoint Handling - Better error responses and logging for requests to non-existent endpoints, helping developers quickly identify and fix integration issues
• Improved Input Validation - More comprehensive validation of API parameters with clearer error messages when invalid data is submitted
• DDoS Mitigation - Advanced rate limiting and traffic analysis to detect and mitigate potential distributed denial-of-service attacks
• Faster Error Responses - Optimized error handling pipeline reduces response times for invalid requests, improving overall API performance
• Better Error Documentation - Enhanced error codes and messages to help developers understand and resolve issues more efficiently

What This Means for You:

• More Reliable Service - Reduced risk of service disruptions from malicious traffic or invalid requests
• Better Developer Experience - Clearer error messages make debugging and integration easier
• Improved Performance - Faster rejection of invalid requests means more resources available for legitimate API calls
• Enhanced Security - Proactive protection against various attack vectors keeps our service stable for all users

These improvements are automatically active across all endpoints and require no changes to your existing integrations.

📝 Font Extraction Update: If you’re currently using the retrieve endpoint to extract font information from domains, we recommend migrating to our new styleguide endpoint for enhanced typography data.

Why Migrate?

• More Comprehensive Typography Data - Get detailed font specifications including font families, sizes, weights, line heights, and letter spacing for all heading levels (H1-H4) and body text
• Better Performance - The styleguide endpoint is optimized for design system extraction with faster response times
• Future-Proof - This endpoint will receive ongoing improvements for typography and design system extraction
• Enhanced Accuracy - More sophisticated font detection and analysis algorithms

What You’ll Get:

The styleguide endpoint provides much richer typography information compared to the basic font data in the retrieve endpoint, here’s a small example:

"typography": {
  "headings": {
    "h1": {
      "fontFamily": "Inter, sans-serif",
      "fontSize": "2.5rem",
      "fontWeight": 700,
      "lineHeight": "1.2",
      "letterSpacing": "0.025em"
    }
  },
  "p": {
    "fontFamily": "Inter, sans-serif",
    "fontSize": "1rem",
    "fontWeight": 400,
    "lineHeight": "1.6",
    "letterSpacing": "0.01em"
  }
}

Migration Path:

Simply replace your retrieve endpoint calls with the styleguide endpoint when you need font/typography data. The styleguide endpoint requires the same authentication and accepts the same domain parameter.

View Styleguide Endpoint Documentation

🚀 Major Performance Boost: We’ve been working to make our styleguide and screenshot APIs faster and higher quality. We added distributed caching, so repeat requests to the same domain are under 500ms. We also completely rewrote our styleguide extraction and screenshot generation pipelines to be much more efficient, resulting in 40-60% faster response times across both APIs for cold hits.

Screenshot API Now Live (Beta): We’re excited to announce our new Screenshot API, now available in beta! This endpoint allows you to capture high-quality screenshots of any website programmatically, perfect for building visual brand libraries, competitive analysis tools, or automated documentation systems.

Key Features:

• Flexible Screenshot Types - Choose between viewport screenshots (standard browser view) or full-page screenshots that capture all content
• CDN-Hosted Images - All screenshots are automatically uploaded to our fast, reliable CDN and returned as direct URLs
• Simple Integration - Just provide a domain and optionally specify full-page capture
• High Quality Output - Professional-grade screenshots ready for immediate use

Perfect Use Cases:

• Visual Brand Libraries - Automatically capture and archive website designs for brand analysis
• Competitive Intelligence - Monitor competitor website changes and design evolution over time
• Client Presentations - Generate current website screenshots for proposals and presentations
• Documentation & Reports - Include live website visuals in automated reporting systems
• Quality Assurance - Capture website states for testing and comparison workflows
• Portfolio Creation - Build visual portfolios showcasing website designs and layouts

This beta endpoint makes it incredibly easy to integrate website screenshot functionality into your applications without the complexity of managing headless browsers or image processing infrastructure.

Try it now!

Styleguide API Now Live (Beta): We’re excited to announce our new Design System & Styleguide API, now available in beta! This powerful endpoint automatically extracts comprehensive design system information from any brand’s website, giving you instant access to their visual DNA.

What You Get:

• Color Palette - Primary colors including accent, background, and text colors
• Typography System - Complete font specifications for headings (H1-H4) and body text including font families, sizes, weights, line heights, and letter spacing
• Spacing Scale - Standardized element spacing values (XS through XL)
• Shadow System - Box shadow definitions from subtle to dramatic effects
• Component Styles - Detailed styling for buttons (primary, secondary, link) and cards with all CSS properties

Example Use Cases:

• SaaS Dashboard Personalization - Automatically adapt your B2B software’s UI colors, fonts, and styling to match each client’s brand identity
• White-label Product Customization - Instantly extract and apply client branding to create seamless white-label experiences
• Personalized Email Campaigns - Use extracted brand colors and typography to create branded email templates that resonate with each prospect
• Custom Onboarding Flows - Dynamically style your onboarding experience to match new users’ company branding for higher engagement
• Sales Demo Personalization - Automatically theme your demo environment with prospect’s brand colors and fonts for more compelling presentations
• Client Portal Branding - Extract design systems to create branded client portals that feel like an extension of their own website

This beta endpoint provides an unprecedented level of design system intelligence, automatically parsing complex CSS and extracting the core visual components that define a brand’s digital identity. Simply provide a domain and get back a complete design system breakdown ready for analysis or implementation.

Try it now!

• Developer Portal Design: We’ve completely revamped the developer portal with a modern, intuitive interface that better reflects our brand identity. The new design features improved navigation, enhanced documentation readability, and a more cohesive visual experience across all pages. - Affiliate Program Launch: We’re excited to announce our new affiliate program! Earn 20% commission on all referrals when you help others discover the power of our API. Perfect for developers, agencies, and businesses looking to monetize their network while sharing valuable tools. Click here to sign up in 60 seconds or less.

• Data pipeline has been improved dramatically, on-demand API latency has dropped by 30% across the board.

Prefetch Endpoint Now Live: Our new prefetch endpoint is now available for all paid customers! This powerful optimization tool allows you to signal that you may need brand data for a particular domain soon, dramatically improving response times for subsequent API calls.

Key Features:

• Zero credit usage - Prefetch calls are completely free for subscribed customers
• Lightning-fast subsequent calls - Pre-warm our systems for instant data retrieval
• Perfect for user onboarding - Prefetch as soon as a user signs up for optimal experience
• Simple integration - Just POST to /brand/prefetch with the domain

Ideal Use Cases:

• Pre-load brand data during user registration flows
• Optimize performance for high-priority domains
• Reduce latency in real-time applications
• Enhance user experience with instant data availability

This endpoint requires a paid plan.

New API Parameters for Enhanced Control: We’ve added two powerful new parameters to give you more control over your API requests:

maxSpeed Parameter (Fetch Brand endpoint only):

• Optional boolean parameter that optimizes API calls for maximum speed
• When set to true, the API skips time-consuming operations for faster response
• Perfect for use cases where speed is prioritized over comprehensive data collection
• Trade-off: Faster response times at the cost of less detailed information

Click here to view the documentation.

timeoutMS Parameter (All endpoints):

• Optional timeout control in milliseconds for all API requests
• Set custom timeout values from 1ms up to 300,000ms (5 minutes maximum)
• Requests exceeding the specified timeout will be aborted with a 408 status code
• Ideal for applications with strict response time requirements or custom retry logic

Click here to view the documentation.

AI Query API released: Our AI Query API is now officially live! This powerful new endpoint allows you to intelligently extract and query specific information from any website without the technical complexity of web scraping.

Perfect for populating customer accounts with key business information such as:

• Use cases and service offerings
• Case studies and success stories
• Mission statements and company values
• Legal frameworks and compliance information
• Team information and company background
• Product details and specifications

We handle all the heavy lifting including JavaScript rendering, bot protection bypass, and complex scraping challenges. Simply provide a URL and your query - our API will intelligently extract the relevant information and return structured data you can immediately use to populate customer profiles, CRM systems, or any other application.

Key Benefits:

• No need to build complex scraping infrastructure
• Handles dynamic content and JavaScript-heavy sites
• Bypasses common bot detection systems
• Returns clean, structured data ready for integration
• Perfect for onboarding automation and data enrichment workflows

CHECK IT OUT HERE!

Note: This has also been released to all of our SDKs.

New & Improved API Call History: We’ve released an improved API call history widget to the dashboard with enhanced filtering options. You can now filter your API calls by time periods including this month, last 3 days, last 7 days, last 3 months, last 6 months, last year, or view all time data for comprehensive historical analysis.

Zapier integration is now live!

Note: This is an v0 launch, we only released the retrieve endpoint for now with the rest to follow soon.

• New Ruby SDK released: https://rubygems.org/gems/brand.dev
• Docs updated to show SDK usage. - We now return a third value for “mode” under images: has_opaque_background, this means the image has its own background and can be used in dark mode or light mode.

New python SDK released: https://pypi.org/project/brand.dev/

New typescript SDK released: https://www.npmjs.com/package/brand.dev

This is a complete re-write and now exposes the types for easy integration.

Database Migration: Transitioned to a more reliable database provider, resulting in a decrease of API call latency by approximately 50ms.