Skip to main content
GET
/
tryon
/
v1
/
products
/
{externalId}
/
stats
curl "https://api.genlook.app/tryon/v1/products/shirt-42/stats" \
  -H "x-api-key: gk_your_api_key"
{
  "totalGenerations": 187,
  "completedGenerations": 181,
  "failedGenerations": 4,
  "avgGenerationTimeMs": 9120
}

Documentation Index

Fetch the complete documentation index at: https://docs.genlook.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

Returns generation counts and average duration for a single product. Useful for dashboards that surface “this product was tried on N times this month” or for spotting failure spikes per SKU.

Path Parameters

externalId
string
required
Your product identifier. Works for both catalog products (created via POST /products) and inline-created products (including _anon_* IDs).

Query Parameters

from
string
ISO 8601 timestamp. Only count generations created at or after this time. Omit for lifetime stats.
to
string
ISO 8601 timestamp. Only count generations created at or before this time. Omit for lifetime stats.
curl "https://api.genlook.app/tryon/v1/products/shirt-42/stats" \
  -H "x-api-key: gk_your_api_key"

Response

totalGenerations
integer
required
Total generations against this product in the window.
completedGenerations
integer
required
Subset that reached COMPLETED.
failedGenerations
integer
required
Subset that ended in FAILED.
avgGenerationTimeMs
integer
required
Average end-to-end duration of completed generations, in milliseconds. 0 if there are no completed generations in the window.
{
  "totalGenerations": 187,
  "completedGenerations": 181,
  "failedGenerations": 4,
  "avgGenerationTimeMs": 9120
}

Notes

  • totalGenerations includes pending and processing generations as well as completed and failed ones, so the four numbers don’t always sum to the total.
  • Stats are eventually consistent — a generation that just finished may take a few seconds to appear.
  • For account-wide aggregates, sum the per-product stats yourself or use the Genlook dashboard.