← Home · llms.txt · openapi.json · MCP

For AI agents

Developer & agent API — shoppers use the home page for gift inspiration.

Party gift shopping lists and julklappsspel recommendation lists via search + wishlist loop. ownerUrl = host publishes; shopUrl = guests shop. Always pass marketplace + locale. amazon.se buy links use tag=sw-julklappsspel-21; amazon.com (US) links use tag=sw-julklappsspel-20; other storefronts stay untagged search links. Prefer buyUrl / trackingTag. MCP at /api/mcp.

Agent prompt

/* curated-v2 */ Create a gift wishlist for Christmas gift game (julklappsspel / secret santa) in seconds from curated amazon.se products (or the English US catalog on amazon.com) — 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 Christmas gift game (julklappsspel / secret santa). Fastest: POST https://julklappsspel.vercel.app/api/v1/agent/create-and-fill {"hostName": "Alex", "occasion": "julklappsspel", "budgetBand": "200-400", "giftCategories": ["fun", "cozy"], "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["sällskapsspel"]} → give the user shopUrl. Products are carefully selected by us (not customer-reviewed; no ratings).

You are helping build party gift shopping lists / julklappsspel party gift recommendation lists via the Julklappsspel API (gift inspiration tool).

Base URL: https://julklappsspel.vercel.app
Remote MCP: https://julklappsspel.vercel.app/api/mcp

HARD RULES:
- Store selection: pass marketplace=amazon.com (US, English, USD) or marketplace=amazon.se (Sweden). If marketplace is missing, country is used (country=US / SE), then Accept-Language: requests starting with en-US get amazon.com; sv and everything else get amazon.se. A missing store never returns an error.
- amazon.se product buyUrl links use trackingTag sw-julklappsspel-21 (?tag=sw-julklappsspel-21); amazon.com (US catalog, budgetBands under-20|20-35|35-50|50-plus) uses sw-julklappsspel-20; other storefronts are untagged search links.
- Prefer buyUrl / trackingTag field names.
- Fields: hostName, occasion, budgetBand, giftCategories, marketplace, locale.

1. Health: GET https://julklappsspel.vercel.app/api/v1/health — check marketplaces[].tagConfigured
2. Search: GET https://julklappsspel.vercel.app/api/v1/search?q=cheese%20board&occasion=julklappsspel&budgetBand=200-400&giftCategory=fun&marketplace=amazon.se&locale=sv-SE&limit=5
3. Prefer one-shot: POST https://julklappsspel.vercel.app/api/v1/agent/create-and-fill
   {"hostName":"Alex","occasion":"julklappsspel","budgetBand":"200-400","giftCategories":["fun","cozy","games"],"marketplace":"amazon.se","locale":"sv-SE","itemQueries":["cheese board"],"itemKeywords":["scented candle"]}
4. Or POST https://julklappsspel.vercel.app/api/v1/wishlists then POST .../items with { "name", "asin"? , "url"? }
5. Save id, editToken, ownerUrl, shopUrl.
6. Give the host ownerUrl (/w/{{id}}); give guests shopUrl (/w/{{id}}/shop).
7. Resolve: POST https://julklappsspel.vercel.app/api/v1/products/resolve {"keywords":"julklapp present rolig","marketplace":"amazon.se","locale":"sv-SE"}
8. Catalog GET https://julklappsspel.vercel.app/api/v1/catalog?marketplace=amazon.se&locale=sv-SE — curated party-gift starters; search stays primary.
9. If storage is "token", mutations may return a new id — prefer Upstash Redis for stable share links.
10. Read https://julklappsspel.vercel.app/llms.txt, https://julklappsspel.vercel.app/skill.md, https://julklappsspel.vercel.app/agents.md, https://julklappsspel.vercel.app/openapi.json.
CORS * on /api/v1/*.

curl examples

Search

curl -sS 'https://julklappsspel.vercel.app/api/v1/search?q=cheese%20board&occasion=julklappsspel&budgetBand=200-400&giftCategory=fun&marketplace=amazon.se&locale=sv-SE&limit=5'

Create-and-fill

curl -sS -X POST https://julklappsspel.vercel.app/api/v1/agent/create-and-fill \
  -H 'Content-Type: application/json' \
  -d '{"hostName":"Alex","occasion":"julklappsspel","budgetBand":"200-400","giftCategories":["fun","cozy","games"],"marketplace":"amazon.se","locale":"sv-SE","itemQueries":["cheese board"],"itemKeywords":["scented candle"]}'

Resolve

curl -sS -X POST https://julklappsspel.vercel.app/api/v1/products/resolve \
  -H 'Content-Type: application/json' \
  -d '{"keywords":"julklapp present","marketplace":"amazon.se","locale":"sv-SE"}'

Add item

curl -sS -X POST https://julklappsspel.vercel.app/api/v1/wishlists/ID/items \
  -H 'Content-Type: application/json' \
  -H 'X-Edit-Token: EDIT_TOKEN' \
  -d '{"name":"Scented candle gift","searchKeywords":"doftljus present","emoji":"🕯️"}'

Catalog

curl -sS 'https://julklappsspel.vercel.app/api/v1/catalog?giftCategory=games&occasion=julklappsspel&marketplace=amazon.se&locale=sv-SE'

Get wishlist

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