Docs
Website intelligence

Logos and backdrops

Work with validated, ranked brand assets served from Berrycrawl's CDN.

A full brand profile can include multiple logos and backdrops. Each selected asset is downloaded, decoded, validated, and mirrored to Berrycrawl's R2-backed CDN.

{
  "logos": [
    {
      "url": "https://cdn.berrycrawl.com/brand/logo/…",
      "type": "svg",
      "mode": "dark",
      "resolution": { "width": 512, "height": 512 },
      "colors": ["#d81b3c", "#ffffff"]
    }
  ],
  "backdrops": [
    {
      "url": "https://cdn.berrycrawl.com/brand/backdrop/…",
      "resolution": { "width": 2400, "height": 1260 },
      "colors": ["#090909", "#d81b3c"]
    }
  ]
}

Discovery and ranking

Logo candidates come from favicon links, Open Graph and Twitter metadata, JSON-LD, navigation markup, inline SVG, and preload hints. Ranking favors explicit logo evidence, transparent backgrounds, and compact dimensions.

Backdrop candidates come from Open Graph, Twitter cards, hero imagery, structured data, and preload metadata. Ranking favors wide, high-resolution images suitable for profile headers.

Invalid MIME types, oversized responses, private-network redirects, decode failures, and implausible dimensions are skipped individually. One bad candidate does not fail the profile.

URL guarantees

Use the returned cdn.berrycrawl.com URL directly. Berrycrawl does not return selected assets as third-party hotlinks. Asset keys are content-addressed, so identical bytes are deduplicated across repeated fetches.