Widget API Reference
Share Generation
Create a shareable link for a virtual try-on result
POST
Create a public share link for a completed generation. Links include Open Graph and Twitter Card metadata for rich social previews. Links expire after 30 days.
Request
string
required
A generation ID with status
COMPLETED.string
The customer-facing domain (e.g.
yourstore.com). Defaults to the Shopify store domain.string
Absolute product page URL captured from the storefront at share time (e.g.
https://yourstore.com/products/blue-shirt). Used by the public share page product CTA.Response
Unique token for the share link.
Complete shareable URL.
string
required
ISO 8601 expiration timestamp.
Get shared generation
GET /public/shared/:token (public, no auth) returns the try-on image and metadata for the share landing page at https://genlook.app/s/{token}.
string
required
The generation ID backing the share link.
string
required
URL of the try-on image shown on the share page.
string
required
The Shopify store domain that owns the generation.
ISO 8601 timestamp for when the share link was created.
string
required
ISO 8601 expiration timestamp. Share links expire after 30 days.
string
Product page URL for the share page “Shop this look” CTA. Prefer the URL sent at share creation; falls back to the persisted store product URL when absent.
string
External product GID (e.g.
gid://shopify/Product/123).string
Product title shown on the share page.
string
Customer-facing domain captured when the share link was created.

