search_inventory
Search the catalog
Search the live NOSTOS catalog of retro games, consoles, and vintage apparel. Free-text query (accents optional) plus platform, department, region, condition, and price filters. Returns items for sale online and in the Duluth shop, title matches first; each says how to buy it (howToBuy). Every item is individually graded.
ParameterslimitqueryregionmaxPriceminPriceplatformconditiondepartmentonlineOnlyincludeSold
Full details for one SKU: description, condition notes, price, region, image, a direct product URL, how to buy it (online or in the shop only), and real-time availability.
Parametersskurequired
check_availability
Live availability
Real-time status for up to 50 SKUs: available (online and in the shop), available-in-store-only, reserved, sold, or invalid. The live source of truth; the catalog can lag a recent sale.
Parametersskusrequired
list_platforms
Platforms in stock
List the console platforms currently in stock, each with a count of available items.
Takes no parameters.
list_departments
Departments in stock
List the store departments currently in stock (e.g. 'VG - Software', 'Apparel'), each with a count of available items.
Takes no parameters.
list_recent_drops
Recent drops
List the most recently added in-stock items, newest first. The answer to what's new at NOSTOS.
Parameterslimit
NOSTOS store information: address, hours, contact, mission, tagline, categories, area served, social links, and current online and storefront status.
Takes no parameters.
get_condition_grading_rubric
Condition grading rubric
The NOSTOS condition grading vocabulary and the criteria for each grade, with region-code meanings. Optionally filter to one department.
Parametersdepartment
get_buying_policy
Buying policy
What NOSTOS buys and declines, how cash and store-credit offers are calculated, bounty premiums, basket caps, the free shipping label threshold, and the trade-in process.
Takes no parameters.
get_return_policy
Return policy
The NOSTOS return policy: 14 days from delivery; NOSTOS pays return shipping on misrepresented, non-working or transit-damaged items; change-of-mind returns accepted with the buyer paying return shipping; refund timing.
Takes no parameters.
get_credit_policy
Store credit policy
How NOSTOS store credit works: the 15% uplift over cash, how it's earned, where it's spent (in person at the Duluth shop), and how long it lasts.
Takes no parameters.
get_shipping_estimate
Shipping policy
The NOSTOS shipping policy for a destination country (US, Canada, or not-yet-active international): the US rates and free-shipping rule, Canada's flat rate, and the free prepaid trade-in label. Policy, not a live carrier rate.
Parametersdestination_countryrequired
lookup_market_price
What NOSTOS would pay
What NOSTOS would pay for one game or console, in cash and in store credit, by condition (loose, CIB, box and game, new), from NOSTOS's own pricing engine. Says when NOSTOS isn't buying a line, or prices it in person at the counter, and why. An estimate, not an offer.
Parametersnamerequiredplatformcondition
get_trade_in_offer_estimate
Trade-in offer estimate
Cash and store-credit totals for up to 25 items someone wants to sell. Name each item, its platform and its condition; NOSTOS prices every line itself, reports any it isn't buying, and says whether the free prepaid label applies and whether the basket goes to a personal review. An estimate that saves nothing.
Parametersitemsrequired