Home
Providers
Yoast
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 9 APIs on the APIs.io network, including Pages API, Posts API, SEO Head API, and 6 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 50 more developer resources.
3 APIs
On this page
Kin Score
APIs 12
Open Collections 5
Pricing Plans 1
Rate Limits 1
FinOps 1
Vocabularies 1
Spectral Rules 2
JSON Schema 1
JSON Structure 1
Examples 2
Security Posture 3
Scopes 1
Agentic Access 1
Resources 57
apis.yml
53 Operational Transparency
0 Create-or-Update Ergonomics
Composite quality — 62.5/100 · strong
Agent readiness — 39/100 · agent ready
Individual APIs this provider publishes, each with its own machine-readable definition.
Scroll for all 12
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Published pricing tiers and plan structures.
Documented rate limits and quota policies.
Cost, billing, and metering signals for API financial operations.
JSON-LD contexts and semantic vocabularies used across these APIs.
Spectral governance rulesets for linting and validating these APIs.
Standalone JSON Schema definitions for this provider's data models.
JSON Structure definitions describing this provider's data shapes.
Example request and response payloads for these APIs.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
OAuth scopes governing access to this provider's APIs.
Recommended x-agentic-access execution contracts for AI agents.
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 3
Properties that don't map to a standard resource type
Source (apis.yml)
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
deliveryModel:
model: unknown
open_source: unknown
commercial: true
callable_host: true
label: Delivery model not determined — needs a product licence on record
confidence: low
source:
- openapi
- pricing
- repository-unlicensed
generated: '2026-08-28'
method: derived
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: Consuming
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-provisioning-account-api
name: Yoast Provisioning Account API
description: Provisioner account self-service
humanURL: https://developer.yoast.com/customization/apis/surfaces-api/
baseURL: https://{your-site}
tags:
- Provisioning Account
properties:
- type: OpenAPI
url: openapi/yoast-provisioning-account-api-openapi.yml
- type: Documentation
url: https://developer.yoast.com/features/schema/schema-aggregator/api-reference/
- 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
- aid: yoast:yoast-provisioning-downloads-api
name: Yoast Provisioning Downloads API
description: Current product versions and download URLs for a product code
humanURL: https://developer.yoast.com/customization/apis/surfaces-api/
baseURL: https://{your-site}
tags:
- Provisioning Downloads
properties:
- type: OpenAPI
url: openapi/yoast-provisioning-downloads-api-openapi.yml
- type: Documentation
url: https://developer.yoast.com/features/schema/schema-aggregator/api-reference/
- 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
- aid: yoast:yoast-provisioning-users-api
name: Yoast Provisioning Users API
description: Customer-level operations, including scheduled GDPR delete
humanURL: https://developer.yoast.com/customization/apis/surfaces-api/
baseURL: https://{your-site}
tags:
- Provisioning Users
properties:
- type: OpenAPI
url: openapi/yoast-provisioning-users-api-openapi.yml
- type: Documentation
url: https://developer.yoast.com/features/schema/schema-aggregator/api-reference/
- 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
- aid: yoast:yoast-schema-aggregator-api
name: Yoast Schema Aggregator API
description: Aggregated Schema.org output for a WordPress site
humanURL: https://developer.yoast.com/customization/apis/surfaces-api/
baseURL: https://{your-site}
tags:
- Schema Aggregator
properties:
- type: OpenAPI
url: openapi/yoast-schema-aggregator-api-openapi.yml
- type: Documentation
url: https://developer.yoast.com/features/schema/schema-aggregator/api-reference/
- 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
- aid: yoast:yoast-subscription-provisioning-api
name: Yoast Subscription Provisioning API
description: Create, read and manage provisioned Yoast subscriptions
humanURL: https://developer.yoast.com/customization/apis/surfaces-api/
baseURL: https://{your-site}
tags:
- Subscription Provisioning
properties:
- type: OpenAPI
url: openapi/yoast-subscription-provisioning-api-openapi.yml
- type: Documentation
url: https://developer.yoast.com/features/schema/schema-aggregator/api-reference/
- 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: Overlay
url: overlays/yoast-schema-aggregator-overlay.yaml
- type: Overlay
url: overlays/yoast-myyoast-provisioning-overlay.yaml
- 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: X-MCPServerCandidate
url: mcp/yoast-mcp.yml
note: 'Renamed from MCPServer 2026-09-03 (roadmap#247): the manifest self-describes as status: candidate — a tool list derived
from the published API contracts, not an existing server. The scorer already read the manifest and reported mcp_server
correctly; the MCPServer type was crediting the artifact-type surfaces with a server that does not exist.'
- 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
Every provider here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for providers
9 MCP tools reach this
find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This provider
curl "https://apis.io/api/v1/providers/yoast"
All providers
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose
curl "https://apis.io/api/v1/providers/yoast/operations?limit=25"
How their score was established
curl "https://apis.io/api/v1/providers/yoast/evidence"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms .
A second provider on the same verified email joins the account you already have.