Yoast · Schema

Yoast SEO Metadata

Schema for SEO metadata returned by the Yoast REST API including meta tags, Open Graph, Twitter Card, and Schema.org structured data

SEOWordPressContent OptimizationSchemaMetadataStructured DataHeadless CMSContent AnalysisAgent ReadinessPlugins

Properties

Name	Type	Description
title	string	SEO page title
description	string	Meta description for the page
canonical	string	Canonical URL for the page
robots	object	Search engine robots directives
og_locale	string	Open Graph locale (e.g. en_US)
og_type	string	Open Graph type (e.g. article, website)
og_title	string	Open Graph title
og_description	string	Open Graph description
og_url	string	Open Graph URL
og_site_name	string	Open Graph site name
og_image	array	Open Graph images
twitter_card	string	Twitter Card type
twitter_title	string	Twitter Card title
twitter_description	string	Twitter Card description
twitter_image	string	Twitter Card image URL
article_published_time	string	Article published time (ISO 8601)
article_modified_time	string	Article last modified time (ISO 8601)
author	string	Article author name
schema	object	Schema.org JSON-LD structured data graph

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/yoast/main/json-schema/yoast-seo-metadata-schema.json",
  "title": "Yoast SEO Metadata",
  "description": "Schema for SEO metadata returned by the Yoast REST API including meta tags, Open Graph, Twitter Card, and Schema.org structured data",
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "SEO page title"
    },
    "description": {
      "type": "string",
      "description": "Meta description for the page"
    },
    "canonical": {
      "type": "string",
      "format": "uri",
      "description": "Canonical URL for the page"
    },
    "robots": {
      "type": "object",
      "description": "Search engine robots directives",
      "properties": {
        "index": {
          "type": "string",
          "enum": ["index", "noindex"],
          "description": "Whether search engines should index this page"
        },
        "follow": {
          "type": "string",
          "enum": ["follow", "nofollow"],
          "description": "Whether search engines should follow links on this page"
        },
        "max-snippet": {
          "type": "string",
          "description": "Maximum snippet length for search results"
        },
        "max-image-preview": {
          "type": "string",
          "description": "Maximum image preview size"
        },
        "max-video-preview": {
          "type": "string",
          "description": "Maximum video preview duration"
        }
      }
    },
    "og_locale": {
      "type": "string",
      "description": "Open Graph locale (e.g. en_US)"
    },
    "og_type": {
      "type": "string",
      "description": "Open Graph type (e.g. article, website)"
    },
    "og_title": {
      "type": "string",
      "description": "Open Graph title"
    },
    "og_description": {
      "type": "string",
      "description": "Open Graph description"
    },
    "og_url": {
      "type": "string",
      "format": "uri",
      "description": "Open Graph URL"
    },
    "og_site_name": {
      "type": "string",
      "description": "Open Graph site name"
    },
    "og_image": {
      "type": "array",
      "description": "Open Graph images",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "width": {
            "type": "integer"
          },
          "height": {
            "type": "integer"
          },
          "type": {
            "type": "string"
          }
        }
      }
    },
    "twitter_card": {
      "type": "string",
      "enum": ["summary", "summary_large_image", "app", "player"],
      "description": "Twitter Card type"
    },
    "twitter_title": {
      "type": "string",
      "description": "Twitter Card title"
    },
    "twitter_description": {
      "type": "string",
      "description": "Twitter Card description"
    },
    "twitter_image": {
      "type": "string",
      "format": "uri",
      "description": "Twitter Card image URL"
    },
    "article_published_time": {
      "type": "string",
      "format": "date-time",
      "description": "Article published time (ISO 8601)"
    },
    "article_modified_time": {
      "type": "string",
      "format": "date-time",
      "description": "Article last modified time (ISO 8601)"
    },
    "author": {
      "type": "string",
      "description": "Article author name"
    },
    "schema": {
      "type": "object",
      "description": "Schema.org JSON-LD structured data graph"
    }
  },
  "additionalProperties": true
}