Mamanida Maternity Catalogue

Search Mamanida's maternity and nursing clothing catalogue for one storefront. Returns only products a visitor of that storefront can actually see, with the retailer's authoritative price, the storefront's displayed price (marked when it is an approximate conversion), availability and the commercial state of the outbound link. Links returned are canonical Mamanida product URLs; retailer and affiliate URLs are never exposed.

{
  "type": "object",
  "properties": {
    "storefront": {
      "type": "string",
      "enum": [
        "int",
        "us",
        "se",
        "dk",
        "fi",
        "no",
        "fr",
        "de",
        "nl",
        "es"
      ],
      "description": "Required storefront id, e.g. 'int' (English), 'se', 'dk', 'no', 'fi', 'us'."
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "default": "",
      "description": "Free-text query, max 100 characters."
    },
    "category": {
      "type": "string",
      "maxLength": 60,
      "description": "Category slug, e.g. 'dresses'."
    },
    "brand": {
      "type": "string",
      "maxLength": 80,
      "description": "Exact brand name filter."
    },
    "on_sale": {
      "type": "boolean",
      "default": false,
      "description": "Only products currently discounted."
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "newest",
        "price_asc",
        "price_desc",
        "discount",
        "rating",
        "name"
      ],
      "default": "relevance"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 24,
      "default": 12
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000,
      "default": 0
    }
  },
  "required": [
    "storefront"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch full public details for one Mamanida product on a specific storefront: localized summary, fabric and bump-panel facts, sizes, colours, availability (IN_STOCK / OUT_OF_STOCK / UNKNOWN), the retailer's authoritative price plus the storefront's displayed price, and whether the outbound link is AFFILIATE, DIRECT or BLOCKED. Only the canonical Mamanida URL is returned.

{
  "type": "object",
  "properties": {
    "storefront": {
      "type": "string",
      "enum": [
        "int",
        "us",
        "se",
        "dk",
        "fi",
        "no",
        "fr",
        "de",
        "nl",
        "es"
      ],
      "description": "Required storefront id, e.g. 'int', 'se', 'dk', 'no', 'fi', 'us'."
    },
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "description": "Product slug as it appears in the Mamanida product URL."
    }
  },
  "required": [
    "storefront",
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Compare 2-10 Mamanida products on one storefront. Each product is returned with the same public contract as get_product (localized details, availability, retailer-authoritative and displayed prices, AFFILIATE / DIRECT / BLOCKED commercial state and its canonical Mamanida URL), so prices and availability are directly comparable within that storefront.

{
  "type": "object",
  "properties": {
    "storefront": {
      "type": "string",
      "enum": [
        "int",
        "us",
        "se",
        "dk",
        "fi",
        "no",
        "fr",
        "de",
        "nl",
        "es"
      ],
      "description": "Required storefront id, e.g. 'int', 'se', 'dk', 'no', 'fi', 'us'."
    },
    "slugs": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 160
      },
      "minItems": 2,
      "maxItems": 10,
      "description": "Between 2 and 10 product slugs."
    }
  },
  "required": [
    "storefront",
    "slugs"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the canonical product categories available on one Mamanida storefront. Each entry gives the exact `slug` to pass to search_products, a label in the storefront's language, any existing localized aliases, and the number of products currently visible on that storefront. Only categories with at least one visible product are returned, and the order is Mamanida's own category order (never product counts).

{
  "type": "object",
  "properties": {
    "storefront": {
      "type": "string",
      "enum": [
        "int",
        "us",
        "se",
        "dk",
        "fi",
        "no",
        "fr",
        "de",
        "nl",
        "es"
      ],
      "description": "Required storefront id, e.g. 'int' (English), 'se', 'dk', 'no', 'fi', 'us'."
    }
  },
  "required": [
    "storefront"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Mamanida's editorial buying guides for one storefront, in that storefront's own language. Called without `guide` it lists the published guides (metadata only: title, deck, meta description, pillar, topics, dates and the canonical Mamanida URL), optionally filtered by `topic`. Called with `guide` (the guide slug from the listing) it returns that one localized edition plus its structured body: paragraphs, headings, lists, comparison tables, callouts, links to other guides and category calls-to-action. A `category_cta` gives a `category_slug` you can pass straight to search_products, which is the intended guide → category → product path. Retailer and affiliate URLs are never returned.

{
  "type": "object",
  "properties": {
    "storefront": {
      "type": "string",
      "enum": [
        "int",
        "us",
        "se",
        "dk",
        "fi",
        "no",
        "fr",
        "de",
        "nl",
        "es"
      ],
      "description": "Required storefront id, e.g. 'int' (English), 'se', 'dk', 'no', 'fi', 'us'."
    },
    "guide": {
      "type": "string",
      "maxLength": 120,
      "description": "Guide slug as it appears in the Mamanida guide URL. Omit to list guides."
    },
    "topic": {
      "type": "string",
      "maxLength": 60,
      "description": "Authoritative topic id, e.g. 'maternity-jeans'. Filters the listing."
    }
  },
  "required": [
    "storefront"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}