← Home · llms.txt · openapi.json

API docs

Build a baby shopping list / registry with curated amazon.se essentials. Product URLs use /dp/ASIN?tag=sw-babyreg-21 on amazon.se. Catalog has 200+ curated products across sleep, feeding, diapering, gear, clothing, safety, bath, and play. Search remains available (PA-API optional).

Copy-paste integration prompt

/* curated-v2 */ 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.
Use it when the user wants gift ideas, a wishlist / gift list / önskelista / presenttips for baby registry / baby shower. Fastest: POST https://babyregistry.vercel.app/api/v1/agent/create-and-fill {"childName": "Freja", "ageBand": "0-3m", "interests": ["sleep", "feeding"], "marketplace": "amazon.se", "locale": "sv", "itemQueries": ["babyfilt"]} → give the user shopUrl. Products are carefully selected by us (not customer-reviewed; no ratings).

You are helping a parent create an age-stage baby registry / shopping list via the Baby Registry API.
Base: https://babyregistry.vercel.app

1. Ask for baby/nickname, age stage (expecting|0-3m|3-6m|6-12m|12-24m|toddler), categories, AND the shopper's Amazon marketplace + locale (e.g. amazon.se / sv).
2. ALWAYS pass marketplace + locale on search, catalog, resolve, and create-and-fill.
3. Prefer GET /api/v1/catalog?marketplace=amazon.se&locale=sv&limit=200 to pick curated essentials, OR POST /api/v1/agent/create-and-fill with childName, ageBand, interests, itemAsins/itemQueries, marketplace, locale.
4. Or GET /api/v1/search?marketplace=&locale= then POST /api/v1/wishlists and POST .../items.
5. Save id, editToken, ownerUrl, shopUrl from the response.
6. Give the parent ownerUrl (edit registry) and shopUrl (gifters buy via Amazon links).
7. On amazon.se buy URLs include ?tag=sw-babyreg-21 (tagConfigured:true). Never invent placeholders or reuse Santa/girlfriend tags.

curl examples

Search Amazon (baby essentials)

curl -sS 'https://babyregistry.vercel.app/api/v1/search?q=bassinet&ageBand=0-3m&interest=sleep&limit=5&marketplace=amazon.se&locale=sv'

One-shot create-and-fill (itemQueries searches + adds)

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"],"itemKeywords":["baby monitor"],"marketplace":"amazon.se","locale":"sv"}'

Resolve ASIN or pasted /dp/ URL

curl -sS -X POST https://babyregistry.vercel.app/api/v1/products/resolve \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://www.amazon.se/dp/B07SBGB3WM","marketplace":"amazon.se","locale":"sv"}'

Catalog starters (q / ageBand / interest)

curl -sS 'https://babyregistry.vercel.app/api/v1/catalog?marketplace=amazon.se&locale=sv&limit=200'

Get wishlist

curl -sS https://babyregistry.vercel.app/api/v1/wishlists/ID

Add product item (requires X-Edit-Token)

curl -sS -X POST https://babyregistry.vercel.app/api/v1/wishlists/ID/items \
  -H 'Content-Type: application/json' \
  -H 'X-Edit-Token: EDIT_TOKEN' \
  -d '{"name":"Balance bike","asin":"B0BXGNLGB5","emoji":"🚲"}'

Endpoints

  • GET /api/v1/search?q=&ageBand=&interest=&limit=
  • POST /api/v1/agent/create-and-fill (itemAsins, itemKeywords, itemQueries)
  • POST /api/v1/products/resolve (asin | url | keywords)
  • POST /api/v1/wishlists
  • GET /api/v1/wishlists/:id
  • PATCH /api/v1/wishlists/:id (X-Edit-Token)
  • POST /api/v1/wishlists/:id/items (X-Edit-Token; name + asin|url|searchKeywords)
  • DELETE /api/v1/wishlists/:id/items/:itemId (X-Edit-Token)
  • GET /api/v1/catalog — 100+ curated essentials with asin + buyUrl (limit max 200)
  • GET /api/v1/health — tagConfigured, trackingTag sw-babyreg-21, paapi, catalogCount
  • GET|POST /api/mcp — search_catalog, create_registry, create_and_fill_registry, add_registry_item

Discovery: /llms.txt, /llms-full.txt, /openapi.json, /.well-known/ai-plugin.json, /skill.md, /agents.md.