Web Search with Relevance Ranking

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Search query. Accepts natural language as well as Google-style operators: site:, -site:, inurl:, intitle:, quoted phrases, OR."
    },
    "numResults": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 10,
      "description": "Number of results to request and return (10-100, default 10). This is also what sizes the admission hold — one credit per result."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "title",
          "description",
          "relevance"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Result URL."
          },
          "title": {
            "type": "string",
            "description": "Page title."
          },
          "markdown": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "markdown": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "description": "Present when markdown content was requested for this result; `markdown.code` reads \"NOT_REQUESTED\" and `markdown.markdown` is null when it was not.",
            "additionalProperties": true
          },
          "relevance": {
            "type": "string",
            "description": "The provider's own relevance label for this result (e.g. high/medium/low)."
          },
          "description": {
            "type": "string",
            "description": "Short snippet describing the page."
          }
        },
        "additionalProperties": true
      }
    }
  },
  "description": "Ranked web search results, narrowed from the provider's `output.results` array and wrapped as `{results: [...]}`.",
  "additionalProperties": true
}