Sosoft Beds Product And Content API

Public machine-readable product catalogue, category index, content page index, blog context, search, OpenAPI schema and LLM discovery files for Sosoft Beds.

https://api.sosoftbeds.co.uk

Discovery

Core Endpoints

GET /api/products
GET /api/products?page=2
GET /api/products/{slug}
GET /api/products/{slug}?view=compact
GET /api/products/{slug}?view=options
GET /api/offers?q=pink+king+ottoman+with+a+mattress+under+1000
GET /api/offers?product=ottoman-bed-side-opening-gas-lift-bed&limit=10
GET /api/offers/{id}
GET /api/merchant-sources
GET /api/products/{slug}/price?values=134102,134103
POST /api/products/{slug}/price
GET /api/categories
GET /api/categories/{slug}
GET /api/search?q=ottoman
GET /api/search?q=king+size+ottoman+beds+under+500
GET /api/content-pages
GET /api/content-pages/{slug}

Product Payload Includes

SKU, URL slug, name, brand, descriptions, pricing, stock status, categories, breadcrumbs, full image gallery, custom options, nested option values, product tabs, dimensions, FAQs, related products, semantic fields and Product JSON-LD.

Start with ?view=compact for concise facts. Fetch ?view=options for raw choices and dependency rules. The default full view remains available. Markdown is supported for full and compact views using Accept: text/markdown.

Natural-Language Search

The search endpoint understands common shopping intent, including size phrases and price constraints such as king size ottoman beds under 500.

Budget filters use the listed base price, not a confirmed price for the requested size or complete configuration. Read price_basis on responses.

Option Price Estimates

Use /api/products/{slug}/price to estimate explicit selected adjustments. Version 1.1 returns estimated_price instead of final_price. Check configuration_status, missing_required_options and warnings. Unselected defaults, quantity rules, tax, discounts and delivery may affect checkout pricing. Invalid or incompatible selections return HTTP 422 without a price; malformed requests return HTTP 400.

GET /api/products/ottoman-bed-side-opening-gas-lift-bed/price?values=109096

POST /api/products/ottoman-bed-side-opening-gas-lift-bed/price
{
  "selected_options": [
    { "option_id": 7453, "value_id": 109096 }
  ]
}

Published Merchant Offers

/api/offers serves 15032 saved offers from six published Merchant XML feeds. Filter actual offer prices using min_price/max_price, not the parent starting price. Search supports size phrases, colours, with/without a mattress and under/above budgets. Explicit filters include product (slug), source, size, colour, material, headboard, lift, base_height, storage_depth, includes_mattress and availability.

Use page, limit (1-50), and sort=id|price_asc|price_desc. Follow next_page until null. Each offer preserves its Merchant ID, images and exact storefront configuration link. JSON only. Invalid filters return HTTP 400.

Prices and availability come from saved Merchant XML, not a live checkout check. Feed file dates are not native price-verification dates. Confirm current price, availability, delivery and terms on the configured storefront page. See source provenance. Records without an embedded parent omit a working parent API link; legacy entries without selections are labelled listed_product. No claim of Google approval is made.

Content Payload Includes

CMS pages and blog posts with canonical URL, title, meta description, H1, headings, cleaned HTML, clean text, links, word count and generated timestamp.