summary

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/wikimedia/json-schema/wikimedia-summary-schema.json",
  "title": "summary",
  "x-generated": "2026-11-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/wikimedia-page-content-api-openapi.yml#/components/schemas/summary",
  "type": "object",
  "properties": {
    "titles": {
      "$ref": "#/$defs/titles_set"
    },
    "title": {
      "deprecated": true,
      "type": "string",
      "description": "The page title.\nDeprecated: Use `titles.normalized` instead.\n"
    },
    "displaytitle": {
      "deprecated": true,
      "type": "string",
      "description": "The page title how it should be shown to the user.\nDeprecated: Use `titles.display` instead.\n"
    },
    "pageid": {
      "type": "integer",
      "description": "The page ID"
    },
    "extract": {
      "type": "string",
      "description": "First several sentences of an article in plain text"
    },
    "extract_html": {
      "type": "string",
      "description": "First several sentences of an article in simple HTML format"
    },
    "thumbnail": {
      "$ref": "#/$defs/thumbnail"
    },
    "originalimage": {
      "$ref": "#/$defs/originalimage"
    },
    "lang": {
      "type": "string",
      "description": "The page language code"
    },
    "dir": {
      "type": "string",
      "description": "The page language direction code"
    },
    "timestamp": {
      "type": "string",
      "description": "The time when the page was last edited in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format"
    },
    "description": {
      "type": "string",
      "description": "Wikidata description for the page"
    },
    "coordinates": {
      "type": "object",
      "description": "The coordinates of the item",
      "properties": {
        "lat": {
          "type": "number",
          "description": "The latitude"
        },
        "lon": {
          "type": "number",
          "description": "The longitude"
        }
      },
      "required": [
        "lat",
        "lon"
      ]
    }
  },
  "required": [
    "dir",
    "extract",
    "lang",
    "titles"
  ],
  "$defs": {
    "originalimage": {
      "type": "object",
      "properties": {
        "source": {
          "type": "string",
          "description": "Original image URI"
        },
        "width": {
          "type": "integer",
          "description": "Original image width"
        },
        "height": {
          "type": "integer",
          "description": "Original image height"
        }
      },
      "required": [
        "height",
        "source",
        "width"
      ]
    },
    "thumbnail": {
      "type": "object",
      "properties": {
        "source": {
          "type": "string",
          "description": "Thumbnail image URI"
        },
        "width": {
          "type": "integer",
          "description": "Thumbnail width"
        },
        "height": {
          "type": "integer",
          "description": "Thumnail height"
        }
      },
      "required": [
        "height",
        "source",
        "width"
      ]
    },
    "titles_set": {
      "type": "object",
      "properties": {
        "canonical": {
          "type": "string",
          "description": "the DB key (non-prefixed), e.g. may have _ instead of spaces, best for making request URIs, still requires Percent-encoding"
        },
        "normalized": {
          "type": "string",
          "description": "the normalized title (https://www.mediawiki.org/wiki/API:Query#Example_2:_Title_normalization), e.g. may have spaces instead of _"
        },
        "display": {
          "type": "string",
          "description": "the title as it should be displayed to the user"
        }
      },
      "required": [
        "canonical",
        "normalized",
        "display"
      ],
      "description": "a good example of the differences can be seen in https://en.wikipedia.org/api/rest_v1/page/summary/IOS_13"
    }
  }
}