Skip to main content
POST
/
public
/
share-generation
curl -X POST "https://your-store.myshopify.com/apps/proxy_genlook-x/public/share-generation" \
  -H "Content-Type: application/json" \
  -d '{
    "generationId": "gen_xyz789abc",
    "effectiveDomain": "yourstore.com"
  }'

{
  "shareToken": "abc123xyz789",
  "shareUrl": "https://genlook.app/s/abc123xyz789",
  "expiresAt": "2024-02-15T10:30:00Z"
}
Create a publicly shareable link for a completed generation. Share links can be used on social media, messaging apps, or embedded in your store.
Rate limit: 20 share link creations per minute.

​
Request

​
generationId
string
required
The generation ID from a completed generation. Must be a valid generation that has status COMPLETED.
​
effectiveDomain
string
The actual domain where the customer was when sharing (e.g., yourstore.com). Used for proper link generation and attribution. If not provided, uses the Shopify store domain.
curl -X POST "https://your-store.myshopify.com/apps/proxy_genlook-x/public/share-generation" \
  -H "Content-Type: application/json" \
  -d '{
    "generationId": "gen_xyz789abc",
    "effectiveDomain": "yourstore.com"
  }'

​
Response

​
shareToken
string
required
Unique token for the share link. Used in the share URL path.
​
shareUrl
string
required
Complete shareable URL. This URL can be shared publicly and displays the try-on result.
​
expiresAt
string
required
ISO 8601 timestamp when the share link expires. After this date, the link will no longer be accessible.
{
  "shareToken": "abc123xyz789",
  "shareUrl": "https://genlook.app/s/abc123xyz789",
  "expiresAt": "2024-02-15T10:30:00Z"
}
Share links provide:
  • Public access: Anyone with the link can view the try-on result
  • Product information: Shows product details and links back to your store
  • Social sharing: Optimized for sharing on social media platforms
  • Analytics: View counts and engagement tracking
Cache the share URL in your application. If a share link already exists for a generation, you can reuse it instead of creating a new one.
Share links expire after a set period (typically 30 days). Check the expiresAt field and create a new link if needed.
Share links can be used in several ways:
  1. Web Share API: Use the browser’s native share dialog
  2. Copy to Clipboard: Copy the URL for manual sharing
  3. Social Media: Post directly to social platforms
  4. Email: Include in email campaigns
  5. Embedding: Embed in blog posts or product pages
Share links are hosted on genlook.app and include proper SEO metadata, Open Graph tags, and Twitter Card support for rich previews.

​
Error Responses

{
  "message": "Generation ID is required"
}

​
Retrieving Shared Generations

To retrieve a shared generation (public endpoint, no authentication required): 
GET https://genlook.app/s/{shareToken}
This returns the generation details including the image URL, product information, and merchant details.
The shared generation endpoint is public and doesn’t require authentication. It’s rate-limited to prevent abuse.