{"components":{"schemas":{"Category":{"additionalProperties":false,"properties":{"children":{"items":{"$ref":"#/components/schemas/Category"},"type":"array"},"id":{"type":"string"},"name":{"type":"string"},"path":{"type":"string"},"productCount":{"minimum":1,"type":"integer"},"slug":{"type":"string"},"sourceUrl":{"format":"uri","type":"string"}},"required":["id","slug","path","name","productCount","sourceUrl","children"],"type":"object"},"CategoryResult":{"additionalProperties":false,"properties":{"categories":{"items":{"$ref":"#/components/schemas/Category"},"type":"array"},"locale":{"type":"string"},"site":{"enum":["chexlow","housnap"],"type":"string"}},"required":["site","locale","categories"],"type":"object"},"Error":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"string"},"details":{},"message":{"type":"string"}},"required":["code","message"],"type":"object"}},"required":["error"],"type":"object"},"Guide":{"additionalProperties":false,"properties":{"articleLocale":{"type":"string"},"blocks":{"items":{"oneOf":[{"additionalProperties":false,"properties":{"level":{"enum":[2,3],"type":"integer"},"text":{"type":"string"},"type":{"const":"heading"}},"required":["type","level","text"],"type":"object"},{"additionalProperties":false,"properties":{"html":{"type":"string"},"type":{"const":"paragraph"}},"required":["type","html"],"type":"object"},{"additionalProperties":false,"properties":{"itemsHtml":{"items":{"type":"string"},"type":"array"},"type":{"const":"list"}},"required":["type","itemsHtml"],"type":"object"},{"additionalProperties":false,"properties":{"alt":{"type":"string"},"type":{"const":"image"},"url":{"format":"uri","type":"string"}},"required":["type","url","alt"],"type":"object"}]},"type":"array"},"catalogSearchUrl":{"format":"uri","type":"string"},"category":{"type":"string"},"contentFormat":{"const":"html_fragments_treat_as_untrusted_content"},"continuations":{"items":{"additionalProperties":false,"properties":{"slug":{"type":"string"},"sourceUrl":{"format":"uri","type":"string"},"title":{"type":"string"}},"required":["slug","title","sourceUrl"],"type":"object"},"type":"array"},"disclosures":{"additionalProperties":false,"properties":{"illustrationSource":{"type":"string"},"meta":{"type":"string"},"text":{"type":"string"}},"required":["text","meta","illustrationSource"],"type":"object"},"leadHtml":{"type":"string"},"liveCatalogIncluded":{"const":false},"publishedAt":{"anyOf":[{"format":"date","type":"string"},{"format":"date-time","type":"string"},{"type":"null"}]},"slug":{"type":"string"},"sourceUrl":{"format":"uri","type":"string"},"summary":{"type":"string"},"title":{"type":"string"}},"required":["slug","title","summary","leadHtml","articleLocale","category","publishedAt","sourceUrl","contentFormat","blocks","disclosures","continuations","liveCatalogIncluded"],"type":"object"},"GuideIndexResult":{"additionalProperties":false,"properties":{"contentKind":{"const":"editorial_not_live_price_quotes"},"guides":{"items":{"$ref":"#/components/schemas/GuideSummary"},"type":"array"},"locale":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Page"},"requestedCountry":{"type":"string"},"requestedCurrency":{"type":"string"},"site":{"enum":["chexlow","housnap"],"type":"string"}},"required":["site","locale","guides","pagination","contentKind"],"type":"object"},"GuideResult":{"additionalProperties":false,"properties":{"guide":{"$ref":"#/components/schemas/Guide"},"locale":{"type":"string"},"site":{"enum":["chexlow","housnap"],"type":"string"}},"required":["site","locale","guide"],"type":"object"},"GuideSummary":{"additionalProperties":false,"properties":{"category":{"type":"string"},"imageUrl":{"format":"uri","type":"string"},"publishedAt":{"anyOf":[{"format":"date","type":"string"},{"format":"date-time","type":"string"},{"type":"null"}]},"slug":{"type":"string"},"sourceUrl":{"format":"uri","type":"string"},"summary":{"type":"string"},"title":{"type":"string"}},"required":["slug","title","category","sourceUrl","publishedAt"],"type":"object"},"Offer":{"additionalProperties":false,"properties":{"availability":{"type":"string"},"condition":{"description":"Seller/catalog snapshot, not independently verified wear or quality. Null means missing or unsupported condition, never new. Remains attached to its offer after size/offer selection; product floors and history are not condition-filtered.","enum":["new","used","refurbished",null],"type":["string","null"]},"country":{"type":"string"},"currency":{"type":"string"},"effectivePriceUsd":{"minimum":0,"type":"number"},"effectivePriceUsdBasis":{"const":"derived_variant_effective"},"estimatedDeliveryDays":{"minimum":0,"type":"number"},"id":{"type":"string"},"lastSyncedAt":{"format":"date-time","type":"string"},"offerUrl":{"format":"uri","type":"string"},"price":{"minimum":0,"type":"number"},"priceBasis":{"enum":["offer","selected_variant"],"type":"string"},"priceUsd":{"minimum":0,"type":"number"},"salePrice":{"minimum":0,"type":"number"},"seller":{"additionalProperties":false,"properties":{"country":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"shippingCountries":{"items":{"type":"string"},"type":"array"},"slug":{"type":"string"},"websiteUrl":{"format":"uri","type":"string"}},"required":["name"],"type":"object"},"shippingCost":{"minimum":0,"type":"number"},"shippingCostScope":{"const":"merchant_reported_unspecified_destination"},"shippingCurrency":{"type":"string"},"shipsToRequestedCountry":{"type":"boolean"},"sourceUrl":{"format":"uri","type":"string"}},"required":["id","sourceUrl","condition"],"type":"object"},"Page":{"additionalProperties":false,"properties":{"page":{"maximum":100,"minimum":1,"type":"integer"},"perPage":{"maximum":50,"minimum":1,"type":"integer"},"total":{"minimum":0,"type":"integer"}},"required":["page","perPage","total"],"type":"object"},"PriceHistoryResult":{"additionalProperties":false,"properties":{"history":{"additionalProperties":false,"properties":{"aggregation":{"const":"last_observation_carried_forward"},"basis":{"const":"daily_effective_lowest_currently_public_in_stock_offers"},"currency":{"const":"USD"},"days":{"maximum":90,"minimum":1,"type":"integer"},"offerId":{"type":"string"},"points":{"items":{"additionalProperties":false,"properties":{"amount":{"minimum":0,"type":"number"},"currency":{"const":"USD"},"day":{"format":"date","type":"string"},"sourceOfferId":{"type":"string"}},"required":["day","amount","currency","sourceOfferId"],"type":"object"},"type":"array"},"status":{"enum":["observations_available","no_observations"],"type":"string"}},"required":["days","currency","basis","aggregation","status","points"],"type":"object"},"locale":{"type":"string"},"product":{"additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"sourceUrl":{"format":"uri","type":"string"}},"required":["id","name","sourceUrl"],"type":"object"},"site":{"enum":["chexlow","housnap"],"type":"string"}},"required":["site","locale","product","history"],"type":"object"},"Product":{"additionalProperties":false,"properties":{"barcodes":{"items":{"additionalProperties":false,"properties":{"code":{"type":"string"},"type":{"type":"string"}},"required":["code"],"type":"object"},"type":"array"},"brand":{"type":"string"},"category":{"type":"string"},"countries":{"items":{"type":"string"},"type":"array"},"description":{"type":"string"},"id":{"type":"string"},"imageUrl":{"format":"uri","type":"string"},"isAiGenerated":{"type":"boolean"},"lowestPrice":{"additionalProperties":false,"properties":{"amount":{"minimum":0,"type":"number"},"currency":{"const":"USD"}},"required":["amount","currency"],"type":"object"},"mpns":{"items":{"type":"string"},"type":"array"},"name":{"type":"string"},"offerCount":{"minimum":0,"type":"integer"},"offerLastSyncedAt":{"format":"date-time","type":"string"},"queryMatch":{"$ref":"#/components/schemas/QueryMatch"},"slug":{"type":"string"},"sourceUrl":{"format":"uri","type":"string"},"specs":{"items":{"additionalProperties":false,"properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"],"type":"object"},"type":"array"},"storeCount":{"minimum":0,"type":"integer"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","slug","name","sourceUrl","offerCount"],"type":"object"},"ProductResult":{"additionalProperties":false,"properties":{"evidenceScope":{"const":"storefront_observation_not_independent_retailer_verification"},"locale":{"type":"string"},"offers":{"items":{"$ref":"#/components/schemas/Offer"},"type":"array"},"product":{"$ref":"#/components/schemas/Product"},"quotedOfferId":{"type":"string"},"requestedCountry":{"type":"string"},"requestedCurrency":{"type":"string"},"selectedVariant":{"$ref":"#/components/schemas/VariantOption"},"site":{"enum":["chexlow","housnap"],"type":"string"},"sourceEvidence":{"$ref":"#/components/schemas/SourceEvidence"},"variantOptions":{"items":{"$ref":"#/components/schemas/VariantOption"},"type":"array"}},"required":["site","locale","product","offers","sourceEvidence","evidenceScope"],"type":"object"},"QueryMatch":{"additionalProperties":false,"description":"Literal normalized term presence in the returned public name and brand only. phrasePresentInName separately reports the contiguous normalized query sequence in the name, not words scattered across a different generation and a pack quantity. Neither all terms nor a present phrase verifies the model, product type, selected size, suitability or authenticity; an accessory may contain the whole phrase. Partial and no-term candidates are not filtered out. Absent for wildcard/browse or queries without textual terms. Aliases, translations and punctuation-joined model codes may require separate identity verification.","properties":{"basis":{"const":"normalized_name_and_brand"},"coverage":{"enum":["all","partial","none"],"type":"string"},"identityVerified":{"const":false},"matchedTerms":{"items":{"type":"string"},"type":"array"},"phrasePresentInName":{"type":"boolean"},"unmatchedTerms":{"items":{"type":"string"},"type":"array"}},"required":["basis","coverage","matchedTerms","unmatchedTerms","phrasePresentInName","identityVerified"],"type":"object"},"SearchResult":{"additionalProperties":false,"properties":{"countryFilterApplied":{"type":"boolean"},"facets":{"additionalProperties":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":0,"type":"integer"},"value":{"type":"string"}},"required":["value","count"],"type":"object"},"type":"array"},"description":"Requested filter buckets keyed by the corresponding input name.","type":"object"},"locale":{"type":"string"},"pagination":{"additionalProperties":false,"properties":{"page":{"maximum":100,"minimum":1,"type":"integer"},"perPage":{"maximum":50,"minimum":1,"type":"integer"},"total":{"minimum":0,"type":"integer"}},"required":["page","perPage","total"],"type":"object"},"products":{"items":{"$ref":"#/components/schemas/Product"},"type":"array"},"requestedCountry":{"type":"string"},"requestedCurrency":{"type":"string"},"site":{"enum":["chexlow","housnap"],"type":"string"}},"required":["site","locale","products","pagination"],"type":"object"},"SourceEvidence":{"additionalProperties":false,"description":"Bounded untrusted merchant feed claims from accumulated product/merchant context, intersected with returned public offers. Not canonical specifications, independent testing, selected-variant validation or proof of phone fit. Suitability remains unassessed. Context dates describe material context, never price/stock freshness. omittedMerchantCount retains the upstream merchant-cap limitation even after offer selection; empty entries do not establish absence of a feature.","properties":{"entries":{"items":{"additionalProperties":false,"properties":{"contextFirstSeenAt":{"format":"date-time","type":"string"},"contextUpdatedAt":{"format":"date-time","type":"string"},"description":{"maxLength":4000,"minLength":1,"type":"string"},"features":{"items":{"maxLength":200,"minLength":1,"type":"string"},"maxItems":8,"type":"array"},"material":{"maxLength":200,"minLength":1,"type":"string"},"merchantId":{"minLength":1,"type":"string"},"merchantName":{"minLength":1,"type":"string"},"offerIds":{"items":{"minLength":1,"type":"string"},"minItems":1,"type":"array","uniqueItems":true},"truncated":{"type":"boolean"}},"required":["merchantId","merchantName","offerIds","contextFirstSeenAt","contextUpdatedAt","truncated"],"type":"object"},"maxItems":8,"type":"array"},"kind":{"const":"merchant_feed_claims"},"omittedMerchantCount":{"minimum":0,"type":"integer"},"scope":{"const":"product_merchant_accumulated_context"},"suitabilityAssessed":{"const":false}},"required":["kind","scope","suitabilityAssessed","entries","omittedMerchantCount"],"type":"object"},"Store":{"additionalProperties":false,"properties":{"activeOfferCount":{"minimum":0,"type":"integer"},"country":{"type":"string"},"id":{"type":"string"},"logoImageUrl":{"format":"uri","type":"string"},"name":{"type":"string"},"representativeProduct":{"$ref":"#/components/schemas/Product"},"shippingCountries":{"items":{"type":"string"},"type":"array"},"slug":{"type":"string"},"sourceUrl":{"format":"uri","type":"string"},"topCategories":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":0,"type":"integer"},"name":{"type":"string"},"path":{"type":"string"},"sourceUrl":{"format":"uri","type":"string"}},"required":["path","name","count","sourceUrl"],"type":"object"},"type":"array"}},"required":["slug","name","sourceUrl","shippingCountries","activeOfferCount","topCategories"],"type":"object"},"StoreDirectoryResult":{"additionalProperties":false,"properties":{"coverage":{"const":"public_directory_with_bounded_representative_candidates"},"locale":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Page"},"requestedCountry":{"type":"string"},"requestedCurrency":{"type":"string"},"site":{"enum":["chexlow","housnap"],"type":"string"},"stores":{"items":{"$ref":"#/components/schemas/Store"},"type":"array"}},"required":["site","locale","stores","pagination","coverage"],"type":"object"},"StoreResult":{"additionalProperties":false,"properties":{"coverage":{"additionalProperties":false,"properties":{"candidateLimit":{"const":250},"completeStoreInventory":{"const":false}},"required":["candidateLimit","completeStoreInventory"],"type":"object"},"locale":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Page"},"productPriceBasis":{"const":"tracked_product_offer_floor_usd_not_this_seller_quote"},"products":{"items":{"$ref":"#/components/schemas/Product"},"type":"array"},"requestedCountry":{"type":"string"},"requestedCurrency":{"type":"string"},"site":{"enum":["chexlow","housnap"],"type":"string"},"store":{"$ref":"#/components/schemas/Store"}},"required":["site","locale","store","products","pagination","coverage","productPriceBasis"],"type":"object"},"VariantOption":{"additionalProperties":false,"properties":{"availability":{"enum":["in_stock","out_of_stock"],"type":"string"},"key":{"type":"string"},"label":{"type":"string"},"minPriceUsd":{"minimum":0,"type":["number","null"]},"offerIds":{"items":{"type":"string"},"type":"array"},"size":{"type":"string"},"sizeSystem":{"type":["string","null"]}},"required":["key","label","sizeSystem","size","minPriceUsd","availability","offerIds"],"type":"object"}},"securitySchemes":{"catalogOAuth":{"flows":{"authorizationCode":{"authorizationUrl":"https://housnap.com/oauth/authorize","scopes":{"catalog:read":"Read the public catalog only"},"tokenUrl":"https://housnap.com/oauth/token"}},"type":"oauth2"}}},"info":{"description":"Read-only public price-comparison catalog. Anonymous access or delegated catalog:read access. Currency is a preference, never a request to relabel source prices. No retailer click, raw feed, account, admin, checkout or payment operation is exposed.","title":"com.housnap/catalog","version":"1.4.0"},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","openapi":"3.1.0","paths":{"/agent-api/categories":{"get":{"description":"List categories actually served by this storefront's public comparison catalog.","operationId":"get_categories","parameters":[{"in":"query","name":"locale","required":false,"schema":{"default":"en","enum":["en","ko","ja","de","fr","es","it","pt","zh","nl"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryResult"}}},"description":"Live public catalog data. Monetary values retain their explicit source currency. Missing prices and freshness are omitted rather than inferred."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."}},"security":[{},{"catalogOAuth":["catalog:read"]}],"summary":"List categories actually served by this storefront's public comparison catalog."}},"/agent-api/guides":{"get":{"description":"Browse or literally search titles and summaries in the site's published guide index. Editorial advice is not a live price quote; read get_guide for the article and search products separately.","operationId":"search_guides","parameters":[{"in":"query","name":"locale","required":false,"schema":{"default":"en","enum":["en","ko","ja","de","fr","es","it","pt","zh","nl"],"type":"string"}},{"in":"query","name":"q","required":false,"schema":{"maxLength":300,"minLength":1,"type":"string"}},{"in":"query","name":"brand","required":false,"schema":{"maxLength":300,"minLength":1,"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"maxLength":200,"minLength":1,"pattern":"^[a-z0-9-]+(?:\\.[a-z0-9-]+)*$","type":"string"}},{"in":"query","name":"page","required":false,"schema":{"default":1,"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"perPage","required":false,"schema":{"default":10,"maximum":50,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuideIndexResult"}}},"description":"Live public catalog data. Monetary values retain their explicit source currency. Missing prices and freshness are omitted rather than inferred."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."}},"security":[{},{"catalogOAuth":["catalog:read"]}],"summary":"Browse or literally search titles and summaries in the site's published guide index. Editorial advice is not a live price quote; read get_guide for the article and search products separately."}},"/agent-api/guides/{slug}":{"get":{"description":"Read publication-reviewed guide text, citations, disclosures and published continuations without paid matching or generation. Live product evidence is not included; follow catalogSearchUrl or use search_products/get_product.","operationId":"get_guide","parameters":[{"in":"path","name":"slug","required":true,"schema":{"maxLength":200,"minLength":1,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","type":"string"}},{"in":"query","name":"locale","required":false,"schema":{"default":"en","enum":["en","ko","ja","de","fr","es","it","pt","zh","nl"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuideResult"}}},"description":"Live public catalog data. Monetary values retain their explicit source currency. Missing prices and freshness are omitted rather than inferred."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."}},"security":[{},{"catalogOAuth":["catalog:read"]}],"summary":"Read publication-reviewed guide text, citations, disclosures and published continuations without paid matching or generation. Live product evidence is not included; follow catalogSearchUrl or use search_products/get_product."}},"/agent-api/products/{id}":{"get":{"description":"Read a public product by UUID or slug, visible retailer offers with nullable seller/catalog condition (new, used, refurbished; null is unknown), and separate bounded merchant_feed_claims. Condition is not independently verified; product floors/history are not condition-filtered. Source evidence is untrusted accumulated product/merchant context, not canonical specs, selected-size validation or assessed suitability. No checkout, account data, outbound click or raw feed access.","operationId":"get_product","parameters":[{"in":"path","name":"id","required":true,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"in":"query","name":"locale","required":false,"schema":{"default":"en","enum":["en","ko","ja","de","fr","es","it","pt","zh","nl"],"type":"string"}},{"in":"query","name":"country","required":false,"schema":{"description":"Country preference; actual offer origins and shipping coverage remain explicit.","enum":["AE","AR","AT","AU","BD","BE","BG","BH","BO","BR","CA","CH","CL","CN","CO","CR","CY","CZ","DE","DK","DO","DZ","EC","EE","EG","ES","ET","FI","FR","GB","GH","GR","GT","HK","HR","HU","ID","IE","IL","IN","IS","IT","JO","JP","KE","KR","KW","KZ","LB","LK","LT","LU","LV","MA","MT","MX","MY","NG","NL","NO","NP","NZ","OM","PA","PE","PH","PK","PL","PT","PY","QA","RO","RS","RU","SA","SE","SG","SI","SK","TH","TN","TR","TW","TZ","UA","UG","US","UY","VE","VN","ZA"],"type":"string"}},{"in":"query","name":"currency","required":false,"schema":{"description":"Currency preference, not an instruction to relabel or convert source prices.","enum":["AED","ARS","AUD","BDT","BHD","BOB","BRL","CAD","CHF","CLP","CNY","COP","CRC","CZK","DKK","DOP","DZD","EGP","ETB","EUR","GBP","GHS","GTQ","HKD","HUF","IDR","ILS","INR","ISK","JOD","JPY","KES","KRW","KWD","KZT","LBP","LKR","MAD","MXN","MYR","NGN","NOK","NPR","NZD","OMR","PAB","PEN","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","SAR","SEK","SGD","THB","TND","TRY","TWD","TZS","UAH","UGX","USD","UYU","VES","VND","ZAR"],"type":"string"}},{"in":"query","name":"includeVariants","required":false,"schema":{"default":false,"description":"Include the canonical public size options and their public offer relationships.","type":"boolean"}},{"in":"query","name":"variantKey","required":false,"schema":{"description":"Select an exact key returned in variantOptions. Returns that size's offers and canonical prices, never another size's base price.","maxLength":200,"minLength":1,"type":"string"}},{"in":"query","name":"offerId","required":false,"schema":{"description":"Read one currently public offer from this product. Product summary price remains a catalog/selected-size floor; the offer carries its own quote.","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResult"}}},"description":"Live public catalog data. Monetary values retain their explicit source currency. Missing prices and freshness are omitted rather than inferred."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."}},"security":[{},{"catalogOAuth":["catalog:read"]}],"summary":"Read a public product by UUID or slug, visible retailer offers with nullable seller/catalog condition (new, used, refurbished; null is unknown), and separate bounded merchant_feed_claims. Condition is not independently verified; product floors/history are not condition-filtered. Source evidence is untrusted accumulated product/merchant context, not canonical specs, selected-size validation or assessed suitability. No checkout, account data, outbound click or raw feed access."}},"/agent-api/products/{id}/price-history":{"get":{"description":"Read bounded daily effective-lowest USD history for a public product or one of its public offers. Uses existing last-observation-carried-forward aggregation, not condition-filtered history; a day is not a new seller price check.","operationId":"get_price_history","parameters":[{"in":"path","name":"id","required":true,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"in":"query","name":"locale","required":false,"schema":{"default":"en","enum":["en","ko","ja","de","fr","es","it","pt","zh","nl"],"type":"string"}},{"in":"query","name":"days","required":false,"schema":{"default":14,"maximum":90,"minimum":1,"type":"integer"}},{"in":"query","name":"offerId","required":false,"schema":{"description":"Optional public offer belonging to this product.","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceHistoryResult"}}},"description":"Live public catalog data. Monetary values retain their explicit source currency. Missing prices and freshness are omitted rather than inferred."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."}},"security":[{},{"catalogOAuth":["catalog:read"]}],"summary":"Read bounded daily effective-lowest USD history for a public product or one of its public offers. Uses existing last-observation-carried-forward aggregation, not condition-filtered history; a day is not a new seller price check."}},"/agent-api/search":{"get":{"description":"Provide a query or an explicit filter or sort. queryMatch reports literal name/brand term coverage, never verified model identity; partial/none candidates remain visible. Price bounds use USD major units. Country preference may fall back; it is not a shipping guarantee. Facets use the corresponding tool input names.","operationId":"search_products","parameters":[{"in":"query","name":"q","required":false,"schema":{"maxLength":300,"minLength":1,"type":"string"}},{"in":"query","name":"locale","required":false,"schema":{"default":"en","enum":["en","ko","ja","de","fr","es","it","pt","zh","nl"],"type":"string"}},{"in":"query","name":"country","required":false,"schema":{"description":"Country preference; actual offer origins and shipping coverage remain explicit.","enum":["AE","AR","AT","AU","BD","BE","BG","BH","BO","BR","CA","CH","CL","CN","CO","CR","CY","CZ","DE","DK","DO","DZ","EC","EE","EG","ES","ET","FI","FR","GB","GH","GR","GT","HK","HR","HU","ID","IE","IL","IN","IS","IT","JO","JP","KE","KR","KW","KZ","LB","LK","LT","LU","LV","MA","MT","MX","MY","NG","NL","NO","NP","NZ","OM","PA","PE","PH","PK","PL","PT","PY","QA","RO","RS","RU","SA","SE","SG","SI","SK","TH","TN","TR","TW","TZ","UA","UG","US","UY","VE","VN","ZA"],"type":"string"}},{"in":"query","name":"currency","required":false,"schema":{"description":"Currency preference, not an instruction to relabel or convert source prices.","enum":["AED","ARS","AUD","BDT","BHD","BOB","BRL","CAD","CHF","CLP","CNY","COP","CRC","CZK","DKK","DOP","DZD","EGP","ETB","EUR","GBP","GHS","GTQ","HKD","HUF","IDR","ILS","INR","ISK","JOD","JPY","KES","KRW","KWD","KZT","LBP","LKR","MAD","MXN","MYR","NGN","NOK","NPR","NZD","OMR","PAB","PEN","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","SAR","SEK","SGD","THB","TND","TRY","TWD","TZS","UAH","UGX","USD","UYU","VES","VND","ZAR"],"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"maxLength":200,"minLength":1,"pattern":"^[a-z0-9-]+(?:\\.[a-z0-9-]+)*$","type":"string"}},{"in":"query","name":"brand","required":false,"schema":{"description":"Comma-separated values (OR within this filter). Request includeFacets to discover available values.","maxLength":300,"minLength":1,"type":"string"}},{"in":"query","name":"color","required":false,"schema":{"description":"Comma-separated values (OR within this filter). Request includeFacets to discover available values.","maxLength":300,"minLength":1,"type":"string"}},{"in":"query","name":"size","required":false,"schema":{"description":"Comma-separated values (OR within this filter). Request includeFacets to discover available values.","maxLength":300,"minLength":1,"type":"string"}},{"in":"query","name":"material","required":false,"schema":{"description":"Comma-separated values (OR within this filter). Request includeFacets to discover available values.","maxLength":300,"minLength":1,"type":"string"}},{"in":"query","name":"pattern","required":false,"schema":{"description":"Comma-separated values (OR within this filter). Request includeFacets to discover available values.","maxLength":300,"minLength":1,"type":"string"}},{"in":"query","name":"gender","required":false,"schema":{"description":"Comma-separated values (OR within this filter). Request includeFacets to discover available values.","maxLength":300,"minLength":1,"type":"string"}},{"in":"query","name":"attribute","required":false,"schema":{"description":"Comma-separated category attribute tokens, such as sleeve:long,fit:slim. Discover tokens with includeFacets.","maxLength":300,"minLength":1,"type":"string"}},{"in":"query","name":"minPrice","required":false,"schema":{"description":"Inclusive minimum catalog price in USD major units.","minimum":0,"type":"number"}},{"in":"query","name":"maxPrice","required":false,"schema":{"description":"Inclusive maximum catalog price in USD major units; not a delivered total.","minimum":0,"type":"number"}},{"in":"query","name":"minCapacity","required":false,"schema":{"description":"Minimum capacity in liters.","minimum":0,"type":"number"}},{"in":"query","name":"maxCapacity","required":false,"schema":{"description":"Maximum capacity in liters.","minimum":0,"type":"number"}},{"in":"query","name":"minDimension","required":false,"schema":{"description":"Minimum longest dimension in centimeters.","minimum":0,"type":"number"}},{"in":"query","name":"maxDimension","required":false,"schema":{"description":"Maximum longest dimension in centimeters.","minimum":0,"type":"number"}},{"in":"query","name":"hasSale","required":false,"schema":{"description":"Filter by a valid sale price.","type":"boolean"}},{"in":"query","name":"sort","required":false,"schema":{"description":"Reuse storefront ranking: price and newest sorting retain the multi-store comparison tier.","enum":["relevance","popularity","price_asc","price_desc","newest"],"type":"string"}},{"in":"query","name":"includeFacets","required":false,"schema":{"default":false,"description":"Return available public filter values and counts under their tool input names.","type":"boolean"}},{"in":"query","name":"page","required":false,"schema":{"default":1,"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"perPage","required":false,"schema":{"default":10,"maximum":50,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"Live public catalog data. Monetary values retain their explicit source currency. Missing prices and freshness are omitted rather than inferred."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."}},"security":[{},{"catalogOAuth":["catalog:read"]}],"summary":"Search public products by query or explicit filters. queryMatch reports literal name/brand terms and whether the query phrase occurs in the name, not verified model identity; partial/none candidates remain visible and even a whole phrase can describe an accessory. Inspect product details and variants. Price bounds are USD major units, not converted source prices or delivered totals. Country is a preference and can fall back; inspect offer shipping evidence. Does not purchase or follow retailer links."}},"/agent-api/stores":{"get":{"description":"Browse the public store directory, with declared origins, shipping coverage and store hub URLs. Offer counts are not a complete per-store product inventory.","operationId":"list_stores","parameters":[{"in":"query","name":"locale","required":false,"schema":{"default":"en","enum":["en","ko","ja","de","fr","es","it","pt","zh","nl"],"type":"string"}},{"in":"query","name":"q","required":false,"schema":{"maxLength":300,"minLength":1,"type":"string"}},{"in":"query","name":"page","required":false,"schema":{"default":1,"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"perPage","required":false,"schema":{"default":10,"maximum":50,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreDirectoryResult"}}},"description":"Live public catalog data. Monetary values retain their explicit source currency. Missing prices and freshness are omitted rather than inferred."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."}},"security":[{},{"catalogOAuth":["catalog:read"]}],"summary":"Browse the public store directory, with declared origins, shipping coverage and store hub URLs. Offer counts are not a complete per-store product inventory."}},"/agent-api/stores/{slug}":{"get":{"description":"Read a public store hub and its bounded eligible product candidates. Keep category and store scope together. Product price floors are catalog-wide, not necessarily this seller's price; get_product provides the seller evidence.","operationId":"get_store","parameters":[{"in":"path","name":"slug","required":true,"schema":{"maxLength":200,"minLength":1,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","type":"string"}},{"in":"query","name":"locale","required":false,"schema":{"default":"en","enum":["en","ko","ja","de","fr","es","it","pt","zh","nl"],"type":"string"}},{"in":"query","name":"country","required":false,"schema":{"description":"Country preference; actual offer origins and shipping coverage remain explicit.","enum":["AE","AR","AT","AU","BD","BE","BG","BH","BO","BR","CA","CH","CL","CN","CO","CR","CY","CZ","DE","DK","DO","DZ","EC","EE","EG","ES","ET","FI","FR","GB","GH","GR","GT","HK","HR","HU","ID","IE","IL","IN","IS","IT","JO","JP","KE","KR","KW","KZ","LB","LK","LT","LU","LV","MA","MT","MX","MY","NG","NL","NO","NP","NZ","OM","PA","PE","PH","PK","PL","PT","PY","QA","RO","RS","RU","SA","SE","SG","SI","SK","TH","TN","TR","TW","TZ","UA","UG","US","UY","VE","VN","ZA"],"type":"string"}},{"in":"query","name":"currency","required":false,"schema":{"description":"Currency preference, not an instruction to relabel or convert source prices.","enum":["AED","ARS","AUD","BDT","BHD","BOB","BRL","CAD","CHF","CLP","CNY","COP","CRC","CZK","DKK","DOP","DZD","EGP","ETB","EUR","GBP","GHS","GTQ","HKD","HUF","IDR","ILS","INR","ISK","JOD","JPY","KES","KRW","KWD","KZT","LBP","LKR","MAD","MXN","MYR","NGN","NOK","NPR","NZD","OMR","PAB","PEN","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","SAR","SEK","SGD","THB","TND","TRY","TWD","TZS","UAH","UGX","USD","UYU","VES","VND","ZAR"],"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"maxLength":200,"minLength":1,"pattern":"^[a-z0-9-]+(?:\\.[a-z0-9-]+)*$","type":"string"}},{"in":"query","name":"sort","required":false,"schema":{"enum":["relevance","popularity","price_asc","price_desc","newest"],"type":"string"}},{"in":"query","name":"page","required":false,"schema":{"default":1,"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"perPage","required":false,"schema":{"default":10,"maximum":50,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreResult"}}},"description":"Live public catalog data. Monetary values retain their explicit source currency. Missing prices and freshness are omitted rather than inferred."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request failed. Invalid supplied bearer tokens are rejected even though anonymous catalog reads are allowed. Upstream errors retain their HTTP status; no synthetic empty success is returned."}},"security":[{},{"catalogOAuth":["catalog:read"]}],"summary":"Read a public store hub and its bounded eligible product candidates. Keep category and store scope together. Product price floors are catalog-wide, not necessarily this seller's price; get_product provides the seller evidence."}}},"servers":[{"url":"https://housnap.com"}]}