Yoast website screenshot

Yoast

Yoast is the maker of the world's most popular WordPress SEO plugin, active on over 13 million sites, and is part of Newfold Digital. 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. Most of that surface ships as plugin code and runs on the customer's own WordPress install: the Yoast REST API (/wp-json/yoast/v1/get_head plus yoast_head_json on WP posts and pages), the Schema Aggregator API that emits a site's whole Schema.org graph as JSON-L, the Surfaces, Metadata and Schema PHP APIs, and — since Yoast SEO 27.5 — three read-only WordPress Abilities that hand SEO, readability and inclusive-language scores to AI agents. Yoast additionally operates one hosted API of its own, the MyYoast Provisioning (Subscription) API at my.yoast.com, a partner-gated Basic Auth surface for resellers, backed by an OpenID Connect issuer with dynamic client registration, PKCE and DPoP. Key products include Yoast SEO Free, Yoast SEO Premium, Yoast SEO for Shopify, WooCommerce SEO, Local SEO, Video SEO, and News SEO.

Yoast publishes 6 APIs on the APIs.io network, including Pages API, Posts API, SEO Head API, and 3 more. Tagged areas include SEO, WordPress, Content Optimization, Schema, and Metadata.

The Yoast catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Yoast’s developer surface includes documentation, engineering blog, pricing, API reference, getting-started guide, support, signup flow, and 48 more developer resources.

64.0/100 strong ▬ flat Agent 40/100 agent ready Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0
AccessFreemium
9 APIs 1 MCP Servers
SEOWordPressContent OptimizationSchemaMetadataStructured DataHeadless CMSContent AnalysisAgent ReadinessPlugins

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0
Composite quality — 64.0/100 · strong
Contract Quality 14.5 / 25
Developer Ergonomics 14.6 / 20
Access Clarity 12.1 / 20
Operational Transparency 6.8 / 13
Contract Governance 6.6 / 12
Discoverability 9.3 / 10
Agent readiness — 40/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
Documented Reversibility 6 / 6
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 5 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 3 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/yoast: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 9

Individual APIs this provider publishes, each with its own machine-readable definition.

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

Yoast Pages API

WordPress page SEO metadata via WP REST API

Yoast Posts API

WordPress post SEO metadata via WP REST API

Yoast SEO Head API

Retrieve SEO metadata for any URL

Yoast SEO Abilities API

Yoast SEO registers its content-analysis results as WordPress Abilities (the Abilities API introduced in WordPress 6.9), making them discoverable and executable over the WordPre...

Yoast Schema Aggregator API

The Yoast Schema Aggregator exposes a site's aggregated Schema.org structured data over the WordPress REST API as paginated JSON-L, plus an XML schemamap listing every available...

MyYoast Provisioning API

The MyYoast Provisioning API (also called the Subscription API) is the one API Yoast hosts itself. It lets an approved Yoast provisioning partner create, read, renew, cancel, re...

Scroll for all 9

Open Collections 5

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

Yoast REST Pages API

OPEN COLLECTION

Yoast REST API

OPEN COLLECTION

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Yoast MCP Server

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Yoast Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Yoast Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Yoast Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Yoast Context

5 classes · 26 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Yoast API Rules

5 rules · 3 warnings 2 info

SPECTRAL

Yoast API Rules

8 rules · 1 errors 6 warnings

SPECTRAL

JSON Schema 1

Standalone JSON Schema definitions for this provider's data models.

Yoast SEO Metadata

19 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Yoast Seo Metadata Structure

0 properties

JSON STRUCTURE

Examples 2

Example request and response payloads for these APIs.

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Yoast Authentication

http/openIdConnect/none · 3 schemes

SECURITY

Yoast Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Yoast Vulnerability Disclosure

Hackerone · security.txt · contact published

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Yoast Scopes

OAuth 2.0 · no documented scopes

0 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Yoast Agentic Access

5 operations

5 operations · 0 acting

AGENTIC

Resources

Get Started 4

Portal, sign-up, and the first successful call

Documentation 4

Reference material describing how the API behaves

Agent Surfaces 8

MCP servers, agent skills, and machine-readable catalogs

Scroll for all 8

Design & Contract 11

Pagination, idempotency, versioning, errors, and events

Scroll for all 11

Build 7

SDKs, sample code, and the tooling you integrate with

Scroll for all 7

Access & Security 6

Authentication, authorization, and security posture

Operate 6

Status, limits, changes, and where to get help

