← Home · llms.txt · openapi.json · MCP
Gaming gift inspiration search + wishlist loop. ownerUrl = gamer publishes; shopUrl = friends shop. Catalog = curated starters; search is primary. Remote MCP: https://gaming-wishlist.vercel.app/api/mcp.
/* curated-v2 */ Create a gift wishlist for gamers (gaming gifts) 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 gamers (gaming gifts). Fastest: POST https://gaming-wishlist.vercel.app/api/v1/agent/create-and-fill {"gamerName": "Alex", "platforms": ["pc"], "genres": ["accessories"], "budgetBand": "300-700", "marketplace": "amazon.se", "locale": "sv", "itemQueries": ["gaming headset"]} → give the user shopUrl. Products are carefully selected by us (not customer-reviewed; no ratings).
You are helping with thoughtful gaming gifts via the Gaming Wishlist API (gift inspiration tool).
Base URL: https://gaming-wishlist.vercel.app
MCP: https://gaming-wishlist.vercel.app/api/mcp
1. Search: GET https://gaming-wishlist.vercel.app/api/v1/search?q=wireless%20headset&platform=pc&budgetBand=300-700&genre=accessories&marketplace=amazon.com&locale=en&limit=5
- paapi:true → products with /dp/ buyUrl
- paapi:false → gaming search deep-links + catalogMatches
2. Prefer one-shot: POST https://gaming-wishlist.vercel.app/api/v1/agent/create-and-fill
{"gamerName":"Alex","platforms":["pc","steam-deck"],"genres":["accessories","fps"],"budgetBand":"700-1500","marketplace":"amazon.se","locale":"sv","itemQueries":["gaming headset"],"itemKeywords":["mechanical keyboard"]}
3. Or POST https://gaming-wishlist.vercel.app/api/v1/wishlists then POST .../items with { "name", "asin"? , "url"? }
4. Save id, editToken, ownerUrl, shopUrl.
5. Give the gamer ownerUrl (/w/{{id}}) to publish wishes; give friends shopUrl (/w/{{id}}/shop) to buy.
6. Resolve: POST https://gaming-wishlist.vercel.app/api/v1/products/resolve {"asin":"…"} or {"url":"https://www.amazon.se/dp/…"}.
7. Catalog GET https://gaming-wishlist.vercel.app/api/v1/catalog — curated gaming gift ASINs (wishlist / shopping-list starters); also use search.
8. Health GET https://gaming-wishlist.vercel.app/api/v1/health (service: gaming-wishlist).
9. If storage is "token", mutations may return a new id — prefer Upstash Redis for stable share links.
10. Read https://gaming-wishlist.vercel.app/llms.txt and https://gaming-wishlist.vercel.app/openapi.json.
CORS * on /api/v1/*. Gift inspiration tool with curated buy links. amazon.se product buyUrls include ?tag=sw-gaming-21; other storefronts stay untagged. Never invent tags or reuse santawishli03-21. Responses dual-write buyUrl (+ legacy affiliateUrl) and trackingTag (+ legacy affiliateTag). Catalog: /api/v1/catalog · MCP: /api/mcp. Search
curl -sS 'https://gaming-wishlist.vercel.app/api/v1/search?q=wireless%20headset&platform=pc&budgetBand=300-700&genre=accessories&marketplace=amazon.com&locale=en&limit=5'
Create-and-fill
curl -sS -X POST https://gaming-wishlist.vercel.app/api/v1/agent/create-and-fill -H 'Content-Type: application/json' -d '{"gamerName":"Alex","platforms":["pc","steam-deck"],"genres":["accessories","fps"],"budgetBand":"700-1500","marketplace":"amazon.se","locale":"sv","itemQueries":["gaming headset"],"itemKeywords":["mechanical keyboard"]}'Resolve
curl -sS -X POST https://gaming-wishlist.vercel.app/api/v1/products/resolve -H 'Content-Type: application/json' -d '{"keywords":"wireless gaming headset","marketplace":"amazon.com","locale":"en"}'Add item
curl -sS -X POST https://gaming-wishlist.vercel.app/api/v1/wishlists/ID/items -H 'Content-Type: application/json' -H 'X-Edit-Token: EDIT_TOKEN' -d '{"name":"Gaming headset","searchKeywords":"wireless gaming headset","emoji":"🎧"}'Catalog
curl -sS 'https://gaming-wishlist.vercel.app/api/v1/catalog?genre=accessories&platform=pc&marketplace=amazon.com&locale=en'
Get wishlist
curl -sS https://gaming-wishlist.vercel.app/api/v1/wishlists/ID