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

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):

https://www.promptwatch.com/api/brand-icons?domain=example.com

Explicit size:

https://www.promptwatch.com/api/brand-icons?domain=example.com&sz=64

HTML:

<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.