← Home · llms.txt · openapi.json

For AI agents

Pet shopping list / welcome box search + owner/shopper loop. ownerUrl = build the kit; shopUrl = buy. Always pass marketplace + locale. Catalog = curated starters (150+ ASINs); search is primary. amazon.se uses tag sw-petbox-21 when configured. Prefer buyUrl / trackingTag. Short “may earn from qualifying purchases” disclosure is OK in UI.

Agent prompt (copy)

/* curated-v2 */ Create a gift wishlist for new puppy / kitten 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 new puppy / kitten. Fastest: POST https://pet-welcome-box.vercel.app/api/v1/agent/create-and-fill {"petName": "Luna", "species": "dog", "stage": "puppy", "budgetBand": "500-1500", "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["hundbädd"]} → give the user shopUrl. Products are carefully selected by us (not customer-reviewed; no ratings).

You are helping with Pet Welcome Box — pet shopping lists and first-30-days welcome boxes for new dogs/cats/other pets (new puppy checklist, kitten kit, recommendation lists).

Base URL: https://pet-welcome-box.vercel.app

ALWAYS pass marketplace + locale (never assume amazon.se is the only storefront).

1. Search: GET https://pet-welcome-box.vercel.app/api/v1/search?q=no-pull%20harness&species=dog&sizeBand=medium&kitCategory=walking&budgetBand=500-1500&marketplace=amazon.com&locale=en-US&limit=5
   - paapi:true → products with /dp/ buyUrl
   - paapi:false → pet-supply search deep-links + catalogMatches
2. Prefer one-shot: POST https://pet-welcome-box.vercel.app/api/v1/agent/create-and-fill
   {"petName":"Luna","species":"dog","sizeBand":"medium","stage":"puppy","budgetBand":"500-1500","kitCategories":["containment","bedding","bowls","walking"],"marketplace":"amazon.se","locale":"sv-SE","itemQueries":["hundbur"],"itemKeywords":["valp träningsunderlägg"]}
3. Or POST https://pet-welcome-box.vercel.app/api/v1/wishlists then POST .../items with { "name", "asin"? , "url"? }
4. Save id, editToken, ownerUrl, shopUrl.
5. Give ownerUrl (/w/{{id}}) to build the kit; give shopUrl (/w/{{id}}/shop) to buy.
6. Resolve: POST https://pet-welcome-box.vercel.app/api/v1/products/resolve {"keywords":"dog leash","species":"dog","marketplace":"amazon.co.uk","locale":"en-GB"}.
7. Catalog GET https://pet-welcome-box.vercel.app/api/v1/catalog?species=dog&sizeBand=medium&marketplace=amazon.se&locale=sv-SE — curated starters (150+ ASINs); search is primary.
8. Health GET https://pet-welcome-box.vercel.app/api/v1/health.
9. If storage is "token", mutations may return a new id — prefer Upstash Redis (prefix pwb:) for stable share links.
10. Read https://pet-welcome-box.vercel.app/llms.txt and https://pet-welcome-box.vercel.app/openapi.json.
CORS * on /api/v1/*. amazon.se buy links use Associates tag sw-petbox-21 when configured. Never invent placeholder tags or reuse tags from other verticals. Prefer buyUrl / trackingTag. MCP: https://pet-welcome-box.vercel.app/api/mcp

curl examples

curl -sS 'https://pet-welcome-box.vercel.app/api/v1/search?q=no-pull%20harness&species=dog&sizeBand=medium&kitCategory=walking&marketplace=amazon.com&locale=en-US&limit=5'
curl -sS -X POST https://pet-welcome-box.vercel.app/api/v1/agent/create-and-fill   -H 'Content-Type: application/json'   -d '{"petName":"Luna","species":"dog","sizeBand":"medium","stage":"puppy","budgetBand":"500-1500","kitCategories":["containment","bedding","bowls"],"marketplace":"amazon.se","locale":"sv-SE","itemQueries":["hundbur"],"itemKeywords":["valp pads"]}'
curl -sS -X POST https://pet-welcome-box.vercel.app/api/v1/products/resolve   -H 'Content-Type: application/json'   -d '{"keywords":"cat litter box","species":"cat","marketplace":"amazon.de","locale":"de-DE"}'
curl -sS -X POST https://pet-welcome-box.vercel.app/api/v1/wishlists/ID/items   -H 'Content-Type: application/json'   -H 'X-Edit-Token: EDIT_TOKEN'   -d '{"name":"No-pull harness","searchKeywords":"no pull dog harness","emoji":"🦺"}'
curl -sS 'https://pet-welcome-box.vercel.app/api/v1/catalog?species=dog&sizeBand=medium&kitCategory=walking&marketplace=amazon.se&locale=sv-SE'
curl -sS https://pet-welcome-box.vercel.app/api/v1/wishlists/ID

Endpoints

  • GET /api/v1/health
  • GET /api/v1/search?q=&species=&sizeBand=&stage=&kitCategory=&budgetBand=&marketplace=&locale=&limit=
  • POST /api/v1/wishlists
  • POST /api/v1/agent/create-and-fill
  • GET /api/v1/catalog?species=&sizeBand=&marketplace=&locale=
  • POST /api/v1/products/resolve
  • GET /api/v1/marketplaces