Xem Studio

Search the library of exact real-object geometry (fasteners, extrusion, sanitary fittings, electronics boards, phones and devices, motors, mounts, engine parts and complete assemblies) by name or keyword. Use it when you know what the thing is called; use find_by_dimensions when you only have measurements, list_categories to learn filter values. Every query word must appear in the object's name, aliases or tags (case-insensitive; '80-40', '80x40' and '8040' match alike); filters narrow with AND. Returns 20 summaries per page (limit up to 100) with total and next_offset for paging; an empty result means nothing matched every word, so retry with fewer words.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords, e.g. 'M3 heat set insert', 'tri clamp ferrule 2in', 'raspberry pi 5'. Omit to list by filters alone."
    },
    "category": {
      "type": "string",
      "description": "Exact category name from list_categories, e.g. 'Hardware'."
    },
    "group": {
      "type": "string",
      "description": "Exact group name within a category from list_categories, e.g. 'Fasteners'."
    },
    "kind": {
      "type": "string",
      "enum": [
        "modern",
        "vintage",
        "standard",
        "hardware",
        "list"
      ],
      "description": "modern/vintage = a product; standard = a part defined by a standard; hardware = a generated part with free files; list = a complete assembly with its parts list."
    },
    "year": {
      "type": "string",
      "description": "Release year for products: '2023', '2020s' or '2010-2019'; objects without a year are then excluded."
    },
    "free_only": {
      "type": "boolean",
      "description": "Only objects whose files are free to download."
    },
    "les_only": {
      "type": "boolean",
      "description": "Only parts used in Long Earth Society engine builds."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Page size, default 20."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Start index; pass next_offset from the previous page."
    }
  }
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer"
    },
    "offset": {
      "type": "integer"
    },
    "count": {
      "type": "integer"
    },
    "next_offset": {
      "type": [
        "integer",
        "null"
      ]
    },
    "objects": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "group": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "overall_mm": {
            "type": "object"
          },
          "free_files": {
            "type": "integer"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name"
        ],
        "additionalProperties": true
      }
    },
    "next": {
      "type": "string"
    }
  },
  "required": [
    "total",
    "objects"
  ],
  "additionalProperties": true
}

Identify an object from sizes you measured (an outline, a bore, a pin, a flange) when you don't know its name; use find_geometry when you do. Each size is compared, within tolerance_mm, against the object's overall size in any order and against its exact feature sizes (bores, slots, pins, size tables). Ranked: all overall sizes matching first, then the most matching features; up to 25 results, each saying which numbers matched where. No match is not an error: widen tolerance_mm or file request_object.

{
  "type": "object",
  "properties": {
    "sizes_mm": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "minItems": 1,
      "maxItems": 4,
      "description": "One to four sizes in mm, e.g. [40, 80] for a profile, [10.5] for a bore."
    },
    "tolerance_mm": {
      "type": "number",
      "minimum": 0,
      "maximum": 5,
      "description": "Allowed difference per size, default 0.5. Use about 0.2 for caliper readings of machined parts, 1 for rough measurements."
    },
    "category": {
      "type": "string",
      "description": "Optional exact category from list_categories to narrow the search."
    }
  },
  "required": [
    "sizes_mm"
  ]
}

{
  "type": "object",
  "properties": {
    "sizes_mm": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "tolerance_mm": {
      "type": "number"
    },
    "total": {
      "type": "integer"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "overall_mm": {
            "type": "object"
          },
          "all_overall_sizes_match": {
            "type": "boolean"
          },
          "matching_features": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "size_table_rows_matched": {
            "type": "integer"
          },
          "free_files": {
            "type": "integer"
          }
        },
        "required": [
          "slug",
          "name"
        ],
        "additionalProperties": true
      }
    },
    "next": {
      "type": "string"
    }
  },
  "required": [
    "total",
    "results"
  ],
  "additionalProperties": true
}

Read the full dimension sheet of one object: overall size, mounting holes, notes, size tables, mating features, related objects (call get_geometry on their slugs to traverse), FAQ, and every public CAD source with its license. Use it to answer how big something is, where its holes are, or what it fits. It never returns download links: use get_free_files for those, get_assembly for a complete assembly, get_fits when you only need the mating features. Unknown objects return an error with a hint to search first.

{
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "description": "Slug as returned by find_geometry or find_by_dimensions, e.g. '4080-aluminum-extrusion'. An exact name or alias also resolves."
    }
  },
  "required": [
    "object"
  ]
}

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "sheet": {
      "type": "object"
    },
    "sheet_text": {
      "type": [
        "string",
        "null"
      ]
    },
    "mating": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "related": {
      "type": "array",
      "items": {}
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "faq": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "files": {
      "type": "object",
      "properties": {
        "free_count": {
          "type": "integer"
        },
        "how": {
          "type": "string"
        }
      },
      "required": [],
      "additionalProperties": true
    },
    "paid_offers": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "dimensions": {
      "type": "string"
    }
  },
  "required": [
    "slug",
    "name",
    "sheet"
  ],
  "additionalProperties": true
}

List direct STEP and STL (and DXF where present) download URLs for one object's free files, licensed CC BY 4.0 (credit 'Xem Studio'). For a complete assembly (slug list-*) it returns the assembled model plus every part's files with quantities. Use it when you need files rather than dimensions (get_geometry) or file contents (get_file_content). An object with no free files returns an empty list and a note pointing to its public sources; that is not an error.

