{
  "openapi": "3.0.1",
  "info": {
    "title": "Mining & Critical Minerals Intelligence — Jenko Analytics",
    "description": "2-layer mining intelligence engine: supply (USGS critical minerals risk JCM/JBR) and price (JTM technical signal on metals). Premium mode commodity_full_intelligence combines both layers with auto bull/bear narrative.",
    "version": "1.0",
    "x-build-id": "Sp54eBea7HAT1DR2V"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/jenko_systems~mining-critical-minerals-intelligence/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-jenko_systems-mining-critical-minerals-intelligence",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/jenko_systems~mining-critical-minerals-intelligence/runs": {
      "post": {
        "operationId": "runs-sync-jenko_systems-mining-critical-minerals-intelligence",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/jenko_systems~mining-critical-minerals-intelligence/run-sync": {
      "post": {
        "operationId": "run-sync-jenko_systems-mining-critical-minerals-intelligence",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Analysis Mode",
            "enum": [
              "commodity_full_intelligence",
              "metal_technical_signal",
              "metal_investment_thesis",
              "metal_price_history",
              "metals_h2h",
              "commodity_overview",
              "critical_minerals_dashboard",
              "country_mining_profile"
            ],
            "type": "string",
            "description": "Pick a mode. Empty fields get a working example (listed in 'defaults_used'). Fields each mode uses:\n• commodity_full_intelligence / commodity_overview: commodity (empty = copper)\n• metal_technical_signal / metal_investment_thesis: metal (empty = gold)\n• metal_price_history: metal (empty = copper), months\n• metals_h2h: metal + metal_b (empty = gold vs silver)\n• country_mining_profile: country (empty = China)\n• critical_minerals_dashboard: category (optional), top_n",
            "default": "commodity_full_intelligence"
          },
          "commodity": {
            "title": "Commodity",
            "enum": [
              "lithium",
              "cobalt",
              "nickel",
              "graphite",
              "rare_earths",
              "copper",
              "uranium",
              "gallium",
              "germanium",
              "tungsten",
              "manganese",
              "platinum_group",
              "tin",
              "antimony",
              "vanadium"
            ],
            "type": "string",
            "description": "Critical mineral (USGS) for commodity_overview and commodity_full_intelligence. Empty = copper."
          },
          "metal": {
            "title": "Metal (for price modes)",
            "enum": [
              "aluminum",
              "copper",
              "iron_ore",
              "lead",
              "nickel",
              "tin",
              "zinc",
              "gold",
              "silver",
              "platinum"
            ],
            "type": "string",
            "description": "Metal (World Bank Pink Sheet) for the price modes. Empty = gold (copper in metal_price_history)."
          },
          "metal_b": {
            "title": "Metal B (for h2h)",
            "enum": [
              "aluminum",
              "copper",
              "iron_ore",
              "lead",
              "nickel",
              "tin",
              "zinc",
              "gold",
              "silver",
              "platinum"
            ],
            "type": "string",
            "description": "Second metal for metals_h2h. Empty = silver."
          },
          "country": {
            "title": "Country",
            "enum": [
              "Argentina",
              "Australia",
              "Austria",
              "Belgium",
              "Bolivia",
              "Brazil",
              "Burma",
              "Canada",
              "Chile",
              "China",
              "Cuba",
              "Côte d'Ivoire",
              "Democratic Republic of the Congo",
              "Gabon",
              "Germany",
              "Ghana",
              "Guatemala",
              "India",
              "Indonesia",
              "Iran",
              "Japan",
              "Kazakhstan",
              "Kyrgyzstan",
              "Laos",
              "Madagascar",
              "Malaysia",
              "Mali",
              "Mexico",
              "Mozambique",
              "Namibia",
              "New Caledonia",
              "Niger",
              "Nigeria",
              "North Korea",
              "Norway",
              "Other",
              "Pakistan",
              "Papua New Guinea",
              "Peru",
              "Philippines",
              "Poland",
              "Portugal",
              "Russia",
              "Rwanda",
              "South Africa",
              "South Korea",
              "Spain",
              "Sri Lanka",
              "Tajikistan",
              "Tanzania",
              "Thailand",
              "Turkey",
              "Ukraine",
              "United States",
              "Uzbekistan",
              "Vietnam",
              "Zambia",
              "Zimbabwe"
            ],
            "type": "string",
            "description": "Producer country for country_mining_profile. Empty = China."
          },
          "category": {
            "title": "Category filter (dashboard)",
            "enum": [
              "battery",
              "rare_earth_magnet",
              "tech_semiconductor",
              "industrial",
              "industrial_defense",
              "industrial_battery",
              "energy",
              "precious_industrial"
            ],
            "type": "string",
            "description": "Optional filter for critical_minerals_dashboard. Empty = all categories."
          },
          "top_n": {
            "title": "Top N results",
            "minimum": 3,
            "maximum": 50,
            "type": "integer",
            "description": "Number of top entries to return.",
            "default": 15
          },
          "months": {
            "title": "Months of history",
            "minimum": 24,
            "maximum": 600,
            "type": "integer",
            "description": "Months of price history for technical/historical modes.",
            "default": 240
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}