{
 "openapi": "3.1.0",
 "info": {
  "title": "Probed.si static data files",
  "version": "2026-11-18",
  "description": "Read-only static files (no key). Dated facts about domain names in .si, .com and .ai: registration status, registry dates, asking prices with the venue and check date, citable sales, .si registry totals. Files change at most once a day; fetch each at most once a day. Probed.si is not a registrar or marketplace and gives no advice. Trademark notices are information, not a verdict. One-name lookups: /api/v1/name/{name}. MCP connector: https://probed.si/mcp.",
  "license": {
   "name": "CC BY 4.0 (data)",
   "url": "https://creativecommons.org/licenses/by/4.0/"
  },
  "contact": {
   "name": "Probed.si",
   "url": "https://probed.si/method/"
  }
 },
 "externalDocs": {
  "description": "How the facts are checked",
  "url": "https://probed.si/method/"
 },
 "servers": [
  {
   "url": "https://probed.si"
  }
 ],
 "paths": {
  "/data/catalog.json": {
   "get": {
    "operationId": "getCatalog",
    "summary": "Index of every data file (rows, size, newest fact date)",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Catalog"
        }
       }
      }
     }
    }
   }
  },
  "/data/sets/{slug}.json": {
   "get": {
    "operationId": "getNameSet",
    "summary": "One name set: every name with a name report and its .si / .com / .ai facts",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "2-digit-numbers",
        "2-letter",
        "3-character-hyphen-x-y",
        "3-digit-numbers",
        "3-letter",
        "4-digit-numbers",
        "4l-domains-ending-in-si",
        "4l-domains-starting-with-si",
        "adjective-noun",
        "ai-tech-si-zone",
        "ai-word-pairs",
        "animal-forms",
        "animals",
        "astrology",
        "body-parts",
        "brain-neuroscience",
        "butler-assistant-roles",
        "cc-bot-s",
        "claude-thinking-words",
        "color-animal",
        "color-thing",
        "colors",
        "countries",
        "cv-bot-s",
        "cvccy-words",
        "cvcv",
        "cvcy",
        "cy-bot-s",
        "developed-si-zone",
        "dictionary-words",
        "dinosaurs-prehistoric",
        "domain-hacks-si",
        "domain-keywords",
        "elements",
        "emoji-words",
        "first-names",
        "food",
        "for-sale-si-zone",
        "gemstones-minerals",
        "global-last-names",
        "greek-gods",
        "greek-letters-math",
        "holidays",
        "hospital-science",
        "ify-words",
        "kitchen-cooking-verbs",
        "latin-greek-roots",
        "letter-digit-a1-1a",
        "light-optics",
        "music-rhythm-terms",
        "namepros-si-listings",
        "navigation-instruments",
        "open-keyword",
        "open-tech",
        "pet-names",
        "planets",
        "proven-two-word-names",
        "robot-bot-names",
        "s-intelligence",
        "secret-hidden-words",
        "slang-words",
        "stars-constellations",
        "super-keyword",
        "super-tech",
        "tools",
        "us-last-names",
        "us-states",
        "vc-bot-s",
        "vv-bot-s",
        "weather-sky",
        "wisdom-deities",
        "word-tech-ending"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/NameSet"
        }
       }
      }
     },
     "404": {
      "description": "unknown set"
     }
    }
   }
  },
  "/data/sets/{slug}.csv": {
   "get": {
    "operationId": "getNameSetCsv",
    "summary": "Same as the JSON file, one row per name (columns in /data/catalog.json set_columns)",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "text/csv": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/data/si-registry-totals.json": {
   "get": {
    "operationId": "getSiRegistryTotals",
    "summary": "Total .si domains per day as published by register.si",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/RegistryTotals"
        }
       }
      }
     }
    }
   }
  },
  "/data/si-registry-totals.csv": {
   "get": {
    "operationId": "getSiRegistryTotalsCsv",
    "summary": "Same as CSV",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "text/csv": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/data/sales.json": {
   "get": {
    "operationId": "getSales",
    "summary": "Domain sales with a public source URL, newest first",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Sales"
        }
       }
      }
     }
    }
   }
  },
  "/data/sales.csv": {
   "get": {
    "operationId": "getSalesCsv",
    "summary": "Same as CSV",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "text/csv": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/d/{name}/": {
   "get": {
    "operationId": "getNameReport",
    "summary": "Human-readable name report (HTML) for one label in .si, .com and .ai; the page to cite",
    "parameters": [
     {
      "name": "name",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "pattern": "^[a-z0-9-]+$"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "text/html": {
        "schema": {
         "type": "string"
        }
       }
      }
     },
     "404": {
      "description": "no report for this name (look it up at https://probed.si/#find)"
     }
    }
   }
  },
  "/api/v1/name/{name}": {
   "get": {
    "operationId": "lookupName",
    "summary": "Facts for one name in .si, .com, .ai and .bot (or one extension with a suffix)",
    "description": "Status (free to register / for sale with asking price, venue and check date / developed site / registered), registry dates, registrar, trademark notice. Research facts only.",
    "parameters": [
     {
      "name": "name",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "pattern": "^[a-z0-9-]{1,63}(\\.(si|com|ai|bot))?$"
      },
      "example": "finley"
     }
    ],
    "responses": {
     "200": {
      "description": "The name is tracked",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "Not in Probed.si name sets",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/index.json": {
   "get": {
    "operationId": "getApiIndex",
    "summary": "API index: as-of date, name count, field meanings, bucket rule",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "TldFacts": {
    "type": "object",
    "properties": {
     "status": {
      "type": "string",
      "description": "short neutral status"
     },
     "listing": {
      "type": "string",
      "description": "listing label at the venue"
     },
     "price_usd": {
      "type": "integer",
      "description": "asking price, US dollars, as shown by the venue"
     },
     "price_read_at": {
      "type": "string",
      "description": "where the price was read"
     },
     "price_checked": {
      "type": "string",
      "format": "date"
     },
     "registered": {
      "type": "string",
      "format": "date"
     },
     "expires": {
      "type": "string",
      "format": "date"
     },
     "registrar": {
      "type": "string"
     },
     "record_changed": {
      "type": "string",
      "format": "date"
     },
     "rechecking_since": {
      "type": "string",
      "format": "date"
     },
     "rechecking_reason": {
      "type": "string"
     },
     "previous_price_usd": {
      "type": "integer"
     }
    }
   },
   "NameRow": {
    "type": "object",
    "required": [
     "name",
     "page_url"
    ],
    "properties": {
     "name": {
      "type": "string"
     },
     "page_url": {
      "type": "string"
     },
     "sets": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "trademark_notice": {
      "type": "string",
      "description": "information, not a verdict"
     },
     "si": {
      "$ref": "#/components/schemas/TldFacts"
     },
     "com": {
      "$ref": "#/components/schemas/TldFacts"
     },
     "ai": {
      "$ref": "#/components/schemas/TldFacts"
     }
    }
   },
   "NameSet": {
    "type": "object",
    "properties": {
     "title": {
      "type": "string"
     },
     "set_code": {
      "type": "string"
     },
     "slug": {
      "type": "string"
     },
     "description": {
      "type": "string"
     },
     "page": {
      "type": "string"
     },
     "rows": {
      "type": "integer"
     },
     "newest_fact": {
      "type": "string",
      "format": "date"
     },
     "built": {
      "type": "string",
      "format": "date"
     },
     "license": {
      "type": "string"
     },
     "attribution": {
      "type": "string"
     },
     "notes": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "names": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/NameRow"
      }
     }
    }
   },
   "RegistryTotals": {
    "type": "object",
    "properties": {
     "title": {
      "type": "string"
     },
     "source": {
      "type": "string"
     },
     "rows": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "date": {
         "type": "string",
         "format": "date"
        },
        "read_at_cet": {
         "type": "string"
        },
        "total_si_domains": {
         "type": "integer"
        },
        "new_in_24h": {
         "type": [
          "integer",
          "string"
         ]
        },
        "registrars": {
         "type": [
          "integer",
          "string"
         ]
        }
       }
      }
     }
    }
   },
   "Sales": {
    "type": "object",
    "properties": {
     "title": {
      "type": "string"
     },
     "rule": {
      "type": "string"
     },
     "rows": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "date": {
         "type": "string",
         "format": "date"
        },
        "domain": {
         "type": "string"
        },
        "tld": {
         "type": "string"
        },
        "price_usd": {
         "type": [
          "integer",
          "string"
         ]
        },
        "currency_reported": {
         "type": "string"
        },
        "price_reported": {
         "type": [
          "integer",
          "string"
         ]
        },
        "venue": {
         "type": "string"
        },
        "source": {
         "type": "string"
        },
        "source_url": {
         "type": "string"
        },
        "trademark_notice": {
         "type": "string"
        }
       }
      }
     }
    }
   },
   "Catalog": {
    "type": "object",
    "properties": {
     "title": {
      "type": "string"
     },
     "built": {
      "type": "string",
      "format": "date"
     },
     "license": {
      "type": "string"
     },
     "fetch": {
      "type": "string"
     },
     "files": {
      "type": "array",
      "items": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}