API Reference
Request options
Control image size, format, fallbacks, and cache versions.
| Parameter | Values | Default | Description |
|---|---|---|---|
token | pk_... | Required | Publishable API key |
size | 1–2048 | 128 for icons, 1200 for OG | Output width in pixels |
format | png, webp, jpg | png | Output format |
fallback | monogram, 404 | monogram for icons, 404 for OG | Missing-image behavior |
retina | true | Off | Renders at twice the requested size |
v | String or number | None | Cache-busting version value |
Cache versions
Use v when you need a new cache identity for a domain after its source image changes:
https://logo.parsew.com/stripe.com?token=pk_...&v=2Only use a stable version value. Changing it on every request prevents effective edge caching.