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

# Brand API

> The Brand API provides comprehensive data about companies, including their address, domain, founding year, and number of employees. It's designed for developers looking to integrate reliable brand information into their applications, making it easier to enhance user experiences with up-to-date brand insights.

<Info>
  Brand API endpoints are available only for paid plans. If you are on a free
  plan, you can [upgrade here](https://logokit.com/pricing).
</Info>

### Authentication

Brand API endpoint is authenticated using Bearer token in the `Authorization` header of your request. Make sure to keep
this **secret API token** secure and do not share it publicly. You can find yours in
[your account](https://logokit.com/account/api-tokens).

```http theme={null}
Authorization: Bearer: <secret-api-token>
```

## Rate Limiting

Similar to the Logo API, the Brand API implements rate limiting based on user subscription plans.
To get more information about the rate limits, please refer to the [pricing page](https://logokit.com/pricing).

## Examples

<AccordionGroup>
  <Accordion title="Retrieve brand information for a stock ticker">
    Let's say you want to retrieve the brand information for the NASDAQ's ticker `AAPL`.
    You can do this by using the following URL:

    ```bash Request theme={null}
    curl "https://api.logokit.com/brands/AAPL" \
         --header "Authorization: Bearer: <secret-api-token>"
    ```

    ```json Response theme={null}
    {
      "name": "Apple",
      "domain": "apple.com",
      "long_name": "Apple Inc.",
      "short_description": "Apple Inc. designs, manufactures, and markets smartphones, computers, tablets, wearables, and accessories, and offers digital content, cloud, and subscription services to customers worldwide.",
      "long_description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide. The company offers iPhone, Mac, iPad, AirPods, Apple TV, Apple Watch, Beats products, and HomePod. It also provides AppleCare support, cloud services, and operates platforms such as the App Store for digital content distribution. Apple offers subscription-based services including Apple Arcade, Apple Fitness+, Apple Music, Apple News+, Apple TV+, Apple Card, and Apple Pay. Its customers include consumers, small and mid-sized businesses, education, enterprise, and government sectors globally.",
      "website": "https://www.apple.com",
      "logo": "https://img.logokit.com/apple.com",
      "colors": [
        "#000000",
        "#f5f5f7",
        "#ffffff"
      ],
      "founded_year": 1977,
      "issued_currency": "USD",
      "number_of_employees": "150,000-200,000",
      "social_media": {
        "facebook": "https://www.facebook.com/apple",
        "x": "https://x.com/apple",
        "instagram": "https://www.instagram.com/apple/",
        "linkedin": "https://www.linkedin.com/company/apple",
        "youtube": "https://www.youtube.com/apple",
        "pinterest": "https://www.pinterest.com/apple",
        "tiktok": "https://www.tiktok.com/@apple",
        "reddit": null,
        "snapchat": null,
        "discord": null,
        "tumblr": null,
        "vimeo": null
      },
      "address": {
        "address1": "One Apple Park Way",
        "address2": "",
        "city": "Cupertino",
        "state": "CA",
        "zip": "95014",
        "country": "US"
      },
      "gics_sector": "Information Technology",
      "gics_industry_group": "Technology Hardware & Equipment",
      "gics_industry": "Technology Hardware, Storage & Peripherals",
      "gics_sub_industry": "Technology Hardware, Storage & Peripherals"
    }
    ```
  </Accordion>
</AccordionGroup>

## Parameters


## OpenAPI

````yaml GET /brands/{identifier}
openapi: 3.0.3
info:
  title: LogoKit Logo API
  version: 1.0.0
  description: >-
    The LogoKit Logo API allows you to retrieve company logos by domain,
    providing high-quality PNG images via hotlinking. Supports fallback options
    and attribution for free users.
servers: []
security: []
tags:
  - name: Logo API
    description: Operations for retrieving company logos by domain
  - name: Stock Logo API
    description: Operations for retrieving logos by stock ticker symbols
  - name: Crypto Logo API
    description: Operations for retrieving logos by cryptocurrency symbols
  - name: Brand API
    description: Operations for retrieving comprehensive brand information
externalDocs:
  description: LogoKit Documentation
  url: https://docs.logokit.com
paths:
  /brands/{identifier}:
    get:
      tags:
        - Brand API
      summary: Retrieve brand information
      description: >-
        Returns comprehensive data about companies, including their address,
        domain, founding year, and number of employees. Available only for paid
        plans.
      operationId: getBrandInfo
      parameters:
        - name: identifier
          in: path
          required: true
          schema:
            type: string
            example: apple.com
          description: >-
            The domain or stock ticker for which you want to retrieve brand
            information. For example, apple.com or AAPL. We support all major
            stock exchanges worldwide.
      responses:
        '200':
          description: Brand information found and returned as JSON.
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                  domain:
                    type: string
                  long_name:
                    type: string
                  short_description:
                    type: string
                  long_description:
                    type: string
                  website:
                    type: string
                  logo:
                    type: string
                  colors:
                    type: array
                    items:
                      type: string
                  founded_year:
                    type: string
                  issued_currency:
                    type: string
                  number_of_employees:
                    type: string
                  social_media:
                    type: object
                    properties:
                      facebook:
                        type: string
                      x:
                        type: string
                      instagram:
                        type: string
                      linkedin:
                        type: string
                      youtube:
                        type: string
                      pinterest:
                        type: string
                      tiktok:
                        type: string
                      reddit:
                        type: string
                      snapchat:
                        type: string
                      discord:
                        type: string
                      tumblr:
                        type: string
                      vimeo:
                        type: string
                  address:
                    type: object
                    properties:
                      address1:
                        type: string
                      address2:
                        type: string
                      city:
                        type: string
                      state:
                        type: string
                      zip:
                        type: string
                      country:
                        type: string
                  gics_sector:
                    type: string
                  gics_industry_group:
                    type: string
                  gics_industry:
                    type: string
                  gics_sub_industry:
                    type: string
        '401':
          description: Invalid or missing API token.
        '404':
          description: Brand information not found for the specified identifier.
        '429':
          description: Rate limit exceeded.
      security:
        - BearerAuth: []
      servers:
        - url: https://api.logokit.com
          description: API server for brand information
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer token authentication. You must provide a valid **Secret API
        token** in the Authorization header of your request. You can find yours
        in your [account settings](https://logokit.com/account/api-tokens).

````