{
  "openapi": "3.1.0",
  "info": {
    "title": "GetSITools Public Read API",
    "version": "1.0.0",
    "summary": "Read-only JSON access to the published AI tool directory. No authentication required.",
    "description": "Public, anonymous, read-only endpoints for the GetSITools directory of AI tools.\n\nRate limit: 120 requests per 60s per client IP, per route. \nResponses carry RateLimit-Limit / RateLimit-Remaining / RateLimit-Reset headers.\n\nAll endpoints are cacheable and return a weak ETag: send it back as If-None-Match to receive 304.\n\nWrite access (creating, translating, publishing tools) lives on a separate, authenticated API at /api/v1 and is documented at /{locale}/api/docs.",
    "license": {
      "name": "Apache-2.0",
      "identifier": "Apache-2.0"
    }
  },
  "servers": [
    {
      "url": "https://www.getsitools.com",
      "description": "This deployment"
    }
  ],
  "tags": [
    {
      "name": "Tools",
      "description": "Browse and fetch published AI tools."
    },
    {
      "name": "Categories",
      "description": "Localized category tree with counts."
    }
  ],
  "paths": {
    "/api/public/tools": {
      "get": {
        "operationId": "listTools",
        "tags": [
          "Tools"
        ],
        "summary": "List or search published tools",
        "description": "Returns published tools, newest first by default. Plain-text search runs against name, description and stored translations.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Search terms. Up to 100 characters; queries of 2+ characters use full-text search.",
            "schema": {
              "type": "string",
              "maxLength": 100
            },
            "example": "image editing"
          },
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "description": "Content locale. Defaults to \"en\". Slugs are shared across locales.",
            "schema": {
              "type": "string",
              "enum": [
                "en",
                "zh",
                "ja",
                "ko",
                "es",
                "de",
                "fr",
                "pt"
              ],
              "default": "en"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Leaf or top-level category slug in the requested locale. Top-level slugs expand to all of their children.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tag",
            "in": "query",
            "required": false,
            "description": "Tag slug in the requested locale.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Sort order. Defaults to \"relevance\" when q is present, otherwise \"newest\".",
            "schema": {
              "type": "string",
              "enum": [
                "relevance",
                "newest",
                "trending",
                "clicks"
              ],
              "default": "newest"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "1-based page number.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10000,
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "Items per page.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching tools. `tools` is empty when nothing matches.",
            "headers": {
              "RateLimit-Limit": {
                "description": "Requests allowed for this route in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the current window resets.",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying. Only present on 429.",
                "schema": {
                  "type": "integer"
                }
              },
              "ETag": {
                "description": "Weak validator derived from the response body. Send it back as If-None-Match to receive 304 when nothing changed.",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Newest `updatedAt` of the returned records. Absent when the result set is empty.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "meta",
                    "tools"
                  ],
                  "properties": {
                    "meta": {
                      "type": "object",
                      "required": [
                        "locale",
                        "page",
                        "pageSize",
                        "total",
                        "totalPages",
                        "sort",
                        "query",
                        "category",
                        "tag",
                        "links"
                      ],
                      "properties": {
                        "locale": {
                          "type": "string",
                          "enum": [
                            "en",
                            "zh",
                            "ja",
                            "ko",
                            "es",
                            "de",
                            "fr",
                            "pt"
                          ]
                        },
                        "page": {
                          "type": "integer"
                        },
                        "pageSize": {
                          "type": "integer"
                        },
                        "total": {
                          "type": "integer",
                          "minimum": 0
                        },
                        "totalPages": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "sort": {
                          "type": "string",
                          "enum": [
                            "relevance",
                            "newest",
                            "trending",
                            "clicks"
                          ]
                        },
                        "query": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "category": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "tag": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "links": {
                          "type": "object",
                          "required": [
                            "self",
                            "next",
                            "previous"
                          ],
                          "properties": {
                            "self": {
                              "type": "string",
                              "format": "uri"
                            },
                            "next": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "format": "uri"
                            },
                            "previous": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "format": "uri"
                            }
                          }
                        }
                      }
                    },
                    "tools": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicToolSummary"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "CATEGORY_NOT_FOUND or TAG_NOT_FOUND — the requested slug does not exist in this locale.",
            "headers": {
              "RateLimit-Limit": {
                "description": "Requests allowed for this route in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the current window resets.",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying. Only present on 429.",
                "schema": {
                  "type": "integer"
                }
              },
              "ETag": {
                "description": "Weak validator derived from the response body. Send it back as If-None-Match to receive 304 when nothing changed.",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Newest `updatedAt` of the returned records. Absent when the result set is empty.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "RATE_LIMITED — retry after the Retry-After window.",
            "headers": {
              "RateLimit-Limit": {
                "description": "Requests allowed for this route in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the current window resets.",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying. Only present on 429.",
                "schema": {
                  "type": "integer"
                }
              },
              "ETag": {
                "description": "Weak validator derived from the response body. Send it back as If-None-Match to receive 304 when nothing changed.",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Newest `updatedAt` of the returned records. Absent when the result set is empty.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/tools/{slug}": {
      "get": {
        "operationId": "getTool",
        "tags": [
          "Tools"
        ],
        "summary": "Fetch one published tool",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Tool slug, as returned by listTools.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "description": "Content locale. Defaults to \"en\". Slugs are shared across locales.",
            "schema": {
              "type": "string",
              "enum": [
                "en",
                "zh",
                "ja",
                "ko",
                "es",
                "de",
                "fr",
                "pt"
              ],
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The tool record.",
            "headers": {
              "RateLimit-Limit": {
                "description": "Requests allowed for this route in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the current window resets.",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying. Only present on 429.",
                "schema": {
                  "type": "integer"
                }
              },
              "ETag": {
                "description": "Weak validator derived from the response body. Send it back as If-None-Match to receive 304 when nothing changed.",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Newest `updatedAt` of the returned records. Absent when the result set is empty.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "tool"
                  ],
                  "properties": {
                    "tool": {
                      "$ref": "#/components/schemas/PublicToolDetail"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "TOOL_NOT_FOUND — no published tool has this slug.",
            "headers": {
              "RateLimit-Limit": {
                "description": "Requests allowed for this route in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the current window resets.",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying. Only present on 429.",
                "schema": {
                  "type": "integer"
                }
              },
              "ETag": {
                "description": "Weak validator derived from the response body. Send it back as If-None-Match to receive 304 when nothing changed.",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Newest `updatedAt` of the returned records. Absent when the result set is empty.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "RATE_LIMITED — retry after the Retry-After window.",
            "headers": {
              "RateLimit-Limit": {
                "description": "Requests allowed for this route in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the current window resets.",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying. Only present on 429.",
                "schema": {
                  "type": "integer"
                }
              },
              "ETag": {
                "description": "Weak validator derived from the response body. Send it back as If-None-Match to receive 304 when nothing changed.",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Newest `updatedAt` of the returned records. Absent when the result set is empty.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/categories": {
      "get": {
        "operationId": "listCategories",
        "tags": [
          "Categories"
        ],
        "summary": "List the category tree",
        "description": "Categories are maintained per locale, so the same slug may exist in several locales as independent records. Second-level categories with no published tools are omitted.",
        "parameters": [
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "description": "Content locale. Defaults to \"en\". Slugs are shared across locales.",
            "schema": {
              "type": "string",
              "enum": [
                "en",
                "zh",
                "ja",
                "ko",
                "es",
                "de",
                "fr",
                "pt"
              ],
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The category tree for the requested locale.",
            "headers": {
              "RateLimit-Limit": {
                "description": "Requests allowed for this route in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the current window resets.",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying. Only present on 429.",
                "schema": {
                  "type": "integer"
                }
              },
              "ETag": {
                "description": "Weak validator derived from the response body. Send it back as If-None-Match to receive 304 when nothing changed.",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Newest `updatedAt` of the returned records. Absent when the result set is empty.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "meta",
                    "categories"
                  ],
                  "properties": {
                    "meta": {
                      "type": "object",
                      "required": [
                        "locale",
                        "categoryCount"
                      ],
                      "properties": {
                        "locale": {
                          "type": "string",
                          "enum": [
                            "en",
                            "zh",
                            "ja",
                            "ko",
                            "es",
                            "de",
                            "fr",
                            "pt"
                          ]
                        },
                        "categoryCount": {
                          "type": "integer",
                          "description": "Number of top-level categories returned."
                        }
                      }
                    },
                    "categories": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicCategory"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "RATE_LIMITED — retry after the Retry-After window.",
            "headers": {
              "RateLimit-Limit": {
                "description": "Requests allowed for this route in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Remaining": {
                "description": "Requests remaining in the current window.",
                "schema": {
                  "type": "integer"
                }
              },
              "RateLimit-Reset": {
                "description": "Seconds until the current window resets.",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait before retrying. Only present on 429.",
                "schema": {
                  "type": "integer"
                }
              },
              "ETag": {
                "description": "Weak validator derived from the response body. Send it back as If-None-Match to receive 304 when nothing changed.",
                "schema": {
                  "type": "string"
                }
              },
              "Last-Modified": {
                "description": "Newest `updatedAt` of the returned records. Absent when the result set is empty.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PublicToolSummary": {
        "type": "object",
        "description": "A published tool. Fields are stable; internal publication columns are never exposed.",
        "required": [
          "slug",
          "name",
          "description",
          "websiteUrl",
          "domain",
          "logoUrl",
          "coverImageUrl",
          "pricingDetail",
          "featured",
          "sponsored",
          "viewCount",
          "clickCount",
          "rating",
          "categories",
          "tags",
          "pageUrl",
          "updatedAt"
        ],
        "properties": {
          "slug": {
            "type": "string",
            "description": "Stable, locale-independent identifier. Use it to build human page URLs.",
            "examples": [
              "acme-ai"
            ]
          },
          "name": {
            "type": [
              "string"
            ],
            "description": "Display name in the requested locale."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "One-paragraph description in the requested locale. Falls back to English when the locale has no translation."
          },
          "websiteUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "description": "Official product URL."
          },
          "domain": {
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "example.com"
            ]
          },
          "logoUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "coverImageUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "pricingDetail": {
            "type": [
              "string",
              "null"
            ],
            "description": "Free-text pricing written by the editors, e.g. \"Pro $20/month\". Not normalized."
          },
          "featured": {
            "type": "boolean"
          },
          "sponsored": {
            "type": "boolean",
            "description": "True when the listing is currently promoted (paid placement or active promo window)."
          },
          "viewCount": {
            "type": "integer",
            "minimum": 0
          },
          "clickCount": {
            "type": "integer",
            "minimum": 0
          },
          "rating": {
            "type": [
              "object",
              "null"
            ],
            "description": "Null when the tool has no published reviews yet.",
            "required": [
              "average",
              "count"
            ],
            "properties": {
              "average": {
                "type": "number",
                "minimum": 0,
                "maximum": 5
              },
              "count": {
                "type": "integer",
                "minimum": 0
              }
            },
            "additionalProperties": false
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "A category or tag reference, localized to the requested locale.",
              "required": [
                "slug",
                "name"
              ],
              "properties": {
                "slug": {
                  "type": "string",
                  "examples": [
                    "writing-assistants"
                  ]
                },
                "name": {
                  "type": "string",
                  "examples": [
                    "Writing Assistants"
                  ]
                }
              },
              "additionalProperties": false
            }
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "A category or tag reference, localized to the requested locale.",
              "required": [
                "slug",
                "name"
              ],
              "properties": {
                "slug": {
                  "type": "string",
                  "examples": [
                    "writing-assistants"
                  ]
                },
                "name": {
                  "type": "string",
                  "examples": [
                    "Writing Assistants"
                  ]
                }
              },
              "additionalProperties": false
            }
          },
          "pageUrl": {
            "type": "string",
            "format": "uri",
            "description": "Canonical HTML page for this tool in the requested locale."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "PublicToolDetail": {
        "type": "object",
        "description": "A published tool. Fields are stable; internal publication columns are never exposed.",
        "required": [
          "slug",
          "name",
          "description",
          "websiteUrl",
          "domain",
          "logoUrl",
          "coverImageUrl",
          "pricingDetail",
          "featured",
          "sponsored",
          "viewCount",
          "clickCount",
          "rating",
          "categories",
          "tags",
          "pageUrl",
          "updatedAt",
          "id",
          "screenshots",
          "supportedLanguages",
          "contacts",
          "availableLocales",
          "createdAt"
        ],
        "properties": {
          "slug": {
            "type": "string",
            "description": "Stable, locale-independent identifier. Use it to build human page URLs.",
            "examples": [
              "acme-ai"
            ]
          },
          "name": {
            "type": [
              "string"
            ],
            "description": "Display name in the requested locale."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "One-paragraph description in the requested locale. Falls back to English when the locale has no translation."
          },
          "websiteUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "description": "Official product URL."
          },
          "domain": {
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "example.com"
            ]
          },
          "logoUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "coverImageUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "pricingDetail": {
            "type": [
              "string",
              "null"
            ],
            "description": "Free-text pricing written by the editors, e.g. \"Pro $20/month\". Not normalized."
          },
          "featured": {
            "type": "boolean"
          },
          "sponsored": {
            "type": "boolean",
            "description": "True when the listing is currently promoted (paid placement or active promo window)."
          },
          "viewCount": {
            "type": "integer",
            "minimum": 0
          },
          "clickCount": {
            "type": "integer",
            "minimum": 0
          },
          "rating": {
            "type": [
              "object",
              "null"
            ],
            "description": "Null when the tool has no published reviews yet.",
            "required": [
              "average",
              "count"
            ],
            "properties": {
              "average": {
                "type": "number",
                "minimum": 0,
                "maximum": 5
              },
              "count": {
                "type": "integer",
                "minimum": 0
              }
            },
            "additionalProperties": false
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "A category or tag reference, localized to the requested locale.",
              "required": [
                "slug",
                "name"
              ],
              "properties": {
                "slug": {
                  "type": "string",
                  "examples": [
                    "writing-assistants"
                  ]
                },
                "name": {
                  "type": "string",
                  "examples": [
                    "Writing Assistants"
                  ]
                }
              },
              "additionalProperties": false
            }
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "A category or tag reference, localized to the requested locale.",
              "required": [
                "slug",
                "name"
              ],
              "properties": {
                "slug": {
                  "type": "string",
                  "examples": [
                    "writing-assistants"
                  ]
                },
                "name": {
                  "type": "string",
                  "examples": [
                    "Writing Assistants"
                  ]
                }
              },
              "additionalProperties": false
            }
          },
          "pageUrl": {
            "type": "string",
            "format": "uri",
            "description": "Canonical HTML page for this tool in the requested locale."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "id": {
            "type": "string",
            "description": "Internal record id. Stable, but prefer slug."
          },
          "screenshots": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            }
          },
          "supportedLanguages": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "BCP-47 codes the product itself supports, harvested from its own site.",
            "examples": [
              [
                "en",
                "zh-Hans"
              ]
            ]
          },
          "contacts": {
            "$ref": "#/components/schemas/ToolContacts"
          },
          "availableLocales": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "en",
                "zh",
                "ja",
                "ko",
                "es",
                "de",
                "fr",
                "pt"
              ]
            },
            "description": "Locales in which this record has both a name and a description."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "ToolContacts": {
        "type": "object",
        "description": "Verified public contact channels. Empty object means the tool has no harvested contact details.",
        "properties": {
          "email": {
            "type": "string",
            "format": "email"
          },
          "x": {
            "type": "string",
            "format": "uri"
          },
          "facebook": {
            "type": "string",
            "format": "uri"
          },
          "instagram": {
            "type": "string",
            "format": "uri"
          },
          "tiktok": {
            "type": "string",
            "format": "uri"
          },
          "youtube": {
            "type": "string",
            "format": "uri"
          },
          "linkedin": {
            "type": "string",
            "format": "uri"
          }
        },
        "additionalProperties": false
      },
      "PublicCategory": {
        "type": "object",
        "required": [
          "slug",
          "name",
          "description",
          "toolCount",
          "pageUrl",
          "children"
        ],
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "toolCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Published tools in this category. For top-level categories this counts the distinct union of its children."
          },
          "pageUrl": {
            "type": "string",
            "format": "uri"
          },
          "children": {
            "type": "array",
            "description": "Second-level categories with at least one published tool. Always empty on nested nodes.",
            "items": {
              "$ref": "#/components/schemas/PublicCategory"
            }
          }
        },
        "additionalProperties": false
      },
      "Error": {
        "type": "object",
        "required": [
          "error",
          "message"
        ],
        "properties": {
          "error": {
            "type": "string",
            "description": "Stable machine-readable error code.",
            "examples": [
              "TOOL_NOT_FOUND"
            ]
          },
          "message": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    }
  }
}
