← Home · llms.txt · openapi.json
Mother's Day gift search + list loop. Pass marketplace + locale. ownerUrl = mom publishes; shopUrl = gift giver shops. Catalog = curated starters; search is primary.
/* curated-v2 */ Create a gift wishlist for Mother's Day (Mors dag) 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 Mother's Day (Mors dag). Fastest: POST https://mothers-day-gifts.vercel.app/api/v1/agent/create-and-fill {"recipientName": "Anna", "occasion": "mothers-day", "budgetBand": "300-700", "styleTags": ["wellness"], "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["spa present"]} → give the user shopUrl. Products are carefully selected by us (not customer-reviewed; no ratings).
You are helping with thoughtful Mother's Day / Mors dag gifts via the Mother's Day Gifts API (gift inspiration).
Base URL: https://mothers-day-gifts.vercel.app
ALWAYS pass marketplace + locale (e.g. marketplace=amazon.com&locale=en or marketplace=amazon.se&locale=sv).
1. Search: GET https://mothers-day-gifts.vercel.app/api/v1/search?q=spa%20set&occasion=mothers-day&budgetBand=300-700&styleTag=wellness&marketplace=amazon.se&locale=sv&limit=5
- paapi:true → products with /dp/ buyUrl
- paapi:false → Mother's Day search deep-links + catalogMatches
2. Prefer one-shot: POST https://mothers-day-gifts.vercel.app/api/v1/agent/create-and-fill
{"recipientName":"Anna","occasion":"mothers-day","budgetBand":"300-700","styleTags":["wellness","jewelry"],"relationship":"mom","marketplace":"amazon.se","locale":"sv","itemQueries":["spa present"],"itemKeywords":["guldhalsband"]}
3. Or POST https://mothers-day-gifts.vercel.app/api/v1/wishlists then POST .../items with { "name", "asin"? , "url"? }
4. Save id, editToken, ownerUrl, shopUrl.
5. Give mom ownerUrl (/w/{{id}}) to publish wishes; give gift giver shopUrl (/w/{{id}}/shop) to buy.
6. Resolve: POST https://mothers-day-gifts.vercel.app/api/v1/products/resolve {"asin":"…","marketplace":"amazon.se","locale":"sv"} or {"url":"https://www.amazon.se/dp/…"}.
7. Catalog GET https://mothers-day-gifts.vercel.app/api/v1/catalog — curated starters only; ASINs trusted mainly on amazon.se; search is primary.
8. Marketplaces GET https://mothers-day-gifts.vercel.app/api/v1/marketplaces · Health GET https://mothers-day-gifts.vercel.app/api/v1/health.
9. If storage is "token", mutations may return a new id — prefer Upstash Redis (prefix mdwl:) for stable share links.
10. Read https://mothers-day-gifts.vercel.app/llms.txt , https://mothers-day-gifts.vercel.app/skill.md , https://mothers-day-gifts.vercel.app/openapi.json.
CORS * on /api/v1/*. Prefer buyUrl + trackingTag. Amazon URLs omit tag= until real Associates IDs are set via NEXT_PUBLIC_AMAZON_AFFILIATE_TAG / NEXT_PUBLIC_AMAZON_TAGS_JSON. Never invent mothersdaygift-21 or reuse Santa/girlfriend/Valentine tags.Search
curl -sS 'https://mothers-day-gifts.vercel.app/api/v1/search?q=spa%20set&occasion=mothers-day&budgetBand=300-700&styleTag=wellness&marketplace=amazon.se&locale=sv&limit=5'
Create-and-fill
curl -sS -X POST https://mothers-day-gifts.vercel.app/api/v1/agent/create-and-fill -H 'Content-Type: application/json' -d '{"recipientName":"Anna","occasion":"mothers-day","budgetBand":"300-700","styleTags":["wellness","jewelry"],"relationship":"mom","marketplace":"amazon.se","locale":"sv","itemQueries":["spa present"],"itemKeywords":["guldhalsband"]}'Resolve
curl -sS -X POST https://mothers-day-gifts.vercel.app/api/v1/products/resolve -H 'Content-Type: application/json' -d '{"keywords":"pearl stud earrings mothers day","marketplace":"amazon.se","locale":"sv"}'Add item
curl -sS -X POST https://mothers-day-gifts.vercel.app/api/v1/wishlists/ID/items -H 'Content-Type: application/json' -H 'X-Edit-Token: EDIT_TOKEN' -d '{"name":"Spa gift set","searchKeywords":"spa present mors dag","emoji":"🛁"}'Catalog
curl -sS 'https://mothers-day-gifts.vercel.app/api/v1/catalog?styleTag=wellness&occasion=mothers-day&marketplace=amazon.se&locale=sv'
Get wishlist
curl -sS https://mothers-day-gifts.vercel.app/api/v1/wishlists/ID