← Home · llms.txt · openapi.json
Wedding gift boards, shopping lists, and recommendation lists. coupleUrl = couple publishes; guestUrl = guests shop. Catalog = curated starters; search is primary.
/* curated-v2 */ Create a gift wishlist for wedding in seconds from curated amazon.se (Sweden) and amazon.com (United States) 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 wedding. Fastest: POST https://wedding-gift-board.vercel.app/api/v1/agent/create-and-fill {"coupleNames": "Alex & Sam", "budgetBand": "300-700", "styleTags": ["home"], "marketplace": "amazon.se", "locale": "sv", "itemQueries": ["gjutjärnsgryta"]} → give the user shopUrl. Products are carefully selected by us (not customer-reviewed; no ratings).
You are helping with a wedding gift board via the Wedding Gift Board API.
Base URL: https://wedding-gift-board.vercel.app
CRITICAL: always pass marketplace + locale (calling agent picks for the user). ASINs do not port across Amazon storefronts.
1. Search: GET https://wedding-gift-board.vercel.app/api/v1/search?q=kitchen%20knife%20set&budgetBand=300-700&styleTag=home&limit=5&marketplace=amazon.de&locale=de
- paapi:true → products with /dp/ buyUrl on that store
- paapi:false → wedding-registry search deep-links + catalogMatches
2. Prefer one-shot: POST https://wedding-gift-board.vercel.app/api/v1/agent/create-and-fill
{"coupleNames":"Alex & Sam","weddingDate":"2026-09-12","budgetBand":"300-700","styleTags":["home","practical"],"marketplace":"amazon.se","locale":"sv","itemQueries":["cast iron skillet"],"itemKeywords":["linen napkin set"]}
3. Or POST https://wedding-gift-board.vercel.app/api/v1/wishlists then POST .../items with { "name", "asin"? , "url"? }
4. Save id, editToken, coupleUrl, guestUrl.
5. Give the couple coupleUrl (/w/{{id}}) to publish; give guests guestUrl (/w/{{id}}/guest) to buy by budget.
6. Resolve: POST https://wedding-gift-board.vercel.app/api/v1/products/resolve {"keywords":"…","marketplace":"amazon.com","locale":"en"} or {"url":"https://www.amazon.de/dp/…"}.
7. Catalog GET https://wedding-gift-board.vercel.app/api/v1/catalog?marketplace=&locale= — curated starters (amazon.se default; marketplace=amazon.com for the US catalog with amazon.com/dp links).
8. Health GET https://wedding-gift-board.vercel.app/api/v1/health.
9. If storage is "token", mutations may return a new id — prefer Upstash Redis for stable share links.
10. Read https://wedding-gift-board.vercel.app/llms.txt, https://wedding-gift-board.vercel.app/skill.md, and https://wedding-gift-board.vercel.app/openapi.json.
CORS * on /api/v1/*. Gift inspiration API for wedding gift boards / shopping lists / recommendation lists. Pass marketplace + locale. amazon.se buy links use ?tag=sw-wedding-21, amazon.com (US) buy links use ?tag=sw-wedding-20; other storefronts untagged. US users: marketplace=amazon.com&locale=en. Store order: marketplace → country → Accept-Language; with neither marketplace nor country, Accept-Language en-US selects amazon.com, anything else amazon.se. A missing or unknown marketplace falls back to the default (never a 400).Search
curl -sS 'https://wedding-gift-board.vercel.app/api/v1/search?q=kitchen%20knife%20set&budgetBand=300-700&styleTag=home&limit=5&marketplace=amazon.de&locale=de'
Create-and-fill
curl -sS -X POST https://wedding-gift-board.vercel.app/api/v1/agent/create-and-fill \
-H 'Content-Type: application/json' \
-d '{"coupleNames":"Alex & Sam","budgetBand":"300-700","styleTags":["home","practical"],"marketplace":"amazon.se","locale":"sv","itemQueries":["cast iron skillet"],"itemKeywords":["linen napkin set"]}'Resolve
curl -sS -X POST https://wedding-gift-board.vercel.app/api/v1/products/resolve \
-H 'Content-Type: application/json' \
-d '{"keywords":"wedding gift kitchen","marketplace":"amazon.com","locale":"en"}'Add item
curl -sS -X POST https://wedding-gift-board.vercel.app/api/v1/wishlists/ID/items \
-H 'Content-Type: application/json' \
-H 'X-Edit-Token: EDIT_TOKEN' \
-d '{"name":"Cast iron skillet","searchKeywords":"cast iron skillet","emoji":"🍳"}'Catalog
curl -sS 'https://wedding-gift-board.vercel.app/api/v1/catalog?styleTag=home&marketplace=amazon.se&locale=sv'
Get wishlist
curl -sS https://wedding-gift-board.vercel.app/api/v1/wishlists/ID