> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geekflare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Brand Guide

> Get structured brand information for any domain. Name, colors, fonts, logos, social profiles, links, and page metadata, with optional LLM-synthesized company intelligence.

The Brand endpoint returns structured brand and design information for a domain — identity, colors, fonts, links, social profiles, and page metadata by default, with an `enriched` mode that adds LLM-synthesized company intelligence. Results are cached and refreshed periodically, so most requests return quickly.

**Endpoint:** `POST https://api.geekflare.com/brand`

<Info>
  Install the official SDK: `npm install @geekflare/api-node` or `pip install
      geekflare-api`
</Info>

<Note>
  Coverage varies by site. Not every domain publishes every data point (logos, social profiles, company details, etc.), so fields may be omitted or null when unavailable.
</Note>

***

## Standard Mode

Get a domain's brand identity and design tokens. Costs **1 credit**.

<CodeGroup>
  ```typescript Node.js SDK theme={null}
  import { GeekflareClient } from '@geekflare/api-node';

  const client = new GeekflareClient({ apiKey: 'YOUR_API_KEY' });
  const result = await client.brand({ url: 'https://databox.com' });
  console.log(result);

  ```

  ```python Python SDK theme={null}
  from geekflare_api.client import GeekflareClient
  from geekflare_api.models import BrandDto

  with GeekflareClient(api_key='YOUR_API_KEY') as client:
      result = client.brand(BrandDto(url='https://databox.com'))
      print(result)
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.geekflare.com/brand \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://databox.com"}'
  ```
</CodeGroup>

<Accordion title="Response">
  ```json theme={null}
  {
    "timestamp": 1788792379327,
    "apiStatus": "success",
    "apiCode": 200,
    "meta": {
      "domain": "databox.com",
      "mode": "standard",
      "cached": false,
      "lastUpdated": "2026-09-07T14:46:19.108Z",
      "dataAge": "<1h",
      "refreshRequested": false,
      "test": { "id": "5f48cafe-e6fb-4c48-a498-2dcb4a960865" }
    },
    "data": {
      "name": "Databox",
      "domain": "databox.com",
      "description": "Get clear, trusted answers in seconds with AI-powered analytics software. Connect 130+ data sources, build beautiful dashboards, and automate reports.",
      "favicon": "https://cdn1.databox.com/favicons/favicon-32x32.png",
      "bannerUrl": "https://cdnwebsite.databox.com/wp-content/uploads/2026/09/07082959/databox-og-agentic-analytics-platform-2026.png",
      "isNsfw": false,
      "colorScheme": "light",
      "colors": {
        "primary": "#FFFFFF",
        "secondary": "#757677",
        "background": "#FFFFFF",
        "text": "#757677",
        "accent": "#E0E3EF",
        "link": "#4D71F1",
        "palette": [
          { "hex": "#FFFFFF", "usage": "primary" },
          { "hex": "#4D71F1", "usage": "primary" },
          { "hex": "#757677", "usage": "secondary" },
          { "hex": "#E0E3EF", "usage": "accent" }
        ]
      },
      "fonts": [
        { "usage": "body", "family": "Inter:400,700", "source": "google" },
        { "usage": "heading", "family": "Open Sans", "source": "google" }
      ],
      "links": {
        "blog": "https://databox.com/blog",
        "signup": "https://databox.com/signup",
        "careers": "https://databox.com/careers",
        "privacy": "https://databox.com/privacy-policy",
        "terms": "https://databox.com/terms-of-service"
      },
      "socialProfiles": [
        { "name": "linkedin", "url": "https://www.linkedin.com/company/2394209" },
        { "name": "youtube", "url": "https://www.youtube.com/@databoxHQ" },
        { "name": "instagram", "url": "https://www.instagram.com/databoxhq" },
        { "name": "twitter", "url": "https://x.com/databoxhq" },
        { "name": "facebook", "url": "https://www.facebook.com/databox/" }
      ],
      "pageMeta": {
        "title": "Business Intelligence & Analytics Software | Databox",
        "language": "en",
        "themeColor": "#ffffff",
        "canonicalUrl": "https://databox.com/"
      }
    }
  }
  ```
