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

# List Global Brands

> Search Peec's global brand catalog — the shared registry of real-world brands that products attach to via `global_brand_id`. Use it to find the `global_brand_id` for a brand when creating products. This is separate from `GET /brands`, which lists the brands a project tracks for AI-visibility reporting; the two use different ids. Primarily used with `search`. Pass `ownership` (`own`, `competitor`, or `all`) instead to list the project's shopping brands ranked by mentions, for use as shopping brand filters.



## OpenAPI

````yaml https://api.peec.ai/customer/v1/openapi/json get /global-brands
openapi: 3.0.3
info:
  title: Peec AI Customer API
  description: Development documentation
  version: 1.0.0
  contact:
    name: Peec AI Team
    email: support@peec.ai
servers:
  - url: https://api.peec.ai/customer/v1
security: []
paths:
  /global-brands:
    get:
      tags:
        - Products
      summary: List Global Brands
      description: >-
        Search Peec's global brand catalog — the shared registry of real-world
        brands that products attach to via `global_brand_id`. Use it to find the
        `global_brand_id` for a brand when creating products. This is separate
        from `GET /brands`, which lists the brands a project tracks for
        AI-visibility reporting; the two use different ids. Primarily used with
        `search`. Pass `ownership` (`own`, `competitor`, or `all`) instead to
        list the project's shopping brands ranked by mentions, for use as
        shopping brand filters.
      operationId: getGlobal-brands
      parameters:
        - name: project_id
          in: query
          required: false
          schema:
            description: Required if using a company api key
            example: or_f45b94ba-5e35-4982-93ed-285e72ee14eb
            type: string
        - name: search
          in: query
          required: false
          schema:
            example: nike
            description: >-
              Search the catalog by brand name (matches names and aliases). The
              primary way to use this endpoint.
            type: string
        - name: ownership
          in: query
          required: false
          schema:
            description: >-
              List the project's shopping brands instead of searching the
              catalog, ranked by all-time shopping mention count: `own` for the
              project's own brands, `competitor` for competitors appearing in
              shopping data, `all` for both.
            type: string
            enum:
              - own
              - competitor
              - all
        - name: limit
          in: query
          required: false
          schema:
            default: 1000
            type: number
            minimum: 1
            maximum: 10000
        - name: offset
          in: query
          required: false
          schema:
            default: 0
            type: number
            minimum: 0
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                          example: 019ecb6e-d030-7222-b531-b371fe9db583
                          description: >-
                            The global_brand_id — pass this as a product's brand
                            when creating products, and as a shopping brand
                            filter.
                        name:
                          type: string
                          example: Nike
                        domain:
                          nullable: true
                          example: nike.com
                          type: string
                        description:
                          nullable: true
                          example: American athletic footwear and apparel company
                          description: >-
                            Short description that disambiguates same-named
                            brands.
                          type: string
                        mention_count:
                          description: >-
                            All-time shopping mention count in this project.
                            Present only when `ownership` is set.
                          type: number
                        is_own:
                          description: >-
                            Whether this is one of the project's own brands.
                            Present only when `ownership` is set.
                          type: boolean
                      required:
                        - id
                        - name
                        - domain
                        - description
                  total_count:
                    type: number
                    example: 42
                    description: Total number of matching brands, ignoring pagination
                  totalCount:
                    type: number
                    example: 42
                    description: Total number of matching brands, ignoring pagination
                    deprecated: true
                required:
                  - data
                  - total_count
                  - totalCount
                description: Success
      security:
        - APIKeyHeader: []
        - APIKeyQuery: []
        - BearerAuth: []
components:
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    APIKeyQuery:
      type: apiKey
      in: query
      name: api_key
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````