Commercial 5

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml 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, and is
  part of Newfold Digital. 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. Most of that surface ships as
  plugin code and runs on the customer''s own WordPress install: the Yoast REST API (/wp-json/yoast/v1/get_head plus yoast_head_json
  on WP posts and pages), the Schema Aggregator API that emits a site''s whole Schema.org graph as JSON-L, the Surfaces, Metadata
  and Schema PHP APIs, and — since Yoast SEO 27.5 — three read-only WordPress Abilities that hand SEO, readability and inclusive-language
  scores to AI agents. Yoast additionally operates one hosted API of its own, the MyYoast Provisioning (Subscription) API
  at my.yoast.com, a partner-gated Basic Auth surface for resellers, backed by an OpenID Connect issuer with dynamic client
  registration, PKCE and DPoP. Key products include Yoast SEO Free, Yoast SEO Premium, Yoast SEO for Shopify, WooCommerce
  SEO, Local SEO, Video SEO, and News SEO.'
type: Index
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/yoast.png
tags:
- SEO
- WordPress
- Content Optimization
- Schema
- Metadata
- Structured Data
- Headless CMS
- Content Analysis
- Agent Readiness
- Plugins
created: '2025-01-14'
modified: '2026-08-13'
url: https://raw.githubusercontent.com/api-evangelist/yoast/refs/heads/main/apis.yml
specificationVersion: '0.23'
apis:
- 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/
- aid: yoast:yoast-pages-api
  name: Yoast Pages API
  description: WordPress page SEO metadata via WP REST API
  humanURL: https://developer.yoast.com/customization/apis/rest-api/
  baseURL: https://{your-site}/wp-json
  tags:
  - Pages
  properties:
  - type: OpenAPI
    url: openapi/yoast-pages-api-openapi.yml
  - type: Overlay
    url: overlays/yoast-pages-overlay.yaml
  - type: Documentation
    url: https://developer.yoast.com/customization/apis/rest-api/
- aid: yoast:yoast-posts-api
  name: Yoast Posts API
  description: WordPress post SEO metadata via WP REST API
  humanURL: https://developer.yoast.com/customization/apis/rest-api/
  baseURL: https://{your-site}/wp-json
  tags:
  - Posts
  properties:
  - type: OpenAPI
    url: openapi/yoast-posts-api-openapi.yml
  - type: Overlay
    url: overlays/yoast-posts-overlay.yaml
  - type: Documentation
    url: https://developer.yoast.com/customization/apis/rest-api/
- aid: yoast:yoast-seo-head-api
  name: Yoast SEO Head API
  description: Retrieve SEO metadata for any URL
  humanURL: https://developer.yoast.com/customization/apis/rest-api/
  baseURL: https://{your-site}/wp-json
  tags:
  - SEO Head
  properties:
  - type: OpenAPI
    url: openapi/yoast-seo-head-api-openapi.yml
  - type: Overlay
    url: overlays/yoast-seo-head-overlay.yaml
  - type: Documentation
    url: https://developer.yoast.com/customization/apis/rest-api/
- aid: yoast:yoast-abilities-api
  name: Yoast SEO Abilities API
  description: Yoast SEO registers its content-analysis results as WordPress Abilities (the Abilities API introduced in WordPress
    6.9), making them discoverable and executable over the WordPress REST API by AI agents and third-party systems. Three
    read-only abilities — yoast-seo/get-seo-scores, yoast-seo/get-readability-scores and yoast-seo/get-inclusive-language-scores
    — return the analysis scores of the most recently modified posts.
  humanURL: https://developer.yoast.com/features/yoast-seo-abilities/overview/
  baseURL: https://{your-site}/wp-json
  tags:
  - Abilities
  - Agent Readiness
  - Content Analysis
  - WordPress
  properties:
  - type: OpenAPI
    url: openapi/yoast-abilities-api-openapi.yml
  - type: Overlay
    url: overlays/yoast-abilities-overlay.yaml
  - type: Documentation
    url: https://developer.yoast.com/features/yoast-seo-abilities/overview/
  - type: APIReference
    url: https://developer.yoast.com/features/yoast-seo-abilities/analysis-scores/
- aid: yoast:yoast-schema-aggregator-api
  name: Yoast Schema Aggregator API
  description: The Yoast Schema Aggregator exposes a site's aggregated Schema.org structured data over the WordPress REST
    API as paginated JSON-L, plus an XML schemamap listing every available schema endpoint on the site — the structured-data
    equivalent of an XML sitemap, aimed at search engines and AI crawlers that want a site's entity graph in one place.
  humanURL: https://developer.yoast.com/features/schema/schema-aggregator/api-reference/
  baseURL: https://{your-site}/wp-json
  tags:
  - Schema.org
  - Structured Data
  - JSON-LD
  - WordPress
  properties:
  - type: OpenAPI
    url: openapi/yoast-schema-aggregator-openapi.yml
  - type: Overlay
    url: overlays/yoast-schema-aggregator-overlay.yaml
  - type: Documentation
    url: https://developer.yoast.com/features/schema/schema-aggregator/api-reference/
