Skip to main content

Embed a product page

GET 
/products/embed

Returns an HTML page presenting product information, suitable for embedding in a webpage or app via an iframe.

Authentication: This endpoint supports two authentication methods:

  1. HTTP Basic auth — pass the Authorization header as with other endpoints.
  2. Signed URL (MAC) — useful when embedding in a frontend where HTTP headers cannot be set. Pass key, t, and mac query parameters instead of the Authorization header.

Tip: The /products/find and /products/query responses include a pre-signed embed URL in meta.embedUrl. This is the easiest way to get a working embed URL.

Generating a signed URL manually:

$message = "embed:" . $productId . ":" . $unixTimestamp;
$mac = hash_hmac("sha256", $message, $apiSecretKey);

Then append ?id={productId}&t={timestamp}&key={apiKeyId}&mac={mac} to the endpoint URL.

Request​

Responses​

An HTML page presenting the product information.