DOME Developer API

Public REST API — 165 Australian mattress products across 16 retailers. No authentication required. JSON responses. OpenAPI 3.1 specification available. Supports webhooks, affiliate link distribution, and real-time price data.

FREE   No API key required  ·  FREEMIUM tiers available for high-volume  ·  api@ml-nightworx.io

REST API Endpoints

GET/api/productsSearch & filter 165 mattresses — price, size, firmness, material, brand
GET/api/search?q=Natural language text search across title and description
GET/api/retailersList all 16 indexed retailers with product counts and affiliate domains
GET/api/products.jsonldFull catalog as schema.org JSON-LD ItemList for AI crawlers
GET/api/openapi.yamlOpenAPI 3.1 specification — compatible with GPT plugins, MCP, UCP
GET/healthHealth check — returns product count and uptime

Quick Start — curl Examples

# Search queen mattresses under $1,500 AUD
curl "https://dome.ml-nightworx.io/api/products?size=queen&max_price=1500"

# Text search — memory foam mattresses
curl "https://dome.ml-nightworx.io/api/search?q=memory+foam"

# List all retailers with product counts
curl "https://dome.ml-nightworx.io/api/retailers"

# Filter by brand + firmness range
curl "https://dome.ml-nightworx.io/api/products?brand=forty+winks&firmness_min=6&firmness_max=9"

# Paginate — page 2 (20 per page)
curl "https://dome.ml-nightworx.io/api/products?limit=20&offset=20"

# Full OpenAPI spec
curl "https://dome.ml-nightworx.io/api/openapi.yaml"

Response Format

{
  "total": 65,
  "count": 20,
  "offset": 0,
  "limit": 20,
  "products": [
    {
      "id": "PU0277633",
      "title": "Pure Slumber Comfort Plus Queen",
      "brand": "OZ Design Furniture",
      "price": 1599.00,
      "sale_price": 759.00,
      "currency": "AUD",
      "size": "Queen",
      "material": "hybrid",
      "firmness": 5,
      "cooling": 2,
      "sleep_positions": ["side", "back"],
      "tags": ["Hybrid", "Side Sleeper"],
      "image_url": "https://...",
      "affiliate_url": "https://ozdesignfurniture.com.au/...?ref=ml-ntwx",
      "availability": "in stock"
    }
  ]
}

Webhooks

Register a webhook to receive real-time notifications when new products are indexed or prices change. POST your endpoint URL to api@ml-nightworx.io with subject DOME webhook registration. Payloads are signed with HMAC-SHA256.

Pricing & Rate Limits

TierRate LimitPriceHow
Free100 req/day/IP$0No key, no payment needed
x402 Pay-per-call ⚡Unlimited0.001 USDC / requestHTTP 402 + X-Payment header (Base network)
EnterpriseUnlimited + webhooksContact usapi@ml-nightworx.io

x402 Agent-to-Agent Payments ⚡

DOME supports the x402 open payment protocol. AI agents can autonomously pay per query using USDC on Base — no API key, no subscription, no human in the loop.

Payment address: lv2pay.base.eth · 0x510cFb7439441b8854Da768B5331726AcEe5dC0a
Network: Base mainnet  ·  Asset: USDC  ·  Price: 0.001 USDC per request

# x402 flow — what an AI agent does:

# 1. Call the API normally
curl https://dome.ml-nightworx.io/api/products?size=queen
# → 402 Payment Required (after free tier)

# 2. Read the 402 response, sign USDC transfer on Base
# 3. Retry with payment proof
curl https://dome.ml-nightworx.io/api/products?size=queen \
  -H "X-Payment: <base64-signed-usdc-transfer>"
# → 200 OK + data + X-Payment-Response: accepted

Compatible with Coinbase CDP x402, x402.org facilitator, and any EIP-3009 USDC client on Base.

OpenAPI & Agent Compatibility

DOME API is compatible with GPT plugins, Claude MCP, UCP shopping spec, and any OpenAPI 3.1 client.

Contact

API support: api@ml-nightworx.io
Webhook registration, reseller/partner enquiries: partners@ml-nightworx.io
ML-NIGHTWORX · ml-nightworx.io