{
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "description": "Slug as returned by find_geometry or find_by_dimensions, e.g. '4080-aluminum-extrusion'. An exact name or alias also resolves."
    },
    "filter": {
      "type": "string",
      "description": "Keep only files whose name or note contains this text, e.g. 'm3x10' or '2in'."
    }
  },
  "required": [
    "object"
  ]
}

{
  "type": "object",
  "properties": {
    "object": {
      "type": "string"
    },
    "license": {
      "type": "string"
    },
    "count": {
      "type": "integer"
    },
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "step": {
            "type": "string"
          },
          "stl": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [],
        "additionalProperties": true
      }
    },
    "assembly": {
      "type": [
        "object",
        "null"
      ]
    },
    "parts": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "object"
  ],
  "additionalProperties": true
}

Return the contents of one free file so you can read or modify the geometry directly: STEP and DXF as UTF-8 text, STL as base64; units are millimetres. Use it after get_free_files gives you the file name; use get_free_files instead when a download URL is enough. Files over 600 KB are not inlined: you get size_bytes and the URL. An unknown file name returns an error listing the valid names.

{
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "description": "Slug as returned by find_geometry or find_by_dimensions, e.g. '4080-aluminum-extrusion'. An exact name or alias also resolves."
    },
    "file": {
      "type": "string",
      "description": "A file name exactly as get_free_files lists it, e.g. '4080-100'."
    },
    "format": {
      "type": "string",
      "enum": [
        "step",
        "dxf",
        "stl"
      ],
      "description": "Default step. DXF exists only for 2D sections such as extrusion profiles."
    }
  },
  "required": [
    "object",
    "file"
  ]
}

{
  "type": "object",
  "properties": {
    "object": {
      "type": "string"
    },
    "file": {
      "type": "string"
    },
    "format": {
      "type": "string"
    },
    "size_bytes": {
      "type": "integer"
    },
    "encoding": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "inlined": {
      "type": "boolean"
    },
    "content": {
      "type": "string"
    },
    "units": {
      "type": "string"
    },
    "license": {
      "type": "string"
    }
  },
  "required": [
    "object",
    "file",
    "format",
    "url"
  ],
  "additionalProperties": true
}

Return everything needed to build one complete assembly from its parts list (slug list-*, e.g. an engine or an alternator module): what it is and its performance numbers, every part line with quantity, placement note and file URLs, each part's mating features, the build order, and the assembled STEP/STL in which every part is already in position. Use it instead of calling get_geometry part by part; find assemblies with find_geometry(kind='list'). A slug that is not a list returns an error.

{
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "description": "An assembly slug starting 'list-', e.g. 'list-ta-ring-3x2in'."
    }
  },
  "required": [
    "object"
  ]
}

{
  "type": "object",
  "properties": {
    "object": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "what": {
      "type": "string"
    },
    "numbers": {
      "type": "string"
    },
    "assembly": {
      "type": [
        "object",
        "null"
      ]
    },
    "part_lines": {
      "type": "integer"
    },
    "parts_total": {
      "type": "integer"
    },
    "lines": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "build_order": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "object",
    "name",
    "lines"
  ],
  "additionalProperties": true
}

Return only the mating features of one object: each hole, pin, pocket, slot or socket that meets another part, its exact size, what it mates with, and its fit class (press, slide, run, socket, clamp, designed). Use it before preparing a part to print or machine, or when get_geometry's full sheet is more than you need. All sizes are exact with no clearance: add your process allowance to press, slide, run and socket features only; designed and clamp features stay as drawn. Objects without mating features return an empty list.

{
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "description": "Slug as returned by find_geometry or find_by_dimensions, e.g. '4080-aluminum-extrusion'. An exact name or alias also resolves."
    }
  },
  "required": [
    "object"
  ]
}

{
  "type": "object",
  "properties": {
    "object": {
      "type": "string"
    },
    "dimensions": {
      "type": "string"
    },
    "mating": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "feature": {
            "type": "string"
          },
          "exact": {
            "type": "string"
          },
          "mates": {
            "type": "string"
          },
          "fit": {
            "type": "string"
          }
        },
        "required": [],
        "additionalProperties": true
      }
    },
    "fit_classes": {
      "type": "object"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "object",
    "mating"
  ],
  "additionalProperties": true
}

List every category and the groups inside it with object counts, plus the catalog version. Use it to get the exact category and group names that find_geometry and find_by_dimensions filter on; it takes no input and returns the whole tree in one call.

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

{
  "type": "object",
  "properties": {
    "version": {
      "type": "string"
    },
    "total": {
      "type": "integer"
    },
    "categories": {
      "type": "object",
      "description": "category name -> { count, groups: { group name -> count } }"
    }
  },
  "required": [
    "total",
    "categories"
  ],
  "additionalProperties": true
}

File a request for an object the library lacks so it gets added. Use it only after find_geometry and find_by_dimensions find nothing suitable. Each call stores one new request (calling twice files two) in the owner's private inbox; nothing else changes and nothing is published. Stored: the text, the optional contact and the time, with no IP address. Requests set the order objects are added; there is no reply unless a contact is given. At most 300 requests a day are accepted site-wide.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Plain description: exact model or part number if known, what it must fit or mate with, which features matter, and any sizes already known. 3 to 4000 characters."
    },
    "contact": {
      "type": "string",
      "description": "Optional email or handle for a reply; include only if the person asks to be contacted."
    }
  },
  "required": [
    "text"
  ]
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "id": {
      "type": "integer"
    },
    "message": {
      "type": "string"
    }
  },
  "required": [
    "ok"
  ],
  "additionalProperties": true
}