> ## 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

> Retrieve structured brand information for a website domain, including key brand details useful for identifying and understanding a website or company.



## OpenAPI

````yaml POST /brand
openapi: 3.1.0
info:
  title: Geekflare
  description: Official OpenAPI specification for all Geekflare endpoints.
  version: 1.0.0
  license:
    name: MIT
servers:
  - url: https://api.geekflare.com
security:
  - x-api-key: []
paths:
  /brand:
    post:
      tags:
        - api-tool
      summary: Get brand data for a domain
      description: >-
        Retrieve structured brand information for a website domain, including
        key brand details useful for identifying and understanding a website or
        company.
      operationId: brand
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BrandDto'
      responses:
        '200':
          description: Successfully retrieved brand data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandResponseDto'
        '400':
          description: Invalid URL.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BaseErrorResponseDto'
              example:
                timestamp: 1700000000000
                apiStatus: failure
                apiCode: 400
                message: INVALID_URL
                details: The URL must be a valid HTTP or HTTPS URL.
components:
  schemas:
    BrandDto:
      type: object
      properties:
        url:
          type: string
          description: Target URL
          example: https://example.com
        refresh:
          type: boolean
          description: >-
            Force on-demand fetch and refresh the cache, bypassing any existing
            cached data
          example: false
          default: false
        mode:
          type: string
          description: >-
            Depth of brand data to return. Enriched includes LLM-synthesized
            company intelligence.
          example: standard
          enum:
            - standard
            - enriched
          default: standard
      required:
        - url
    BrandResponseDto:
      type: object
      properties:
        timestamp:
          type: number
          description: Timestamp of the request in milliseconds
          example: 1788414740025
        apiStatus:
          type: string
          description: API status message
          example: success
          enum:
            - success
            - failure
        apiCode:
          type: number
          description: API status code
          example: 200
        meta:
          description: Metadata about the request
          allOf:
            - $ref: '#/components/schemas/BrandMetaDto'
        data:
          description: Brand data payload
          allOf:
            - $ref: '#/components/schemas/BrandDataDto'
      required:
        - timestamp
        - apiStatus
        - apiCode
        - meta
        - data
    BaseErrorResponseDto:
      type: object
      properties:
        timestamp:
          type: number
          description: Timestamp of the request in milliseconds
          example: 1778737930991
        apiStatus:
          type: string
          description: API status message
          example: success
          enum:
            - success
            - failure
        apiCode:
          type: number
          description: API status code
          example: 200
        message:
          type: string
          description: Error message
          example: Invalid URL provided
        details:
          type: string
          description: Detailed error information
          example: The URL must be a valid HTTP or HTTPS URL
      required:
        - timestamp
        - apiStatus
        - apiCode
        - message
    BrandMetaDto:
      type: object
      properties:
        domain:
          type: string
          description: The domain that was queried
          example: stripe.com
        mode:
          type: string
          description: Mode requested
          example: standard
          enum:
            - standard
            - enriched
        cached:
          type: boolean
          description: Whether this response was served from cache
          example: true
        lastUpdated:
          type: string
          description: When the underlying data was last fetched/updated
          example: '2026-06-15T08:32:00Z'
        dataAge:
          type: string
          description: Human-readable age of the cached data
          example: 5d
        refreshRequested:
          type: boolean
          description: Whether a forced refresh was requested
          example: false
        test:
          description: Test details object
          allOf:
            - $ref: '#/components/schemas/TestMetaDto'
      required:
        - domain
        - mode
        - cached
        - lastUpdated
        - dataAge
        - refreshRequested
        - test
    BrandDataDto:
      type: object
      properties:
        domain:
          type: string
          example: stripe.com
        name:
          type: string
        tagline:
          type: string
        description:
          type: string
        slogan:
          type: string
        isNsfw:
          type: boolean
          default: false
        favicon:
          type: string
        bannerUrl:
          type: string
        logos:
          type: array
          items:
            $ref: '#/components/schemas/BrandLogoDto'
        colors:
          $ref: '#/components/schemas/BrandColorsDto'
        colorScheme:
          type: string
          enum:
            - light
            - dark
        fonts:
          type: array
          items:
            $ref: '#/components/schemas/BrandFontDto'
        fontSizes:
          $ref: '#/components/schemas/BrandTypographyDto'
        components:
          $ref: '#/components/schemas/BrandComponentsDto'
        spacing:
          $ref: '#/components/schemas/BrandSpacingDto'
        socialProfiles:
          type: array
          items:
            $ref: '#/components/schemas/BrandSocialProfileDto'
        links:
          $ref: '#/components/schemas/BrandLinksDto'
        company:
          $ref: '#/components/schemas/BrandCompanyDto'
        pageMeta:
          $ref: '#/components/schemas/BrandPageMetaDto'
      required:
        - domain
    TestMetaDto:
      type: object
      properties:
        id:
          type: string
          description: Unique test identifier
          example: mxqx9v9y0742lap6altwdteqd28t23nq
      required:
        - id
    BrandLogoDto:
      type: object
      properties:
        type:
          type: string
          enum:
            - logo
            - symbol
            - icon
        theme:
          type: string
          enum:
            - light
            - dark
          nullable: true
        url:
          type: string
        format:
          type: string
          example: svg
      required:
        - type
        - url
        - format
    BrandColorsDto:
      type: object
      properties:
        primary:
          type: string
        secondary:
          type: string
        background:
          type: string
        text:
          type: string
        accent:
          type: string
        link:
          type: string
        palette:
          type: array
          items:
            $ref: '#/components/schemas/BrandColorEntryDto'
      required:
        - palette
    BrandFontDto:
      type: object
      properties:
        family:
          type: string
        usage:
          type: string
          example: heading
        source:
          type: string
          enum:
            - custom
            - google
            - system
      required:
        - family
        - usage
        - source
    BrandTypographyDto:
      type: object
      properties:
        h1:
          type: string
        h2:
          type: string
        body:
          type: string
    BrandComponentsDto:
      type: object
      properties:
        buttonPrimary:
          $ref: '#/components/schemas/BrandButtonStyleDto'
        buttonSecondary:
          $ref: '#/components/schemas/BrandButtonStyleDto'
        input:
          $ref: '#/components/schemas/BrandButtonStyleDto'
    BrandSpacingDto:
      type: object
      properties:
        baseUnit:
          type: number
          description: >-
            Heuristic: mode of observed small padding/margin values, not a
            guaranteed design token
        borderRadius:
          type: string
    BrandSocialProfileDto:
      type: object
      properties:
        name:
          type: string
          example: twitter
        url:
          type: string
      required:
        - name
        - url
    BrandLinksDto:
      type: object
      properties:
        blog:
          type: string
        login:
          type: string
        signup:
          type: string
        careers:
          type: string
        contact:
          type: string
        privacy:
          type: string
        terms:
          type: string
        pricing:
          type: string
    BrandCompanyDto:
      type: object
      properties:
        foundedYear:
          type: object
          nullable: true
        employeesRange:
          type: object
          nullable: true
        revenueRange:
          type: object
          nullable: true
        kind:
          type: string
          enum:
            - PRIVATELY_HELD
            - PUBLICLY_TRADED
            - NON_PROFIT
            - GOVERNMENT
          nullable: true
        industry:
          type: object
          nullable: true
        location:
          $ref: '#/components/schemas/BrandLocationDto'
        stockTicker:
          type: object
          nullable: true
        summary:
          type: string
        targetAudience:
          type: string
        targetAudienceSegments:
          type: array
          items:
            type: string
            enum:
              - Freelancers
              - Startups
              - SMBs
              - Mid-Market
              - Enterprise
              - Consumers (B2C)
        brandVoice:
          type: array
          items:
            type: string
        useCases:
          type: array
          items:
            type: string
    BrandPageMetaDto:
      type: object
      properties:
        title:
          type: string
        themeColor:
          type: string
        canonicalUrl:
          type: string
        language:
          type: string
    BrandColorEntryDto:
      type: object
      properties:
        hex:
          type: string
          example: '#635BFF'
        usage:
          type: string
          example: primary
      required:
        - hex
        - usage
    BrandButtonStyleDto:
      type: object
      properties:
        background:
          type: string
        textColor:
          type: string
        borderColor:
          type: string
        borderRadius:
          type: string
        shadow:
          type: string
    BrandLocationDto:
      type: object
      properties:
        city:
          type: object
          nullable: true
        state:
          type: object
          nullable: true
        country:
          type: object
          nullable: true
        countryCode:
          type: object
          nullable: true
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: API Key required for all endpoints

````