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

# Brand by slug

> Returns the profile for a brand or product by its slug as JSON

Send the key as `Authorization: Bearer lo_…`. The response has the same shape as [Brand by domain](https://docs.logoo.useora.co/api-reference/brand-by-domain.md), for brands and products that have a slug instead of a domain.


## OpenAPI

````yaml GET /brand/by/{slug}
openapi: 3.1.0
info:
  title: Logoo API Reference (by Ora)
  description: Logoo API Reference Documentation
  version: 1.0.0
servers:
  - description: Production
    url: https://api.logoo.useora.co
  - description: Local development
    url: http://localhost:8787
security: []
tags:
  - description: Health checks and system status
    name: System
  - description: Serve brand logos by domain or name
    name: Logos
  - description: Search and discover brands
    name: Search
  - description: Company metadata and enrichment
    name: Brand Info
  - description: Authenticated user self-service (profile, subscription, usage)
    name: Me
  - description: Brand asset management (requires API key)
    name: Admin
  - description: Checkout, portal, and webhook endpoints
    name: Billing
paths:
  /brand/by/{slug}:
    get:
      tags:
        - Brand Info
      summary: Get brand information
      description: >-
        Get enriched company information for a domain or slug, including name,
        description, social media links, colors, industry classification, and
        address. Supports domain aliases (e.g. icloud.com resolves to apple.com)
        and product hierarchy (Microsoft Word inherits firmographic fields from
        Microsoft).
      operationId: getBrandByBySlug
      parameters:
        - in: path
          name: slug
          schema:
            type: string
            pattern: ^[a-z0-9]([a-z0-9.-]{0,62}[a-z0-9])?$
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  address:
                    anyOf:
                      - type: object
                        properties:
                          address1:
                            type: string
                          address2:
                            type: string
                          city:
                            type: string
                          country:
                            type: string
                          state:
                            type: string
                          zip:
                            type: string
                        required:
                          - address1
                          - address2
                          - city
                          - country
                          - state
                          - zip
                        additionalProperties: false
                      - type: 'null'
                  brand_guide_url:
                    anyOf:
                      - type: string
                      - type: 'null'
                  brand_url:
                    anyOf:
                      - type: string
                      - type: 'null'
                  colors:
                    anyOf:
                      - type: array
                        items:
                          type: string
                      - type: 'null'
                  domain:
                    type: string
                  founded_year:
                    anyOf:
                      - type: number
                      - type: 'null'
                  gics_industry:
                    anyOf:
                      - type: string
                      - type: 'null'
                  gics_industry_group:
                    anyOf:
                      - type: string
                      - type: 'null'
                  gics_sector:
                    anyOf:
                      - type: string
                      - type: 'null'
                  gics_sub_industry:
                    anyOf:
                      - type: string
                      - type: 'null'
                  logo:
                    type: string
                  long_description:
                    anyOf:
                      - type: string
                      - type: 'null'
                  long_name:
                    anyOf:
                      - type: string
                      - type: 'null'
                  name:
                    anyOf:
                      - type: string
                      - type: 'null'
                  number_of_employees:
                    anyOf:
                      - type: string
                      - type: 'null'
                  press_contact:
                    anyOf:
                      - type: string
                      - type: 'null'
                  short_description:
                    anyOf:
                      - type: string
                      - type: 'null'
                  social_media:
                    anyOf:
                      - type: object
                        propertyNames:
                          type: string
                        additionalProperties:
                          anyOf:
                            - type: string
                            - type: 'null'
                      - type: 'null'
                  website:
                    anyOf:
                      - type: string
                      - type: 'null'
                required:
                  - address
                  - brand_guide_url
                  - brand_url
                  - colors
                  - domain
                  - founded_year
                  - gics_industry
                  - gics_industry_group
                  - gics_sector
                  - gics_sub_industry
                  - logo
                  - long_description
                  - long_name
                  - name
                  - number_of_employees
                  - press_contact
                  - short_description
                  - social_media
                  - website
                additionalProperties: false
          description: Brand information
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          required:
                            - message
                          additionalProperties: false
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          required:
                            - message
                          additionalProperties: false
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
          description: Unauthorized — missing or invalid API key
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          required:
                            - message
                          additionalProperties: false
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
          description: Resource not found
        '429':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          required:
                            - message
                          additionalProperties: false
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
          description: Too Many Requests — rate limit exceeded
      security:
        - httpBearer: []
        - {}
components:
  securitySchemes:
    httpBearer:
      bearerFormat: la_*
      description: API key (la_...) passed as Bearer token
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.