</Accordion>

***

## Enriched Mode

Set `mode: 'enriched'` to add LLM-synthesized company intelligence — industry, founding year, headcount and revenue ranges, target audience, brand voice, and use cases — on top of everything in standard mode. Costs **10 credits**.

<CodeGroup>
  ```typescript Node.js SDK theme={null}
  const result = await client.brand({
    url: 'https://databox.com',
    mode: 'enriched'
  });
  ```

  ```python Python SDK theme={null}
  result = client.brand(BrandDto(url='https://databox.com', mode='enriched'))
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.geekflare.com/brand \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://databox.com", "mode": "enriched"}'
  ```
</CodeGroup>

<Accordion title="Response — company field (in addition to everything in standard mode)">
  ```json theme={null}
  {
    "company": {
      "kind": "PRIVATELY_HELD",
      "summary": "Databox is a Business Intelligence (BI) software company founded in 2012 by Vlada Petrovic and Davorin Gabrovec. Headquartered in Boston, Massachusetts, it empowers teams to make data-driven decisions by consolidating data from multiple sources into customizable dashboards, reports, and AI-driven insights. The company has raised $3.84M in funding and operates as a private entity with a focus on modern BI solutions for businesses.",
      "industry": "Business/Productivity Software",
      "location": {
        "city": "Boston",
        "state": "Massachusetts",
        "country": "United States",
        "countryCode": "US"
      },
      "foundedYear": 2012,
      "employeesRange": "1-10",
      "revenueRange": "<$1M",
      "targetAudience": "Databox serves businesses of all sizes, particularly those needing real-time data consolidation, analytics, and performance tracking. Its solutions are tailored for teams requiring scalable, customizable, and AI-enhanced business intelligence tools.",
      "targetAudienceSegments": ["Startups", "SMBs", "Mid-Market", "Enterprise"],
      "brandVoice": ["data-driven", "collaborative", "innovative", "trustworthy", "efficient"],
      "useCases": [
        "Centralized business performance tracking across 120+ integrated tools",
        "Customizable dashboards and real-time reporting for data-driven decision-making",
        "Automated goal tracking and alerting for KPIs and metrics",
        "AI-powered analytics and insights for predictive business forecasting",
        "Scalable BI solutions for teams requiring unified data visualization and collaboration"
      ]
    }
  }
  ```
</Accordion>

<Info>
  `company.foundedYear`, `employeesRange`, `revenueRange`, `industry`, and
  `stockTicker` are `null` when that information isn't publicly available for
  the domain.
</Info>

***

## Caching and Force Refresh

Brand data is cached and refreshed periodically rather than scraped fresh on every request — `meta.cached`, `meta.lastUpdated`, and `meta.dataAge` tell you how fresh the returned data is. Set `refresh: true` to bypass the cache and force an on-demand fetch.

<CodeGroup>
  ```typescript Node.js SDK theme={null}
  const result = await client.brand({
    url: 'https://databox.com',
    refresh: true
  });
  ```

  ```python Python SDK theme={null}
  result = client.brand(BrandDto(url='https://databox.com', refresh=True))
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.geekflare.com/brand \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://databox.com", "refresh": true}'
  ```
</CodeGroup>

***

## All Parameters

| Parameter | Type                     | Default    | Description                                                                          |
| --------- | ------------------------ | ---------- | ------------------------------------------------------------------------------------ |
| `url`     | string                   | required   | Target domain or URL                                                                 |
| `mode`    | `standard` \| `enriched` | `standard` | Depth of brand data to return. `enriched` adds LLM-synthesized company intelligence. |
| `refresh` | boolean                  | `false`    | Force an on-demand fetch, bypassing any cached data                                  |

## Credits

| Mode     | Credits |
| -------- | ------- |
| Standard | 1       |
| Enriched | 10      |

<CardGroup cols={2}>
  <Card title="Node.js SDK" icon="npm" href="https://www.npmjs.com/package/@geekflare/api-node">
    `npm install @geekflare/api-node`
  </Card>

  <Card title="Python SDK" icon="python" href="https://pypi.org/project/geekflare-api/">
    `pip install geekflare-api`
  </Card>
</CardGroup>