Melorra Product API

openapi: 3.2.0
info:
  title: Melorra Catalog Product API
  version: 1.0.0
  summary: Read-only access to Melorra's jewellery catalogue and seasonal collections.
  description: Public, read-only JSON API behind www.melorra.com. No authentication is required. Filter values are matched exactly and are case-sensitive (for example wear_type=Rings and type=Gold, but gender=women). List responses are paginated 20 items per page; follow the `next` URL to page through results. Prices are in INR. Product page URLs are relative to https://www.melorra.com and product image paths are relative to the response's base_image_path.
  contact:
    name: Melorra
    url: https://www.melorra.com/contactus/
servers:
- url: https://services-catalog.melorra.com/api
security: []
tags:
- name: Product
paths:
  /product/products/:
    get:
      operationId: listProducts
      summary: List and filter products
      description: Returns active products. Combine filters to narrow results; there is no free-text search parameter.
      parameters:
      - $ref: '#/components/parameters/page'
      - name: wear_type
        in: query
        description: Jewellery type (case-sensitive).
        schema:
          type: string
          enum:
          - Earrings
          - Rings
          - Pendants
          - Necklaces
          - Bracelets
          - Bangles
          - Chains
          - Nose Pins
          - Waist Chains
          - Charms
          - Coins
      - name: type
        in: query
        description: Primary material (case-sensitive).
        schema:
          type: string
          enum:
          - Gold
          - Diamond
          - Gemstone
      - name: gender
        in: query
        description: Target gender (lowercase).
        schema:
          type: string
          enum:
          - women
          - men
          - unisex
      - name: trend
        in: query
        description: Collection trend name, exactly as it appears on products, e.g. `Classics`.
        schema:
          type: string
      - name: set_name
        in: query
        description: Product set name, e.g. `Sea Shell`.
        schema:
          type: string
      - name: nav_menu
        in: query
        description: Sub-category, e.g. `Round Bangles`, `Studs`, `Hoops`.
        schema:
          type: string
      - name: special_price__range
        in: query
        description: Selling-price range in INR as `min__max` (two underscores), e.g. `10000__20000`.
        schema:
          type: string
          pattern: ^[0-9]+__[0-9]+$
        example: '10000__20000'
      - name: ordering
        in: query
        description: Sort order. Prefix with `-` for descending.
        schema:
          type: string
          enum:
          - special_price
          - -special_price
          - -trending_score
      responses:
        '200':
          description: A page of products.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductList'
      tags:
      - Product
  /product/products/{sku}/:
    get:
      operationId: getProduct
      summary: Get one product by SKU
      parameters:
      - name: sku
        in: path
        required: true
        description: Product SKU, e.g. 232428.
        schema:
          type: integer
      responses:
        '200':
          description: The product.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Product'
        '404':
          description: No active product with this SKU.
      tags:
      - Product
components:
  schemas:
    Currency:
      type: object
      properties:
        code:
          type: string
          example: INR
        symbol:
          type: string
    ProductList:
      type: object
      properties:
        count:
          type: integer
          description: Total matching products.
        next:
          type:
          - string
          - 'null'
          format: uri
          description: URL of the next page, or null on the last page.
        previous:
          type:
          - string
          - 'null'
          format: uri
        results:
          type: object
          properties:
            base_image_path:
              type: string
              format: uri
              description: Prefix for every path in a product's images.
            products:
              type: array
              items:
                $ref: '#/components/schemas/Product'
        currency:
          $ref: '#/components/schemas/Currency'
    Product:
      type: object
      properties:
        sku:
          type: integer
        product_title:
          type: string
        price:
          type: number
          description: List price (MRP) in INR.
        special_price:
          type: number
          description: Selling price in INR.
        discount_message:
          type: string
        wear_type:
          type: string
        type:
          type: string
        category_name:
          type: string
        nav_menu:
          type: string
        trend:
          type: string
        set_name:
          type: string
        melorraProductUrl:
          type: string
          description: Product page path, relative to https://www.melorra.com.
        images:
          type: object
          properties:
            product_images:
              type: array
              items:
                type: string
              description: Image paths, relative to base_image_path.
        status:
          type: boolean
  parameters:
    page:
      name: page
      in: query
      description: 1-based page number (20 items per page).
      schema:
        type: integer
        minimum: 1
        default: 1
externalDocs:
  description: Agent guide to browsing the Melorra catalogue
  url: https://www.melorra.com/.well-known/agent-skills/melorra-catalog/SKILL.md
x-provenance:
  method: harvested
  publisher: Melorra
  source: https://www.melorra.com/api-docs/catalog-openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)