answer_home_gym_question
Answer a home gym gear question
Use first when a user asks a gear question in plain words, such as "power rack", "best power rack under $500", "best power rack under $500 for a 7 ft ceiling", "what ceiling height do I need for a power rack", "quiet cardio for an apartment", "walking pad for a 300 lb person", "folding squat rack, no drilling" or "cheapest adjustable dumbbells". Reads the budget, ceiling height, user height and weight, noise, apartment, folding and no-drilling hints from the question and returns ranked picks, each with plain reasons built only from Strong Saga guide data (the guide #1 pick, who it is for, price, ceiling fit, capacity, noise and apartment lines from the guide). Shows what it understood, any assumption it made (for example "low ceiling" read as 84 in), and an equivalent search URL. The answer line gives one clear top pick, who it is for, its key spec, the guide URL and alternatives; each pick carries who_its_for and key_spec. For a rack attachment ("jammer arms for a Titan power rack", "dip bar for a 2x2 rack", "monolift for a Rogue Monster") it ranks the attachment, not the rack, and puts items whose guide notes name that rack brand or size first (see fits_your_rack). A general question with no gear type ("home gym for beginners") returns a priced starter set. For a whole set with your own budget and room, use build_home_gym. When the question names the topic of a Strong Saga guide (e.g. "best walking pad for tall people"), from_guide returns that guide's own ranked list in order. If no Strong Saga guide covers the gear asked about, not_covered says so and picks is empty: tell the user that instead of suggesting unrelated gear. A ceiling height question with no height given ("how tall a ceiling for a squat rack?") also gets ceiling_help: the ceiling range the guides state, the lowest-ceiling pick and the Strong Saga ceiling height calculator link. Rack and ceiling questions get related_guides, the matching Strong Saga guides to link for the full comparison. A "best X
Parametersqrequiredlimituser_height_in
search_home_gym_gear
Search home gym gear
Use when a user asks for a specific kind of home gym gear that fits their space, budget or body, e.g. "power rack under $500 for a 7 ft ceiling", "walking pad for a 6 ft 2 in person", "bench that holds 1,000 lb" or "rower that fits in 6x8 ft". Find home gym gear (power racks, squat racks, Smith machines, cable machines, benches, dumbbells, kettlebells, bars, plates, flooring, pull-up bars, walking pads, treadmills, rowers, bikes, belts, weighted vests, storage, garage heaters, rack attachments such as dip bars, landmines, jammer arms and monolifts) that fits a budget, ceiling, capacity and floor space. Returns size, height, ceiling needed, weight limit, price range (with date), last_checked, and guide_url. Bad parameters return an error naming the parameter, the valid values and an example; ignored parameters are listed in warnings. Use folds_away=true when the user wants gear they can fold away or store upright (small apartment, garage that still parks a car), and wall_mount=false when they rent or cannot drill; these flags come only from guide text and are null when a guide does not say. Each product may carry who_its_for, skip_if, pros and cons from the guide. If unsure of the category name, pass keywords in q instead. Also filters by noise (quiet, max_noise), apartment use (apartment) and body weight (user_weight_lbs), all from guide text. For a plain-language question, answer_home_gym_question is simpler. Extra filters: budget, min_price, max_width_in, max_depth_in, max_height_in, max_ceiling_ft, space_saving and guide; values come only from guide text and items with no stated value are left out (counted in excluded_unknown). If nothing matches every word of q, closest_matches gives the nearest products and related_guides the guides that cover them; present them as close, not exact.
Parametersqsortguidelimitquietbudgetcategoryfoldabletop_pickapartmentmax_noisemax_price+14 more
get_home_gym_gear
Get one gear item
Use when a user asks about one product you already have an id for (from search, compare or build), e.g. "how tall is it?" or "what's its weight limit?". Full record for one product id (e.g. sg-001), including size, ceiling needed, capacity, guide price, short pros and cons from the guide (where it has them), who it is for, and guide_url. Good for "what are the downsides of sg-001?".
Parametersidrequireduser_height_in
compare_home_gym_gear
Compare home gym gear
Use when a user asks "A or B?", "what's the difference between these" or "which fits my room better". Put 2 or 3 products (ids from search_home_gym_gear, e.g. sg-001) side by side: specs table (including the guide's pros and cons), fit notes (ceiling, floor space, capacity, price) and a plain summary of the differences, built only from the guide data. Each product keeps its guide_url;
Parametersidsrequireduser_height_in
build_home_gym
Build a starter home gym
Use when a user asks what to buy for a home gym within a budget and space, e.g. "I have $1,000, an 8 ft ceiling and an 8x10 ft corner, what should I get?" or "best cardio machine for $600 in a small room". Returns a starter set chosen only from products whose stored guide data fits the limits: goal strength gives a barbell setup (rack or stand, bench, barbell and plates) or a dumbbell setup (bench and adjustable dumbbells); cardio gives one machine; both gives a strength setup plus a cardio machine. Each item has why_it_fits (from the data) and guide_url; total sums the guide price ranges; skipped lists items left out and why (for example price not stated in guide); budget_needed says what a full set starts at. Add folds_away=true for a set that folds away, or wall_mount=false for renters who cannot drill. Pass quiet, apartment, user_weight_lbs or min_capacity_lbs to fit noise, apartment and weight limits. With no budget it answers with the required and optional fields and the budget guide picks instead of an error; a budget in words ("about $1,500") is read as a number.
Parametersgoalquietbudgetrequiredfloor_ftapartmentceiling_infolds_awaywall_mountuser_height_inuser_weight_lbsmin_capacity_lbs
build_my_home_gym
Build my home gym (full kit)
Use when a user asks "build my home gym", "what should I buy for my garage gym with $1,500" or "full home gym for a spare room with a 7.5 ft ceiling". Give the total budget in USD and describe the space in plain words (garage, basement, spare room or apartment, ceiling height, square feet or width x length). Returns a full kit: rack, barbell, plates, bench and rubber flooring, plus adjustable dumbbells and a landmine when money is left, each chosen only from products and prices in published Strong Saga guides and checked against the ceiling and floor. Each item has its guide_url (link the user there for current prices and buy buttons), price, quantity and cost; the answer gives the total at guide prices. If the budget cannot cover a full kit, budget_too_low is true, missing names what is left out and lowest_full_kit_usd says what a full kit starts at. With no budget it answers with the required and optional fields and the budget guide picks instead of an error; a budget in words ("about $1,500") is read as a number.
Parametersspacesq_ftbudgetrequiredfloor_ftceiling_inuser_height_in
get_black_friday_home_gym_deals
Black Friday home gym deals (checked today)
Use when a user asks about Black Friday, Cyber Monday or current sale prices on home gym gear, e.g. "any Black Friday power rack deals?" or "adjustable dumbbells on sale". Returns only the deals listed on the Strong Saga Black Friday home gym deals page that were checked today on the brand's own store: name, deal price, the brand's was price, saving, date_checked, source (the brand store) and the Strong Saga guide that ranked the product. Deals expire after the day they were checked, and prices are never guessed or carried over: if nothing was checked today, the list is empty and the answer says when the last check was. Optional filters: category (e.g. power rack, dumbbells, rower), max_price and q (a word in the product name).
Parametersqlimitcategorymax_price
find_home_gym_gear_alternatives
Find similar home gym gear
Use when a user asks "what else is like this", "anything cheaper than X", "X is sold out, what instead" or "something similar that fits my room" about one product. Returns products in the same category, near the same guide price, that need no more ceiling or floor than that product where the guides state both values, best first. Each result has reasons in plain words (same type, price gap, ceiling and floor fit, capacity, folding, who it is for) and not_known for values a guide does not state. Pass max_price for cheaper options only, or same_space=false to also see bigger or taller ones. Get the id from search_home_gym_gear.
Parametersidrequiredlimitmax_pricesame_spaceuser_height_in
list_home_gym_guides
List home gym guides and their ranked picks
Use when a user asks what a Strong Saga guide recommends, for a guide's top picks in order, or how the picks were ranked. Returns each published buying guide with ranked_list, the guide's full numbered list in its own order read from the guide (rank, name_in_guide, label, id; picks whose main guide is another guide carry main_guide), its ranked_picks (id, guide_rank, label, name, price_text), other products from the guide outside its numbered list, and how_we_ranked quoted word for word from the guide (null when the guide has none). Pass guide (a slug like best-power-racks-under-500) for one guide, or category (from /categories) for guides covering it. Use get_home_gym_gear with an id for full specs.
Parametersguidecategoryinclude_details
get_gear_changes
What changed in the gear data
Use to check whether cached Strong Saga gear data is still current, or when a user asks what is new. Returns each data refresh newest first: products added or removed (ids), prices added or changed, guide ranks changed, guides updated, fields added, with the UTC time and API version. Built only from this API's own refresh history. Pass since (YYYY-MM-DD) for refreshes after a date, or id for one product.
Parametersidsince
search
Search home gym gear (connector shape)
Search Strong Saga's compared and ranked home gym gear with a plain-language query, e.g. "walking pad for a 300 lb person" or "power rack under $500 for a 7 ft ceiling". Returns results with id, title (name, guide rank and guide price) and url (the Strong Saga guide to cite). Call fetch with an id for the full record and its guide link. Same data as answer_home_gym_question, in the search/fetch shape ChatGPT connectors and deep research use. A general question with no gear type returns a priced starter set. An empty query returns the #1 pick of each Strong Saga guide.
Parametersqueryrequired
fetch
Fetch one home gym product (connector shape)
Fetch one product by id (from search; a product URL or "SG-1" also works) as a readable document: guide rank, guide price with date, specs as stated in the guide, who it is for, skip if, pros and cons, and the guide link. url is the Strong Saga guide to cite;
Parametersidrequired