- aid: yoast:myyoast-provisioning-api
  name: MyYoast Provisioning API
  description: The MyYoast Provisioning API (also called the Subscription API) is the one API Yoast hosts itself. It lets
    an approved Yoast provisioning partner create, read, renew, cancel, refund and site-link Yoast product subscriptions on
    behalf of their customers, retrieve the current plugin version and download URLs for a product code, schedule a GDPR delete
    for a customer, and rotate their own provisioner Basic Auth password. Credentials are issued by Yoast to provisioners
    only.
  humanURL: https://developer.yoast.com/customization/myyoast/apis/subscription-api/
  baseURL: https://my.yoast.com
  tags:
  - Subscription
  - Provisioning
  - Partner API
  - Licensing
  tags_raw:
  - Subscriptions
  - Provisioning
  - Partner API
  - Licensing
  properties:
  - type: OpenAPI
    url: openapi/yoast-myyoast-provisioning-openapi.yml
  - type: Overlay
    url: overlays/yoast-myyoast-provisioning-overlay.yaml
  - type: Documentation
    url: https://developer.yoast.com/customization/myyoast/apis/subscription-api/
  - type: OpenIDConnect
    url: well-known/yoast-openid-configuration.json
  - type: SourceCode
    url: https://github.com/Yoast/subscription-api-php-client
common:
- type: AgenticAccess
  url: agentic-access/yoast-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/yoast-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/yoast-domain-security.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/yoast-com
- type: Website
  url: https://yoast.com/
- type: DeveloperPortal
  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: LlmsText
  url: https://yoast.com/llms.txt
- type: LLMsTxt
  url: llms/yoast-llms.txt
- type: APIReference
  url: https://developer.yoast.com/customization/apis/overview/
- type: GettingStarted
  url: https://developer.yoast.com/customization/apis/using-apis-classes/
- type: Support
  url: https://yoast.com/help/
- type: Signup
  url: https://my.yoast.com/login
- type: Login
  url: https://my.yoast.com/login
- type: TermsOfService
  url: https://yoast.com/terms-of-service/
- type: PrivacyPolicy
  url: https://yoast.com/privacy-policy/
- type: Security
  url: https://yoast.com/security-program/
- type: StatusPage
  url: https://status.yoast.com
- type: Deprecation
  url: https://github.com/Yoast/wordpress-seo/blob/trunk/DEPRECATING.md
- type: DeprecationPolicy
  url: https://github.com/Yoast/wordpress-seo/blob/trunk/DEPRECATING.md
- type: Versioning
  url: https://developer.yoast.com/development/standards/version-control-conventions/
- type: WellKnown
  url: well-known/yoast-well-known.yml
- type: SecurityTxt
  url: well-known/yoast-security.txt
- type: OpenIDConnect
  url: well-known/yoast-openid-configuration.json
- type: Packages
  url: packages/yoast-packages.yml
- type: SDKs
  url: packages/yoast-packages.yml
- type: Authentication
  url: authentication/yoast-authentication.yml
- type: OAuthScopes
  url: scopes/yoast-scopes.yml
- type: Conformance
  url: conformance/yoast-conformance.yml
- type: ErrorCatalog
  url: errors/yoast-problem-types.yml
- type: Lifecycle
  url: lifecycle/yoast-lifecycle.yml
- type: Conventions
  url: conventions/yoast-conventions.yml
- type: ChangeLog
  url: changelog/yoast-changelog.yml
- type: CLI
  url: cli/yoast-cli.yml
- type: Components
  url: components/yoast-components.yml
- type: DataModel
  url: data-model/yoast-data-model.yml
- type: AgentSkill
  url: skills/_index.yml
- type: AgentSkills
  url: skills/_index.yml
- type: MCP
  url: mcp/yoast-mcp.yml
- type: MCPServer
  url: mcp/yoast-mcp.yml
- type: Plans
  url: plans/yoast-plans-pricing.yml
- type: RateLimits
  url: rate-limits/yoast-rate-limits.yml
- type: FinOps
  url: finops/yoast-finops.yml
- type: SpectralRules
  url: rules/yoast-rules.yml
- type: JSONSchema
  url: json-schema/yoast-seo-metadata-schema.json
- type: JSONStructure
  url: json-structure/yoast-seo-metadata-structure.json
- type: JSONLDContext
  url: json-ld/yoast-context.jsonld
- type: Examples
  url: examples/yoast-rest-get-seo-head-example.json
- type: Examples
  url: examples/yoast-rest-get-post-seo-example.json
integrations:
- name: SEO Checker
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
x-enrichment:
  date: '2026-08-13'
  status: enriched
  artifacts_added: 31
  pass: local-v1