Each gallery has a public JSON payload: the same one the widget script reads. Use it to render tiles in a headless storefront or a server-rendered page.
Make your first call
- Find your two ids. Open the gallery’s embed code. Copy the data-bguid and data-guid values.
- Fetch the gallery. Send a GET to the widget API with both ids. No key is needed: the payload is public.
- Render. Map the returned posts and tagged products to your own markup. Render on the server for SEO.
curl https://widget-api.idukki.io/widget/api/YOUR_BGUID/YOUR_COLLECTION_GUIDTo refresh a cache when content changes, subscribe to signed webhooks: see the webhooks guide. To read your own UGC, products and analytics with a key, see /mcp.
If it doesn’t work
A 404 or an empty list usually means one id is wrong. Copy both again from the embed code. Also check the collection has published posts.


