discovery

Resolve website icons (v2)

Resolve a website's icon as Point11's stored copy, with its tone and backplates: a website Point11 never checked is checked once while the call waits (the icons its homepage declares, read from its www. host when the bare host cannot serve it, then its /favicon.ico) and stored; when the site has none or the check has not finished (Point11 completes it shortly), faviconUrl is null and the answer carries the label its monogram draws. A website that fails URL-safety checks is refused; checking websites is rate-limited per credential.

get/api/v1/discovery/website-icons/resolve-v2

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/discovery/website-icons/resolve-v2
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Query parameters

urlstring uri required

The website's absolute URL, e.g. https://example.com.

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Response

Success.

faviconUrlstring nullable required
faviconFallbackLabelstring nullable required
faviconTone'dark' | 'light' | 'mixed' | 'unknown' required
faviconTransparentboolean nullable required
faviconNeedsLightBackplateboolean required
faviconNeedsDarkBackplateboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.