{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/words/refs/heads/main/json-structure/words-search-response-structure.json",
  "name": "SearchResponse",
  "description": "Response from GET /words search.",
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "description": "The query parameters as interpreted by Words API.",
      "additionalProperties": true
    },
    "results": {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Matching words.",
          "example": [
            "apple",
            "ample",
            "angle"
          ]
        },
        "total": {
          "type": "int32",
          "example": 3
        }
      }
    },
    "word": {
      "type": "string",
      "description": "When random=true, the single random word returned.",
      "example": "serendipity"
    }
  }
}