The REST API lets you pull Idukki content into anything: a headless storefront, a server-rendered page, a custom surface. It is the backbone of the Custom integration and of any build where the drop-in script isn’t enough.
Make your first call
- Generate an API key. In Settings → Developers, create an API key for your workspace.
- Authenticate. Send your key as a bearer token on each request.
- Fetch a collection’s posts. Call the collection posts endpoint with your collection ID to get the curated, tagged posts.
- Render. Use the returned posts, products and tags to render your own markup, server-side if you want SEO content.
curl https://api.idukki.io/v1/collections/YOUR_ID/posts \
-H "Authorization: Bearer YOUR_API_KEY"If it doesn’t work
A 401 means the key is missing or wrong; confirm the bearer header. An empty response usually means the collection ID is wrong or the collection has no published posts.
