OceanSphere Engines - marine equipment library

Search the OceanSphere equipment library (marine engines, auxiliaries, pumps, deck machinery, navigation and electrical equipment) by model designation, equipment type or keywords; optionally filter by manufacturer, ship_area or category. Returns at most 8 models (no paging) with manufacturer, designation, category, ship area, the number of source-referenced characteristics, a model_ref and the library page URL. Models without stored values are flagged 'no stored values'. Results with stored values come first. The library identifies equipment; it is not a parts shop - OceanSphere does not list stock. Use model_ref with get_equipment_model.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Model designation, equipment type or keywords, e.g. 'S50ME-C' or 'fuel injection pump'.",
      "maxLength": 120,
      "minLength": 2,
      "title": "Query",
      "type": "string"
    },
    "manufacturer": {
      "anyOf": [
        {
          "maxLength": 120,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional manufacturer filter, e.g. 'MAN Energy Solutions'.",
      "title": "Manufacturer"
    },
    "ship_area": {
      "anyOf": [
        {
          "maxLength": 30,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ship area slug from list_ship_areas: engine_room, deck, electrical, navigation, safety, cargo, hvac.",
      "title": "Ship Area"
    },
    "category": {
      "anyOf": [
        {
          "maxLength": 80,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Category name from list_categories, e.g. 'Radar & ECDIS'.",
      "title": "Category"
    },
    "limit": {
      "default": 5,
      "description": "Maximum number of results; values above 8 are capped at 8.",
      "maximum": 1000,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_equipment_modelsArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "search_equipment_modelsDictOutput"
}

Get one library model (model_ref from a search, or manufacturer + exact designation): category, ship area, page URL, manufacturer datasheet link if any, and the stored technical characteristics. Each value has source_document (label of the catalogue/datasheet it was extracted from; may cover a model series) and source_page. Values were extracted automatically and are not individually reviewed. If there are no stored values the response says so explicitly; never guess specifications in that case. OceanSphere does not hold stock.

{
  "type": "object",
  "properties": {
    "model_ref": {
      "anyOf": [
        {
          "maxLength": 40,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "model_ref returned by search_equipment_models or find_by_manufacturer.",
      "title": "Model Ref"
    },
    "manufacturer": {
      "anyOf": [
        {
          "maxLength": 120,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Alternative to model_ref: manufacturer (together with designation).",
      "title": "Manufacturer"
    },
    "designation": {
      "anyOf": [
        {
          "maxLength": 160,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Alternative to model_ref: exact model designation (together with manufacturer).",
      "title": "Designation"
    }
  },
  "title": "get_equipment_modelArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_equipment_modelDictOutput"
}

List models of one manufacturer, best-documented first, at most 8 per call and no paging (total_matches shows the size). Narrow with category or ship_area, or use search_equipment_models with a designation to reach a specific model.

{
  "type": "object",
  "properties": {
    "manufacturer": {
      "description": "Manufacturer name, e.g. 'Alfa Laval'.",
      "maxLength": 120,
      "minLength": 2,
      "title": "Manufacturer",
      "type": "string"
    },
    "category": {
      "anyOf": [
        {
          "maxLength": 80,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Category name from list_categories, e.g. 'Radar & ECDIS'.",
      "title": "Category"
    },
    "ship_area": {
      "anyOf": [
        {
          "maxLength": 30,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ship area slug from list_ship_areas: engine_room, deck, electrical, navigation, safety, cargo, hvac.",
      "title": "Ship Area"
    },
    "limit": {
      "default": 5,
      "description": "Maximum number of results; values above 8 are capped at 8.",
      "maximum": 1000,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "manufacturer"
  ],
  "title": "find_by_manufacturerArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "find_by_manufacturerDictOutput"
}

List the ship areas of the library (engine room, deck, electrical, navigation, safety, cargo, HVAC) with model counts.

{
  "type": "object",
  "properties": {},
  "title": "list_ship_areasArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "list_ship_areasDictOutput"
}

List the equipment categories with model counts, optionally for one ship_area. Use the names as category filter.

{
  "type": "object",
  "properties": {
    "ship_area": {
      "anyOf": [
        {
          "maxLength": 30,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ship area slug from list_ship_areas: engine_room, deck, electrical, navigation, safety, cargo, hvac.",
      "title": "Ship Area"
    }
  },
  "title": "list_categoriesArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "list_categoriesDictOutput"
}