← Home · llms.txt · openapi.json
Desk-setup shopping lists and gear recommendations. Pass marketplace +locale +role +budgetBand.ownerUrl = desk owner;shopUrl = buyer. On amazon.se, catalogMode=asin with trackingTag sw-homeoffice-21.
/* curated-v2 */ Create a gift wishlist for home office setup 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 home office setup. Fastest: POST https://home-office-builder.vercel.app/api/v1/agent/create-and-fill {"personName": "Marcus", "role": "developer", "budgetBand": "1500-4000", "marketplace": "amazon.se", "locale": "sv", "itemQueries": ["skärmarm"]} → give the user shopUrl. Products are carefully selected by us (not customer-reviewed; no ratings).
You are helping build a home-office desk via the Home Office Builder API.
Base URL: https://home-office-builder.vercel.app
ALWAYS pass marketplace + locale on search and create (search-on-selected-store).
1. Search: GET https://home-office-builder.vercel.app/api/v1/search?q=monitor%20arm&role=developer&budgetBand=1500-4000&marketplace=amazon.se&locale=sv&limit=5
- paapi:true → products with /dp/ buyUrl
- paapi:false → desk-setup search deep-links + catalogMatches
2. Prefer one-shot: POST https://home-office-builder.vercel.app/api/v1/agent/create-and-fill
{"personName":"Marcus","role":"developer","budgetBand":"1500-4000","marketplace":"amazon.se","locale":"sv","itemQueries":["monitor arm"],"itemKeywords":["mechanical keyboard"]}
3. Or POST https://home-office-builder.vercel.app/api/v1/wishlists then POST .../items with { "name", "asin"? , "url"? }
4. Save id, editToken, ownerUrl, shopUrl.
5. Give the desk owner ownerUrl (/w/{{id}}); give the buyer shopUrl (/w/{{id}}/shop).
6. Resolve: POST https://home-office-builder.vercel.app/api/v1/products/resolve {"keywords":"ergonomic chair","role":"general","marketplace":"amazon.com","locale":"en-US"}.
7. Catalog GET https://home-office-builder.vercel.app/api/v1/catalog?role=developer&budgetBand=1500-4000&marketplace=amazon.se&locale=sv — curated starters only; search is primary.
8. Health GET https://home-office-builder.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://home-office-builder.vercel.app/llms.txt and https://home-office-builder.vercel.app/openapi.json.
CORS * on /api/v1/*. amazon.se uses trackingTag sw-homeoffice-21 via NEXT_PUBLIC_AMAZON_TAGS_JSON; other storefronts stay untagged. Prefer buyUrl + trackingTag. Never invent placeholders; never reuse Santa/girlfriend tags.Search
curl -sS 'https://home-office-builder.vercel.app/api/v1/search?q=monitor%20arm&role=developer&budgetBand=1500-4000&marketplace=amazon.se&locale=sv&limit=5'
Create-and-fill
curl -sS -X POST https://home-office-builder.vercel.app/api/v1/agent/create-and-fill \
-H 'Content-Type: application/json' \
-d '{"personName":"Marcus","role":"developer","budgetBand":"1500-4000","marketplace":"amazon.se","locale":"sv","itemQueries":["monitor arm"],"itemKeywords":["mechanical keyboard"]}'Resolve
curl -sS -X POST https://home-office-builder.vercel.app/api/v1/products/resolve \
-H 'Content-Type: application/json' \
-d '{"keywords":"ergonomic chair","role":"general","marketplace":"amazon.se","locale":"sv"}'Add item
curl -sS -X POST https://home-office-builder.vercel.app/api/v1/wishlists/ID/items \
-H 'Content-Type: application/json' \
-H 'X-Edit-Token: EDIT_TOKEN' \
-d '{"name":"Monitor arm","searchKeywords":"monitorarm","emoji":"🖥️"}'Catalog
curl -sS 'https://home-office-builder.vercel.app/api/v1/catalog?role=developer&budgetBand=1500-4000&marketplace=amazon.se&locale=sv'
Get board
curl -sS https://home-office-builder.vercel.app/api/v1/wishlists/ID
amazon.se uses real tag sw-homeoffice-21 via NEXT_PUBLIC_AMAZON_TAGS_JSON. Other storefronts stay untagged. Prefer buyUrl + trackingTag. Never reuse Santa/Girlfriend tags.