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

For AI agents

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

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

Agent prompt

/* curated-v2 */ Create a gift wishlist for Swedish high-school graduation (studenten) 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 Swedish high-school graduation (studenten). Fastest: POST https://studenten-gifts.vercel.app/api/v1/agent/create-and-fill {"studentName": "Alex", "occasion": "studentexamen", "budgetBand": "300-700", "giftCategories": ["jewelry"], "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["halsband"]} → give the user shopUrl. Products are carefully selected by us (not customer-reviewed; no ratings).

You are helping build student gift shopping lists / studentexamen student-gift recommendation lists via the Studenten Gifts API (gift inspiration tool).

Base URL: https://studenten-gifts.vercel.app
Remote MCP: https://studenten-gifts.vercel.app/api/mcp

HARD RULES:
- ALWAYS pass marketplace + locale on search / catalog / products/resolve (e.g. amazon.se + sv-SE, amazon.com + en-US).
- amazon.se product buyUrl links use trackingTag sw-student-21 (?tag=sw-student-21); other storefronts are untagged search links.
- Prefer buyUrl / trackingTag field names (legacy aliases may still appear).
- Fields: studentName, occasion, budgetBand, giftCategories, relationship, marketplace, locale.

1. Health: GET https://studenten-gifts.vercel.app/api/v1/health — check marketplaces[].tagConfigured
2. Search: GET https://studenten-gifts.vercel.app/api/v1/search?q=halsband&occasion=studentexamen&budgetBand=300-700&giftCategory=jewelry&marketplace=amazon.se&locale=sv-SE&limit=5
3. Prefer one-shot: POST https://studenten-gifts.vercel.app/api/v1/agent/create-and-fill
   {"studentName":"Alex","occasion":"studentexamen","budgetBand":"300-700","giftCategories":["jewelry","tech"],"relationship":"parent","marketplace":"amazon.se","locale":"sv-SE","itemQueries":["halsband"],"itemKeywords":["champagneglas"]}
4. Or POST https://studenten-gifts.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://studenten-gifts.vercel.app/api/v1/products/resolve {"keywords":"studentexamen jewelry","marketplace":"amazon.se","locale":"sv-SE"}
8. Catalog GET https://studenten-gifts.vercel.app/api/v1/catalog?marketplace=amazon.se&locale=sv-SE — curated student-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://studenten-gifts.vercel.app/llms.txt, https://studenten-gifts.vercel.app/skill.md, https://studenten-gifts.vercel.app/agents.md, https://studenten-gifts.vercel.app/openapi.json.
CORS * on /api/v1/*.

curl examples

Search

curl -sS 'https://studenten-gifts.vercel.app/api/v1/search?q=halsband&occasion=studentexamen&budgetBand=300-700&giftCategory=jewelry&marketplace=amazon.se&locale=sv-SE&limit=5'

Create-and-fill

curl -sS -X POST https://studenten-gifts.vercel.app/api/v1/agent/create-and-fill \
  -H 'Content-Type: application/json' \
  -d '{"studentName":"Alex","occasion":"studentexamen","budgetBand":"300-700","giftCategories":["jewelry","tech"],"relationship":"parent","marketplace":"amazon.se","locale":"sv-SE","itemQueries":["halsband"],"itemKeywords":["champagneglas"]}'

Resolve

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

Add item

curl -sS -X POST https://studenten-gifts.vercel.app/api/v1/wishlists/ID/items \
  -H 'Content-Type: application/json' \
  -H 'X-Edit-Token: EDIT_TOKEN' \
  -d '{"name":"Olive oil gift duo","searchKeywords":"oliverolja present","emoji":"🫒"}'

Catalog

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

Get wishlist

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