GeminiMonitorResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/answerline-dev/json-schema/answerline-dev-gemini-monitor-response-schema.json",
  "title": "GeminiMonitorResponse",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/answerline-dev-openapi.json#/components/schemas/GeminiMonitorResponse",
  "required": [
    "success",
    "result"
  ],
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "result": {
      "description": "Data from Gemini's reply",
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Text of Gemini's reply"
        },
        "markdown": {
          "type": "string",
          "description": "Gemini's reply as Markdown"
        },
        "html": {
          "type": "string",
          "description": "Present when include.html is true: the link to the stored copy of the Gemini page."
        },
        "sources": {
          "type": "array",
          "description": "Sources that Gemini cited",
          "items": {
            "type": "object",
            "properties": {
              "position": {
                "type": "integer",
                "description": "Where the source sits in the list"
              },
              "label": {
                "type": "string",
                "description": "Title or label of the source"
              },
              "url": {
                "type": "string",
                "description": "Link to the source"
              },
              "description": {
                "type": "string",
                "description": "Snippet or description text for the source"
              }
            }
          }
        },
        "citationPills": {
          "type": "array",
          "description": "Citation pills that appear inline in the Gemini answer. Every element pairs one chip with one source: a chip backed by N sources (Gemini's equivalent of `+N`, or a section-summary chip) yields N elements with the same `citationPillId`, each holding that source's own `label`, `url` and `domain`. Grouping by `citationPillId` rebuilds the pills. `label` is always sent; it may be an empty string if the rail gives that source no title. Not present in `result` if the answer has no pills.",
          "items": {
            "type": "object",
            "required": [
              "label",
              "citationPillId",
              "url",
              "domain",
              "position"
            ],
            "properties": {
              "label": {
                "type": "string",
                "description": "Title of this individual source as shown in the sources rail (e.g. `\"Quantum computing — Wikipedia\"`). The field is always sent, though it can be an empty string if the rail gives no title for it — then identify the source by `domain` / `url`."
              },
              "citationPillId": {
                "type": "integer",
                "description": "One-based number common to every entry that comes from one chip. Grouping on `citationPillId` rebuilds the chip as displayed; each entry's `label` is specific to its source, so it varies inside a chip."
              },
              "url": {
                "type": "string",
                "description": "Link straight to the cited source."
              },
              "domain": {
                "type": "string",
                "description": "Hostname taken from `url`, useful for grouping and display."
              },
              "description": {
                "type": "string",
                "description": "Source snippet shown in the sources rail, if Gemini supplies one; otherwise omitted."
              },
              "position": {
                "type": "integer",
                "description": "Index of this source within the sibling `result.sources` array, starting at 1."
              }
            }
          }
        },
        "places": {
          "type": "array",
          "description": "Place cards included in lodging and local answers",
          "items": {
            "type": "object",
            "required": [
              "index",
              "title",
              "link"
            ],
            "properties": {
              "index": {
                "type": "integer",
                "description": "Index of the place's position in the results"
              },
              "title": {
                "type": "string",
                "description": "Place name"
              },
              "link": {
                "type": "string",
                "format": "uri",
                "description": "The place's URL on Google"
              },
              "thumbnail": {
                "type": "string",
                "format": "uri",
                "description": "URL of a photo of the place"
              },
              "rating": {
                "type": "number",
                "description": "Rating in stars (0-5)"
              },
              "reviews": {
                "type": "integer",
                "description": "Review count"
              },
              "type": {
                "type": "string",
                "description": "Category or type of the place"
              },
              "description": {
                "type": "string",
                "description": "Brief summary of the place"
              },
              "price": {
                "type": "string",
                "description": "Per-night price exactly as Gemini shows it"
              }
            }
          }
        },
        "rawResponse": {
          "type": "array",
          "description": "The answer as normalized stream events (present when include.rawResponse is true). For the engine's answer as received, use include.rawWire.",
          "items": {}
        },
        "shoppingCards": {
          "type": "array",
          "description": "Product cards Gemini shows beside a shopping-related answer, in display order. Absent when the answer has none.",
          "items": {
            "type": "object",
            "required": [
              "position",
              "title",
              "productLink",
              "productId"
            ],
            "properties": {
              "position": {
                "type": "integer",
                "description": "1-based order of the card among the answer's products."
              },
              "title": {
                "type": "string",
                "description": "Product name on the card."
              },
              "productLink": {
                "type": "string",
                "description": "Google Shopping link for the product.",
                "format": "uri"
              },
              "productId": {
                "type": "string",
                "description": "Google's identifier for the product."
              },
              "price": {
                "type": "object",
                "description": "Current price on the card.",
                "properties": {
                  "value": {
                    "type": "number",
                    "description": "The amount as a number."
                  },
                  "currency": {
                    "type": "string",
                    "description": "ISO 4217 currency code."
                  },
                  "raw": {
                    "type": "string",
                    "description": "The price exactly as displayed."
                  }
                }
              },
              "oldPrice": {
                "type": "object",
                "description": "Previous price, shown when the product is discounted.",
                "properties": {
                  "value": {
                    "type": "number",
                    "description": "The amount as a number."
                  },
                  "currency": {
                    "type": "string",
                    "description": "ISO 4217 currency code."
                  },
                  "raw": {
                    "type": "string",
                    "description": "The price exactly as displayed."
                  }
                }
              },
              "store": {
                "type": "string",
                "description": "Store offering the shown price."
              },
              "storeLink": {
                "type": "string",
                "description": "Link to the offer at that store, when the card has one.",
                "format": "uri"
              },
              "storeCount": {
                "type": "integer",
                "description": "How many stores sell the product."
              },
              "shipping": {
                "type": "string",
                "description": "Shipping note as displayed, when present."
              },
              "deliveryTime": {
                "type": "string",
                "description": "Delivery estimate as displayed, when present."
              },
              "rating": {
                "type": "number",
                "description": "Average review score."
              },
              "reviews": {
                "type": "integer",
                "description": "Number of reviews behind the rating."
              },
              "brand": {
                "type": "string",
                "description": "Manufacturer or brand."
              },
              "description": {
                "type": "string",
                "description": "Short product description from the card."
              },
              "thumbnail": {
                "type": "string",
                "description": "URL of the main product image.",
                "format": "uri"
              },
              "images": {
                "type": "array",
                "description": "URLs of the product images, main image first.",
                "items": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "catalogId": {
                "type": "string",
                "description": "Google Shopping catalog identifier."
              },
              "gpcId": {
                "type": "string",
                "description": "Google product cluster identifier."
              }
            }
          }
        },
        "entities": {
          "type": "array",
          "description": "The brands and products Gemini's answer shows as entity cards, in answer order. Absent when the answer has none.",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "description": "Identifier of the entity's type"
              },
              "name": {
                "type": "string",
                "description": "Entity name"
              }
            },
            "required": [
              "type",
              "name"
            ]
          }
        },
        "screenshot": {
          "type": "string",
          "format": "uri",
          "description": "Present when include.screenshot is true and the answer came from a rendered page: the link to the PNG screenshot of the Gemini page once the answer finished."
        }
      }
    }
  }
}