{
  "openapi": "3.1.0",
  "info": {
    "title": "CyberMax open datasets API (Hugging Face dataset viewer)",
    "version": "1.0.0",
    "summary": "Query 35 free CyberMax datasets without downloading them.",
    "description": "The public Hugging Face dataset viewer API, documented for the CyberMax datasets only. No key, free. Full-text search and filters use an index built on first use. Catalog: https://cybermax-tools-cybermax.static.hf.space/market/catalog.json",
    "contact": {
      "name": "CyberMax",
      "url": "https://cybermax-tools-cybermax.static.hf.space/market/llms.txt"
    }
  },
  "externalDocs": {
    "description": "Hugging Face dataset viewer docs",
    "url": "https://huggingface.co/docs/dataset-viewer"
  },
  "servers": [
    {
      "url": "https://datasets-server.huggingface.co"
    }
  ],
  "security": [],
  "tags": [
    {
      "name": "datasets",
      "description": "CyberMax open datasets"
    }
  ],
  "paths": {
    "/splits": {
      "get": {
        "operationId": "listSplits",
        "tags": [
          "datasets"
        ],
        "summary": "Configs and splits of a dataset",
        "parameters": [
          {
            "name": "dataset",
            "in": "query",
            "required": true,
            "description": "CyberMax dataset id.",
            "schema": {
              "type": "string",
              "enum": [
                "CyberMax-tools/open-domain-ranks",
                "CyberMax-tools/saas-email-security-snapshot",
                "CyberMax-tools/tech-hiring-snapshot",
                "CyberMax-tools/app-complaint-stats",
                "CyberMax-tools/sec-form4-insider-transactions",
                "CyberMax-tools/kevscope-cve-kev-epss-daily",
                "CyberMax-tools/eventwren-sec-8k-events",
                "CyberMax-tools/us-zip-codes-demographics",
                "CyberMax-tools/curvewire-us-macro-panel",
                "CyberMax-tools/trialtide-clinicaltrials-registry",
                "CyberMax-tools/fipsbook-us-census-geographies",
                "CyberMax-tools/toolroll-mcp-registry-snapshot",
                "CyberMax-tools/figurewell-sec-xbrl-financials",
                "CyberMax-tools/pingroll-mcp-server-uptime",
                "CyberMax-tools/riskroll-sec-10k-10q-sections",
                "CyberMax-tools/policywren-us-ai-policy-tracker",
                "CyberMax-tools/swellmeter-google-trending-searches",
                "CyberMax-tools/hireheat-career-site-jobs-weekly",
                "CyberMax-tools/smartthings-review-mood-sept-2026",
                "CyberMax-tools/superintelligence-search-questions",
                "CyberMax-tools/superintelligence-ban-bill-coverage",
                "CyberMax-tools/haulroll-new-motor-carriers",
                "CyberMax-tools/awardtide-federal-contracts-ending",
                "CyberMax-tools/recallroll-vehicle-recalls",
                "CyberMax-tools/coffermap-federal-spending-by-county",
                "CyberMax-tools/orbitwren-orbital-compute-tracker",
                "CyberMax-tools/game-assets-samplers",
                "CyberMax-tools/open-domain-ranks-full-history",
                "CyberMax-tools/kevscope-cve-kev-epss-daily-full-history",
                "CyberMax-tools/riskroll-sec-10k-10q-sections-full-history",
                "CyberMax-tools/sec-form4-insider-transactions-full-history",
                "CyberMax-tools/figurewell-sec-xbrl-financials-full-history",
                "CyberMax-tools/fipsbook-us-census-geographies-full-history",
                "CyberMax-tools/us-zip-codes-demographics-full-history",
                "CyberMax-tools/curvewire-us-macro-panel-full-history"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Splits.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "splits": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "dataset": {
                            "type": "string"
                          },
                          "config": {
                            "type": "string"
                          },
                          "split": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Unknown dataset/config/split."
          },
          "500": {
            "description": "Index still loading or viewer error; retry later."
          }
        }
      }
    },
    "/first-rows": {
      "get": {
        "operationId": "firstRows",
        "tags": [
          "datasets"
        ],
        "summary": "Column types and the first rows",
        "parameters": [
          {
            "name": "dataset",
            "in": "query",
            "required": true,
            "description": "CyberMax dataset id.",
            "schema": {
              "type": "string",
              "enum": [
                "CyberMax-tools/open-domain-ranks",
                "CyberMax-tools/saas-email-security-snapshot",
                "CyberMax-tools/tech-hiring-snapshot",
                "CyberMax-tools/app-complaint-stats",
                "CyberMax-tools/sec-form4-insider-transactions",
                "CyberMax-tools/kevscope-cve-kev-epss-daily",
                "CyberMax-tools/eventwren-sec-8k-events",
                "CyberMax-tools/us-zip-codes-demographics",
                "CyberMax-tools/curvewire-us-macro-panel",
                "CyberMax-tools/trialtide-clinicaltrials-registry",
                "CyberMax-tools/fipsbook-us-census-geographies",
                "CyberMax-tools/toolroll-mcp-registry-snapshot",
                "CyberMax-tools/figurewell-sec-xbrl-financials",
                "CyberMax-tools/pingroll-mcp-server-uptime",
                "CyberMax-tools/riskroll-sec-10k-10q-sections",
                "CyberMax-tools/policywren-us-ai-policy-tracker",
                "CyberMax-tools/swellmeter-google-trending-searches",
                "CyberMax-tools/hireheat-career-site-jobs-weekly",
                "CyberMax-tools/smartthings-review-mood-sept-2026",
                "CyberMax-tools/superintelligence-search-questions",
                "CyberMax-tools/superintelligence-ban-bill-coverage",
                "CyberMax-tools/haulroll-new-motor-carriers",
                "CyberMax-tools/awardtide-federal-contracts-ending",
                "CyberMax-tools/recallroll-vehicle-recalls",
                "CyberMax-tools/coffermap-federal-spending-by-county",
                "CyberMax-tools/orbitwren-orbital-compute-tracker",
                "CyberMax-tools/game-assets-samplers",
                "CyberMax-tools/open-domain-ranks-full-history",
                "CyberMax-tools/kevscope-cve-kev-epss-daily-full-history",
                "CyberMax-tools/riskroll-sec-10k-10q-sections-full-history",
                "CyberMax-tools/sec-form4-insider-transactions-full-history",
                "CyberMax-tools/figurewell-sec-xbrl-financials-full-history",
                "CyberMax-tools/fipsbook-us-census-geographies-full-history",
                "CyberMax-tools/us-zip-codes-demographics-full-history",
                "CyberMax-tools/curvewire-us-macro-panel-full-history"
              ]
            }
          },
          {
            "name": "config",
            "in": "query",
            "required": true,
            "description": "Config (subset) name, from /splits.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "split",
            "in": "query",
            "required": true,
            "description": "Split name, from /splits (usually train).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Rows.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Rows"
                }
              }
            }
          },
          "404": {
            "description": "Unknown dataset/config/split."
          },
          "500": {
            "description": "Index still loading or viewer error; retry later."
          }
        }
      }
    },
    "/rows": {
      "get": {
        "operationId": "getRows",
        "tags": [
          "datasets"
        ],
        "summary": "Page through rows",
        "parameters": [
          {
            "name": "dataset",
            "in": "query",
            "required": true,
            "description": "CyberMax dataset id.",
            "schema": {
              "type": "string",
              "enum": [
                "CyberMax-tools/open-domain-ranks",
                "CyberMax-tools/saas-email-security-snapshot",
                "CyberMax-tools/tech-hiring-snapshot",
                "CyberMax-tools/app-complaint-stats",
                "CyberMax-tools/sec-form4-insider-transactions",
                "CyberMax-tools/kevscope-cve-kev-epss-daily",
                "CyberMax-tools/eventwren-sec-8k-events",
                "CyberMax-tools/us-zip-codes-demographics",
                "CyberMax-tools/curvewire-us-macro-panel",
                "CyberMax-tools/trialtide-clinicaltrials-registry",
                "CyberMax-tools/fipsbook-us-census-geographies",
                "CyberMax-tools/toolroll-mcp-registry-snapshot",
                "CyberMax-tools/figurewell-sec-xbrl-financials",
                "CyberMax-tools/pingroll-mcp-server-uptime",
                "CyberMax-tools/riskroll-sec-10k-10q-sections",
                "CyberMax-tools/policywren-us-ai-policy-tracker",
                "CyberMax-tools/swellmeter-google-trending-searches",
                "CyberMax-tools/hireheat-career-site-jobs-weekly",
                "CyberMax-tools/smartthings-review-mood-sept-2026",
                "CyberMax-tools/superintelligence-search-questions",
                "CyberMax-tools/superintelligence-ban-bill-coverage",
                "CyberMax-tools/haulroll-new-motor-carriers",
                "CyberMax-tools/awardtide-federal-contracts-ending",
                "CyberMax-tools/recallroll-vehicle-recalls",
                "CyberMax-tools/coffermap-federal-spending-by-county",
                "CyberMax-tools/orbitwren-orbital-compute-tracker",
                "CyberMax-tools/game-assets-samplers",
                "CyberMax-tools/open-domain-ranks-full-history",
                "CyberMax-tools/kevscope-cve-kev-epss-daily-full-history",
                "CyberMax-tools/riskroll-sec-10k-10q-sections-full-history",
                "CyberMax-tools/sec-form4-insider-transactions-full-history",
                "CyberMax-tools/figurewell-sec-xbrl-financials-full-history",
                "CyberMax-tools/fipsbook-us-census-geographies-full-history",
                "CyberMax-tools/us-zip-codes-demographics-full-history",
                "CyberMax-tools/curvewire-us-macro-panel-full-history"
              ]
            }
          },
          {
            "name": "config",
            "in": "query",
            "required": true,
            "description": "Config (subset) name, from /splits.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "split",
            "in": "query",
            "required": true,
            "description": "Split name, from /splits (usually train).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "First row (0-based).",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "length",
            "in": "query",
            "required": false,
            "description": "Rows to return (max 100).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Rows.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Rows"
                }
              }
            }
          },
          "404": {
            "description": "Unknown dataset/config/split."
          },
          "500": {
            "description": "Index still loading or viewer error; retry later."
          }
        }
      }
    },
    "/search": {
      "get": {
        "operationId": "searchRows",
        "tags": [
          "datasets"
        ],
        "summary": "Full-text search over string columns",
        "parameters": [
          {
            "name": "dataset",
            "in": "query",
            "required": true,
            "description": "CyberMax dataset id.",
            "schema": {
              "type": "string",
              "enum": [
                "CyberMax-tools/open-domain-ranks",
                "CyberMax-tools/saas-email-security-snapshot",
                "CyberMax-tools/tech-hiring-snapshot",
                "CyberMax-tools/app-complaint-stats",
                "CyberMax-tools/sec-form4-insider-transactions",
                "CyberMax-tools/kevscope-cve-kev-epss-daily",
                "CyberMax-tools/eventwren-sec-8k-events",
                "CyberMax-tools/us-zip-codes-demographics",
                "CyberMax-tools/curvewire-us-macro-panel",
                "CyberMax-tools/trialtide-clinicaltrials-registry",
                "CyberMax-tools/fipsbook-us-census-geographies",
                "CyberMax-tools/toolroll-mcp-registry-snapshot",
                "CyberMax-tools/figurewell-sec-xbrl-financials",
                "CyberMax-tools/pingroll-mcp-server-uptime",
                "CyberMax-tools/riskroll-sec-10k-10q-sections",
                "CyberMax-tools/policywren-us-ai-policy-tracker",
                "CyberMax-tools/swellmeter-google-trending-searches",
                "CyberMax-tools/hireheat-career-site-jobs-weekly",
                "CyberMax-tools/smartthings-review-mood-sept-2026",
                "CyberMax-tools/superintelligence-search-questions",
                "CyberMax-tools/superintelligence-ban-bill-coverage",
                "CyberMax-tools/haulroll-new-motor-carriers",
                "CyberMax-tools/awardtide-federal-contracts-ending",
                "CyberMax-tools/recallroll-vehicle-recalls",
                "CyberMax-tools/coffermap-federal-spending-by-county",
                "CyberMax-tools/orbitwren-orbital-compute-tracker",
                "CyberMax-tools/game-assets-samplers",
                "CyberMax-tools/open-domain-ranks-full-history",
                "CyberMax-tools/kevscope-cve-kev-epss-daily-full-history",
                "CyberMax-tools/riskroll-sec-10k-10q-sections-full-history",
                "CyberMax-tools/sec-form4-insider-transactions-full-history",
                "CyberMax-tools/figurewell-sec-xbrl-financials-full-history",
                "CyberMax-tools/fipsbook-us-census-geographies-full-history",
                "CyberMax-tools/us-zip-codes-demographics-full-history",
                "CyberMax-tools/curvewire-us-macro-panel-full-history"
              ]
            }
          },
          {
            "name": "config",
            "in": "query",
            "required": true,
            "description": "Config (subset) name, from /splits.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "split",
            "in": "query",
            "required": true,
            "description": "Split name, from /splits (usually train).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "query",
            "in": "query",
            "required": true,
            "description": "Search text.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "First row (0-based).",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "length",
            "in": "query",
            "required": false,
            "description": "Rows to return (max 100).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Rows.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Rows"
                }
              }
            }
          },
          "404": {
            "description": "Unknown dataset/config/split."
          },
          "500": {
            "description": "Index still loading or viewer error; retry later."
          }
        }
      }
    },
    "/filter": {
      "get": {
        "operationId": "filterRows",
        "tags": [
          "datasets"
        ],
        "summary": "SQL-style filter and sort (DuckDB syntax)",
        "parameters": [
          {
            "name": "dataset",
            "in": "query",
            "required": true,
            "description": "CyberMax dataset id.",
            "schema": {
              "type": "string",
              "enum": [
                "CyberMax-tools/open-domain-ranks",
                "CyberMax-tools/saas-email-security-snapshot",
                "CyberMax-tools/tech-hiring-snapshot",
                "CyberMax-tools/app-complaint-stats",
                "CyberMax-tools/sec-form4-insider-transactions",
                "CyberMax-tools/kevscope-cve-kev-epss-daily",
                "CyberMax-tools/eventwren-sec-8k-events",
                "CyberMax-tools/us-zip-codes-demographics",
                "CyberMax-tools/curvewire-us-macro-panel",
                "CyberMax-tools/trialtide-clinicaltrials-registry",
                "CyberMax-tools/fipsbook-us-census-geographies",
                "CyberMax-tools/toolroll-mcp-registry-snapshot",
                "CyberMax-tools/figurewell-sec-xbrl-financials",
                "CyberMax-tools/pingroll-mcp-server-uptime",
                "CyberMax-tools/riskroll-sec-10k-10q-sections",
                "CyberMax-tools/policywren-us-ai-policy-tracker",
                "CyberMax-tools/swellmeter-google-trending-searches",
                "CyberMax-tools/hireheat-career-site-jobs-weekly",
                "CyberMax-tools/smartthings-review-mood-sept-2026",
                "CyberMax-tools/superintelligence-search-questions",
                "CyberMax-tools/superintelligence-ban-bill-coverage",
                "CyberMax-tools/haulroll-new-motor-carriers",
                "CyberMax-tools/awardtide-federal-contracts-ending",
                "CyberMax-tools/recallroll-vehicle-recalls",
                "CyberMax-tools/coffermap-federal-spending-by-county",
                "CyberMax-tools/orbitwren-orbital-compute-tracker",
                "CyberMax-tools/game-assets-samplers",
                "CyberMax-tools/open-domain-ranks-full-history",
                "CyberMax-tools/kevscope-cve-kev-epss-daily-full-history",
                "CyberMax-tools/riskroll-sec-10k-10q-sections-full-history",
                "CyberMax-tools/sec-form4-insider-transactions-full-history",
                "CyberMax-tools/figurewell-sec-xbrl-financials-full-history",
                "CyberMax-tools/fipsbook-us-census-geographies-full-history",
                "CyberMax-tools/us-zip-codes-demographics-full-history",
                "CyberMax-tools/curvewire-us-macro-panel-full-history"
              ]
            }
          },
          {
            "name": "config",
            "in": "query",
            "required": true,
            "description": "Config (subset) name, from /splits.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "split",
            "in": "query",
            "required": true,
            "description": "Split name, from /splits (usually train).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "where",
            "in": "query",
            "required": false,
            "description": "Condition, e.g. \"state\"='NJ' AND \"population\">50000.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "orderby",
            "in": "query",
            "required": false,
            "description": "Sort, e.g. \"population\" DESC.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "First row (0-based).",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "length",
            "in": "query",
            "required": false,
            "description": "Rows to return (max 100).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Rows.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Rows"
                }
              }
            }
          },
          "404": {
            "description": "Unknown dataset/config/split."
          },
          "500": {
            "description": "Index still loading or viewer error; retry later."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Rows": {
        "type": "object",
        "properties": {
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "feature_idx": {
                  "type": "integer"
                },
                "name": {
                  "type": "string"
                },
                "type": {
                  "type": "object"
                }
              }
            }
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "row_idx": {
                  "type": "integer"
                },
                "row": {
                  "type": "object"
                },
                "truncated_cells": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "num_rows_total": {
            "type": "integer"
          },
          "num_rows_per_page": {
            "type": "integer"
          },
          "partial": {
            "type": "boolean"
          }
        }
      }
    }
  }
}