Mineral Formation API

Free API AccessNo login requiredJSON output

Mineral Formation API

Use Mineral Formation as a lightweight worldbuilding API. Send a geologic timeline, preset, or domain-aware text input and receive ranked minerals, gemstones, materials, accessibility notes, and interpretive signals as JSON.

Back to Mineral Formation
Endpoints
GET /api/mineral-formation?preset=memphis&limit=5
GET /api/mineral-formation?timeline=tectonic:180:subduction_arc;sedimentary:60:shallow_sea;surface:0:upland_river
POST /api/mineral-formation
Accepted Inputs

Preset

Use built-in example histories such as memphis, los_angeles, miami, london, rome, tokyo, or sydney.

Compact Timeline

Use semicolon-separated entries: domain:age:event. Domain can be omitted when the event implies it.

Domain-Aware Text

Use the same text format as the page editor, grouped by tectonic, sedimentary, and surface.

POST Example
{
  "timeline": [
    { "age": 180, "domain": "tectonic", "event": "subduction_arc" },
    { "age": 60, "domain": "sedimentary", "event": "shallow_sea" },
    { "age": 0, "domain": "surface", "event": "upland_river" }
  ],
  "limit": 8
}
Response Shape
{
  "timeline": [{ "age": 180, "domain": "tectonic", "event": "subduction_arc" }],
  "summary": "This region reads as ...",
  "resources": [
    {
      "key": "gold",
      "label": "Gold",
      "category": "Precious metal",
      "score": 0.74,
      "probability": "High",
      "accessLevel": "Copper Age",
      "accessNote": "reachable with simple mining...",
      "signals": ["Subduction arc generated source potential at 180 Ma"]
    }
  ],
  "modifiers": { "exposure": 0.2, "placer": 0.36 },
  "notes": ["Subduction history is the strongest signal here..."],
  "accessibilityNotes": ["Copper Age: Gold, Quartz Crystal."]
}
Ways to Use It

Worldbuilding Generators

Feed terrain history from a map generator and produce plausible metals, gemstones, construction materials, and trade resources.

TTRPG Region Prep

Generate mining towns, trade goods, conflict hooks, and ancient quarry locations from a few geologic events.

Lore Pipelines

Use JSON output as input for settlement, economy, crafting, culture, or magic item systems.

Shareable Tool Links

The web tool accepts the same preset, timeline, and text params, so generated links can preload the UI for review.