Yoast

Yoast is the maker of the world's most popular WordPress SEO plugin, active on over 13 million sites. Yoast provides developer APIs for integrating SEO metadata, structured data (Schema.org), meta tags, sitemaps, and SEO analysis into headless WordPress sites and third-party platforms. Key products include Yoast SEO Free, Yoast SEO Premium, WooCommerce SEO, Local SEO, Video SEO, and News SEO.

4 APIs 0 Features

SEOWordPressContent OptimizationSchemaMetadata

APIs

Yoast REST API

The Yoast REST API returns all SEO metadata (meta tags, Schema.org JSON-LD, canonical URLs, Open Graph, Twitter Card data, and robots directives) for any URL or post on a WordPr...

Yoast Surfaces API

The Yoast Surfaces API provides a PHP interface for retrieving SEO metadata programmatically within WordPress. It exposes the YoastSEO() surface with methods to get metadata for...

Yoast Metadata API

The Yoast Metadata API provides a PHP interface to add, alter, or remove metadata in the of a WordPress document. Developers can hook into Yoast's meta tag output pipelin...

Yoast Schema API

The Yoast Schema API provides a PHP interface for customizing the Schema.org JSON-LD structured data output generated by Yoast SEO. Developers can add, remove, or modify schema ...

Semantic Vocabularies

Yoast Context

5 classes · 26 properties

JSON-LD

API Governance Rules

Yoast API Rules

8 rules · 1 errors 6 warnings

SPECTRAL

JSON Structure

Yoast Seo Metadata Structure

0 properties

JSON STRUCTURE

Example Payloads

Yoast Rest Get Post Seo Example

2 fields

EXAMPLE

Yoast Rest Get Seo Head Example

2 fields

EXAMPLE

Resources

GitHubOrganization

Sources

aid: yoast
name: Yoast
description: >-
  Yoast is the maker of the world's most popular WordPress SEO plugin, active on over 13 million sites. Yoast provides
  developer APIs for integrating SEO metadata, structured data (Schema.org), meta tags, sitemaps, and SEO analysis into
  headless WordPress sites and third-party platforms. Key products include Yoast SEO Free, Yoast SEO Premium,
  WooCommerce SEO, Local SEO, Video SEO, and News SEO.
type: Index
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
  - SEO
  - WordPress
  - Content Optimization
  - Schema
  - Metadata
created: '2025-01-14'
modified: '2026-05-19'
url: https://raw.githubusercontent.com/api-evangelist/yoast/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
  - aid: yoast:yoast-rest-api
    name: Yoast REST API
    description: >-
      The Yoast REST API returns all SEO metadata (meta tags, Schema.org JSON-LD, canonical URLs, Open Graph, Twitter
      Card data, and robots directives) for any URL or post on a WordPress site. It extends the native WordPress WP-JSON
      REST API and also provides a dedicated endpoint at /yoast/v1/get_head. The API is read-only and designed for
      headless WordPress implementations.
    humanURL: https://developer.yoast.com/customization/apis/rest-api/
    baseURL: https://{your-site}/wp-json
    tags:
      - SEO
      - REST API
      - Metadata
      - WordPress
      - Headless
    properties:
      - type: Documentation
        url: https://developer.yoast.com/customization/apis/rest-api/
      - type: OpenAPI
        url: https://raw.githubusercontent.com/api-evangelist/yoast/refs/heads/main/openapi/yoast-rest-openapi.yml
  - aid: yoast:yoast-surfaces-api
    name: Yoast Surfaces API
    description: >-
      The Yoast Surfaces API provides a PHP interface for retrieving SEO metadata programmatically within WordPress. It
      exposes the YoastSEO() surface with methods to get metadata for the current page, a specific post by ID, or a
      given URL. Returns titles, descriptions, Schema arrays, canonical URLs, robots directives, OpenGraph, and Twitter
      card data.
    humanURL: https://developer.yoast.com/customization/apis/surfaces-api/
    baseURL: https://{your-site}
    tags:
      - SEO
      - PHP API
      - Metadata
      - WordPress
    properties:
      - type: Documentation
        url: https://developer.yoast.com/customization/apis/surfaces-api/
  - aid: yoast:yoast-metadata-api
    name: Yoast Metadata API
    description: >-
      The Yoast Metadata API provides a PHP interface to add, alter, or remove metadata in the <head> of a WordPress
      document. Developers can hook into Yoast's meta tag output pipeline to customize titles, descriptions, robots
      directives, Open Graph tags, and other head elements programmatically.
    humanURL: https://developer.yoast.com/customization/apis/metadata-api/
    baseURL: https://{your-site}
    tags:
      - SEO
      - PHP API
      - Metadata
      - WordPress
    properties:
      - type: Documentation
        url: https://developer.yoast.com/customization/apis/metadata-api/
  - aid: yoast:yoast-schema-api
    name: Yoast Schema API
    description: >-
      The Yoast Schema API provides a PHP interface for customizing the Schema.org JSON-LD structured data output
      generated by Yoast SEO. Developers can add, remove, or modify schema pieces such as Organization, WebSite,
      Article, BreadcrumbList, and more to control how search engines interpret page content.
    humanURL: https://developer.yoast.com/customization/apis/schema-api/
    baseURL: https://{your-site}
    tags:
      - SEO
      - Schema.org
      - Structured Data
      - PHP API
      - WordPress
    properties:
      - type: Documentation
        url: https://developer.yoast.com/customization/apis/schema-api/
common:
  - type: LinkedIn
    url: https://www.linkedin.com/company/yoast-com
  - type: Website
    url: https://yoast.com/
  - type: Developer Portal
    url: https://developer.yoast.com/
  - type: Documentation
    url: https://developer.yoast.com/customization/apis/
  - type: GitHubOrganization
    url: https://github.com/Yoast
  - type: Blog
    url: https://developer.yoast.com/blog/
  - type: Pricing
    url: https://yoast.com/wordpress-seo-plugin/
  - type: Plugin
    url: https://wordpress.org/plugins/wordpress-seo/
  - type: OpenAPI
    url: https://raw.githubusercontent.com/api-evangelist/yoast/refs/heads/main/openapi/yoast-rest-openapi.yml
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/yoast/refs/heads/main/vocabulary/yoast-vocabulary.yml
  - type: Integrations
    url: https://yoast.com/integrations/
  - type: LLMsTxt
    url: https://yoast.com/llms.txt
integrations:
  - name: SEO Checker
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com