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

# Brand icons

> Public favicon endpoint for brand hostnames separate from Promptwatch API v2

## Relationship to API v2

**Brand icons are not part of Promptwatch API v2** and do not appear in the v2 OpenAPI specification. That is intentional:

* They are served from the **public website** (`promptwatch.com`), not from `server.promptwatch.com` / `/api/v2`.
* **No API key** is required. They are meant for use in `<img>` tags, emails, and other read-only contexts where embedding an image URL is appropriate.
* They are **not versioned** with your integration contract for v2; the path and query contract described below is stable for practical use.

When you use **List brands** or other v2 **Brands** endpoints, responses may include a `domain` for each brand when the hostname is known. You can pass that hostname to the endpoint below to display a favicon.

***

## Endpoint

|                    |                                                     |
| ------------------ | --------------------------------------------------- |
| **Method**         | `GET`                                               |
| **URL**            | `https://www.promptwatch.com/api/brand-icons`       |
| **Authentication** | None                                                |
| **Response**       | Image (favicon), suitable for use as an `img` `src` |

### Full URL shape

```text theme={null}
https://www.promptwatch.com/api/brand-icons?domain=<hostname>&sz=<size>
```

***

## Query parameters

| Parameter | Required | Description                                                                                                                    |
| --------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `domain`  | **Yes**  | Brand **hostname only** (e.g. `stripe.com`). Do not include a scheme (`https://`), path, port, or query string.                |
| `sz`      | No       | Desired icon width/height in **pixels**. Allowed values: `16`, `32`, `64`, `128`, `256`. If omitted, the default is **`256`**. |

### `sz` values

Use one of the discrete sizes below (other values may be ignored or normalized by the server):

| Value | Typical use                       |
| ----- | --------------------------------- |
| `16`  | Dense lists, favicon-style chrome |
| `32`  | Compact rows, small avatars       |
| `64`  | Standard thumbnails               |
| `128` | Larger cards                      |
| `256` | Default; high-DPI or hero layouts |

***

## Examples

**Minimal (default size 256):**

```text theme={null}
https://www.promptwatch.com/api/brand-icons?domain=example.com
```

**Explicit size:**

```text theme={null}
https://www.promptwatch.com/api/brand-icons?domain=example.com&sz=64
```

**HTML:**

```html theme={null}
<img
  src="https://www.promptwatch.com/api/brand-icons?domain=example.com&sz=32"
  width="32"
  height="32"
  alt=""
/>
```

***

## Usage notes

* Prefer the **same hostname** you store or receive from product data (e.g. brand `domain` from the API), normalized to **host only**.
* This endpoint is **read-only** and **public**; do not send `X-API-Key` or other Promptwatch auth headers—they are not required and are unrelated to v2 quotas.
* For **Brand CRUD, relations, and analytics**, use **API v2** under the **Brands** and **Analytics** tags in the reference—not this URL.

For v2 authentication and base URLs, see [Getting started](/docs/getting-started).