---
title: "List Global Brands"
method: GET
path: "/global-brands"
tags: ["Products"]
---

# List Global Brands

`GET /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.

## Query parameters

- `project_id` string — Required if using a company api key
- `search` string — Search the catalog by brand name (matches names and aliases). The primary way to use this endpoint.
- `ownership` 'own' | 'competitor' | 'all' — 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.
- `limit` number
- `offset` number

## Response `200`

Success

- object — Success
  - `data` object[], required
    - `id` string, uuid, required — The global_brand_id — pass this as a product's brand when creating products, and as a shopping brand filter.
    - `name` string, required
    - `domain` string, nullable, required
    - `description` string, nullable, required — Short description that disambiguates same-named brands.
    - `mention_count` number — All-time shopping mention count in this project. Present only when `ownership` is set.
    - `is_own` boolean — Whether this is one of the project's own brands. Present only when `ownership` is set.
  - `total_count` number, required — Total number of matching brands, ignoring pagination
  - `totalCount` number, required — Total number of matching brands, ignoring pagination

---

[API](https://skmtc.net/peec/apis/peec-ai-customer-api.md) · [All operations](https://skmtc.net/peec/apis/peec-ai-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peec/peec-ai-customer-api/revisions/92840a1bffa7/schema)