Skip to main content

​
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

MethodGET
URLhttps://www.promptwatch.com/api/brand-icons
AuthenticationNone
ResponseImage (favicon), suitable for use as an img src

​
Full URL shape

https://www.promptwatch.com/api/brand-icons?domain=<hostname>&sz=<size>

​
Query parameters

ParameterRequiredDescription
domainYesBrand hostname only (e.g. stripe.com). Do not include a scheme (https://), path, port, or query string.
szNoDesired 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):
ValueTypical use
16Dense lists, favicon-style chrome
32Compact rows, small avatars
64Standard thumbnails
128Larger cards
256Default; 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.