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

62.5/100 strong ▬ flat Agent 39/100 agent ready Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0
AccessFreemium
3 APIs
SEOWordPressContent OptimizationSchemaMetadataStructured DataHeadless CMSContent AnalysisAgent ReadinessPlugins

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. 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. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 12

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 Provisioning Account API

Provisioner account self-service

Yoast Provisioning Downloads API

Current product versions and download URLs for a product code

Yoast Provisioning Users API

Customer-level operations, including scheduled GDPR delete

Yoast Schema Aggregator API

Aggregated Schema.org output for a WordPress site

Yoast Subscription Provisioning API

Create, read and manage provisioned Yoast subscriptions

Scroll for all 12

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

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 3

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

Work with this as data

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.