Yoast logo

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 1 Capabilities 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 ...

Capabilities

Yoast SEO Metadata

Workflow capability for retrieving and managing SEO metadata from WordPress sites using the Yoast REST API. Enables headless CMS, content auditing, and SEO monitoring workflows ...

Run with Naftiko

Semantic Vocabularies

Yoast Context

5 classes · 26 properties

JSON-LD

API Governance Rules

Yoast API Rules

8 rules · 1 errors 6 warnings

SPECTRAL

Resources

🔗
Website
Website
🌐
Developer Portal
Developer Portal
🔗
Documentation
Documentation
👥
GitHub Organization
GitHub Organization
📰
Blog
Blog
💰
Pricing
Pricing
🔗
Plugin
Plugin
🔗
OpenAPI
OpenAPI
🔗
Vocabulary
Vocabulary

Sources

Raw ↑ 
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-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
tags:
  - SEO
  - WordPress
  - Content Optimization
  - Schema
  - Metadata
created: '2025-01-14'
modified: '2026-05-03'
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: Website
    url: https://yoast.com/
  - type: Developer Portal
    url: https://developer.yoast.com/
  - type: Documentation
    url: https://developer.yoast.com/customization/apis/
  - type: GitHub Organization
    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

maintainers:
  - FN: Kin Lane
    email: [email protected]