get_health
Health & marketplaces
Health check for Birthday Gift Finder. Returns ok, storage, defaultDomain (amazon.se), catalogs for amazon.se and amazon.com with their tracking tags, and marketplaces[]. Use this first. OpenAPI: getHealth.
Takes no parameters.
list_marketplaces
List Amazon marketplaces
List supported Amazon storefronts. amazon.com (US) and amazon.se have hand-picked catalogs with /dp links. Pass marketplace on search/catalog/resolve when you know the user's store; otherwise en-US requests get amazon.com and everything else amazon.se.
Takes no parameters.
search_gifts
Search birthday gifts
Search birthday gifts on the user's Amazon storefront. Pass marketplace=amazon.com for US shoppers (English search), amazon.se for Sweden. Returns search links plus hand-picked catalogMatches with /dp links. OpenAPI: searchAmazon.
ParametersqrequiredlimitlocaleageBandcountryoccasionmarketplacegiftCategory
get_catalog
Curated gift catalog
Paginated hand-picked birthday gifts with /dp buyUrls. marketplace=amazon.com returns the US catalog (English, USD or no price, tag sw-fodelsedag-20); amazon.se the Swedish one (tag sw-fodelsedag-21). OpenAPI: getCatalog.
ParametersqlimitlocaleoffsetcountryoccasionmarketplacegiftCategorygiftCategories
resolve_product
Resolve buy link
Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl on amazon.com or amazon.se (tagged for both). Pass marketplace when known. OpenAPI: resolveProduct.
ParametersurlasinlocalecountrykeywordsoccasionbudgetBandmarketplacegiftCategory
create_wishlist
Create wishlist
Create a birthday gift wishlist. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_wishlist_item. OpenAPI: createWishlist.
ParametersitemslocaleageBandcountryoccasionbudgetBandmarketplacerecipientNamegiftCategories
create_and_fill
One-shot create and fill
One call: create a curated birthday gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a wishlist and add ASINs / keywords / search queries in one call. OpenAPI: agentCreateAndFill.
ParameterslocaleageBandcountryoccasionitemAsinsbudgetBanditemQueriesmarketplaceitemKeywordsrecipientNamegiftCategories
Fetch a wishlist by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.
Parametersidrequired
add_wishlist_item
Add wish item
Add an item to a wishlist. Requires editToken from create. OpenAPI: addWishlistItem.
ParametersidrequiredurlasinnameemojititlecatalogIdeditTokenrequiredsearchKeywords