1StopBedrooms

Get Categories List

Retrieves furniture categories available in the system Use this tool whenever the user asks to find certain furnuture type. You will need category slug in order to access furniture catalogue. Categories response contain category tree, not linear list. Each catecury could have subcategories. Unroll category tree if you need plain category list. Use second level categories unless you have clear instructions to work with whole category tree

Get Category

Retrieves category page information by category slug. Use this tool when the user asks about a specific category, its subcategories, breadcrumbs, SEO data, or related category metadata.

Get Category Products

Retrieves products from a category. Control "top N" with request.perPage and request.page. Use request.perPage as PER_PAGE_36, PER_PAGE_48, or PER_PAGE_72; use request.sortBy for ordering.

Get Product Data

Retrieves product details by slug or web ID. Set lookupBySlug or lookupByWebId to choose the lookup path.

Get Products Filtered

Retrieves and filters products inside a known category slug. Use this when the user is browsing a category and asks for constraints such as price, color, brand, style, material, size, or other attributes. The slug must be a real category slug. If the user gives only a category name, first use GetCategoriesList or GetCategory to find/confirm the correct slug. When filters are requested, use this two-step workflow: 1. Call this tool with the slug and no guessed facets to inspect filtersBlock

Search

Searches products from a user's natural-language request. Variables: - text: Core product search keywords. - zipcode: Optional delivery-location ZIP code. - request: Optional catalogSearchFilterInput with this shape: { sortBy: catalogSearchFilterSort, perPage: catalogSearchResultItemPerPage, page: Int, facet: [{attributeCode: String, value: [String]}] } Allowed request.sortBy values: - RELEVANCE: Most relevant products first. - PRICE_FROM_LOW: Lowest price first.