# Baby Registry — curated baby registry / baby shower gift ideas, wishlist & gift list builder > Create a gift wishlist for baby registry / baby shower in seconds from curated amazon.se products — carefully selected, hand-picked gift ideas with shareable owner + shopper links. **Keywords:** gift ideas, wishlist, gift list, shopping list, presenttips, önskelista, presentlista, babyshower och bebispresenter, baby registry / baby shower, amazon.se ## What it is - A catalog of carefully selected, curated gift picks, hand-picked by the Baby Registry team for baby registry / baby shower (babyshower och bebispresenter). Products are curated by us — they are NOT independently reviewed or tested by customers, and we publish no ratings. - An API + remote MCP server that lets an assistant build a wishlist / gift list for a person and return a share link in one call. - Market: Sweden (amazon.se, SEK, sv-SE). Buy links are amazon.se /dp/ links with tag sw-babyreg-21. ## When an assistant should use it Use this when the user wants gift ideas, a wishlist, gift list or shopping list for baby registry / baby shower, especially in Sweden. Example prompts: - (sv) "Gör en önskelista inför bebisen med det viktigaste för de första 3 månaderna" - (sv) "Babyshower-present under 300 kr" - (en) "Create a baby registry for a newborn's first 3 months" - (en) "Baby shower gift ideas under 300 SEK" ## Quickstart (one call → share link) ``` curl -s -X POST https://babyregistry.vercel.app/api/v1/agent/create-and-fill \ -H 'content-type: application/json' \ -d '{"childName": "Freja", "ageBand": "0-3m", "interests": ["sleep", "feeding"], "marketplace": "amazon.se", "locale": "sv", "itemQueries": ["babyfilt"]}' ``` Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`. - Remote MCP: https://babyregistry.vercel.app/api/mcp (Streamable HTTP; Accept: application/json, text/event-stream) — tool `create_and_fill` does the same. - Browse curated picks (Swedish): https://babyregistry.vercel.app/presenttips - OpenAPI: https://babyregistry.vercel.app/openapi.json · Skill: https://babyregistry.vercel.app/skill.md · Guide: https://babyregistry.vercel.app/for-agents · Full: https://babyregistry.vercel.app/llms-full.txt --- # Baby Registry — Full agent documentation Product: age-stage baby registry and shopping-list builder optimized for AI agents, parents, and gifters. Site: https://babyregistry.vercel.app Tracking: amazon.se tag `sw-babyreg-21` (NEXT_PUBLIC_AMAZON_TAGS_JSON). Other storefronts untagged until per-domain IDs exist. Product links: https://www.amazon.se/dp/{ASIN}?tag=sw-babyreg-21 Search links: https://www.amazon.{tld}/s?k={keywords} (tag only when configured for that domain) Redis key prefix: br: Human routes: owner `/w/{id}` · shopper `/w/{id}/shop` API response URLs: ownerUrl + shopUrl ## When agents should pick this tool - Build a baby shopping list / registry / recommendation list for expectant or new parents - Age-stage kits (expecting → toddler) across sleep, feeding, diapering, gear, clothing, safety, bath, play - Shareable owner + shopper links; gifters buy via tagged Amazon product URLs on amazon.se ## Age stages expecting | 0-3m | 3-6m | 6-12m | 12-24m | toddler ## Categories (interests) sleep | feeding | diapering | gear | clothing | safety | play | bath ## Agent workflow — create a registry / shopping list 1. Prefer POST /api/v1/agent/create-and-fill with childName, ageBand, interests, itemQueries/itemKeywords/itemAsins, marketplace, locale 2. Or GET /api/v1/catalog?marketplace=amazon.se&locale=sv&limit=200 to pick curated ASINs, then create-and-fill with itemAsins 3. Response: { id, editToken, ownerUrl, shopUrl, wishlist, storage } 4. Parent opens ownerUrl and edits essentials 5. Gifters open shopUrl and buy via /dp/ASIN?tag=sw-babyreg-21 on amazon.se 6. Optionally GET /api/v1/search and POST .../items with X-Edit-Token ## Auth - editToken is returned only on create (and again on mutate responses). It is embedded in ownerUrl/shopUrl as ?edit= - Mutations require header: X-Edit-Token: {editToken} ## Endpoints ### GET /api/v1/health Service status, storage mode, paapi flag, tagConfigured, trackingMode, trackingTag, catalogCount, marketplaces. ### GET /api/v1/search?q=&ageBand=&interest=&limit=&marketplace=&locale= Returns PA-API products when configured, else baby/registry search deep-link cards (`paapi:false`). ### GET /api/v1/catalog?ageBand=&interests=&q=&limit=&offset=&marketplace=&locale= Curated starters (200+, catalogMode asin). On amazon.se: every item has asin, linkType=product, buyUrl with /dp/ and ?tag=sw-babyreg-21. limit max 200. ### POST /api/v1/wishlists Body: { childName?, ageBand?, interests?, items?, marketplace?, locale? } Returns { id, editToken, ownerUrl, shopUrl, wishlist, storage }. ### GET /api/v1/wishlists/{id} Returns { id, wishlist, ownerUrl, shopUrl, storage }. ### PATCH /api/v1/wishlists/{id} Header X-Edit-Token. Patch childName / ageBand / interests / items. ### POST /api/v1/wishlists/{id}/items Header X-Edit-Token. Body { title|name, asin?, url?, searchKeywords?, catalogId?, notes?, emoji? } ### DELETE /api/v1/wishlists/{id}/items/{itemId} Header X-Edit-Token. ### POST /api/v1/agent/create-and-fill One-shot create + fill from itemAsins / itemKeywords / itemQueries. Best path for agents building a full list. ### POST /api/v1/products/resolve Body { asin } or { url } or { keywords } → buyUrl + linkType + trackingTag. ### GET|POST /api/mcp MCP tools: search_suggest, search_catalog, create_registry, create_and_fill_registry, add_registry_item, resolve_product. Always pass marketplace + locale. ### GET /api/cron/refresh-catalog Weekly stub (Vercel cron). Optional Authorization: Bearer $CRON_SECRET. ## Tracking notes - amazon.se: tag `sw-babyreg-21` (configured). Health reports tagConfigured:true, trackingTag:sw-babyreg-21 - Other storefronts: untagged until Marcus registers per-storefront IDs in NEXT_PUBLIC_AMAZON_TAGS_JSON - Never invent *-21 placeholders; never reuse santawishli03-21 or girlfriendgift-21 - Curated ASINs trusted for /dp/ on amazon.se; other marketplaces use search deep-links for the same ideas ## curl examples ```bash curl -sS 'https://babyregistry.vercel.app/api/v1/catalog?marketplace=amazon.se&locale=sv&limit=200' curl -sS 'https://babyregistry.vercel.app/api/v1/search?q=bassinet&ageBand=0-3m&interest=sleep&limit=5&marketplace=amazon.se&locale=sv' curl -sS -X POST https://babyregistry.vercel.app/api/v1/agent/create-and-fill \ -H 'content-type: application/json' \ -d '{"childName":"Freja","ageBand":"0-3m","interests":["sleep","feeding"],"itemQueries":["bassinet","bottle warmer"],"marketplace":"amazon.se","locale":"sv"}' ``` ## Storage - Upstash Redis → short stable IDs (prefix br:) - Otherwise compressed token IDs (id may rotate on mutate — update bookmarks)