Skip to content
NewProduct Q&A: shoppers ask on your product page and get your answers.See how it works
IdukkiIdukki
Developers + API

REST API quickstart

Read a gallery’s public JSON payload and render it yourself. The starting point for headless and custom builds.

5 min read · last updated 2026-10
On this page

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

  1. Find your two ids. Open the gallery’s embed code. Copy the data-bguid and data-guid values.
  2. Fetch the gallery. Send a GET to the widget API with both ids. No key is needed: the payload is public.
  3. 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_GUID

To 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.

Was this page helpful?

Still stuck?

Email us at support@idukki.io or open the in-app chat. We answer within one working day.

Talk to a human

Related guides

Live in minutesDTC + B2B brands79 KB runtimeReal G2 reviews

Stuck?

A real human is faster than a search box.

In-app chat is staffed during EU + US business hours. Status of a ticket? Email support@idukki.io and we’ll surface it.

  • No credit card
  • Cancel anytime
  • GDPR self-certified · SOC 2 (in audit)