SEOptimate Connector

By SEOptimate

10+ active installationsVersion 1.2.0

Connects your WordPress site to SEOptimate so approved SEO title and meta description improvements can be applied directly.

Description

SEOptimate is an SEO and GEO content platform: it helps your site get found in Google and in AI search engines. Learn more at seoptimate.com. When it proposes an improved SEO title or meta description and you approve it, SEOptimate applies the change through the standard WordPress REST API.

Rank Math (and older Yoast SEO versions) do not expose their title and description fields to the REST API, which means WordPress silently ignores those writes. This small connector registers exactly those fields, so approved changes actually arrive.

SEOptimate can also place approved articles in your own post types and Advanced Custom Fields (ACF). For that it needs to know which post types your site has and which fields belong to them. Since version 1.2.0 the connector answers exactly that through two read-only endpoints.

What it does:

  • Registers the Rank Math title, description and focus keyword fields in the REST API for posts, pages, products and other public post types, only when Rank Math is active.
  • Registers the same Rank Math fields for category and brand pages (for example WooCommerce product categories and brands), only when Rank Math is active.
  • Registers the Yoast SEO title, description and focus keyword fields in the REST API for posts, pages, products and other public post types, only when Yoast SEO is active.
  • Provides two read-only REST endpoints for SEOptimate: /seoptimate/v1/post-types (the public post types with a REST route) and /seoptimate/v1/acf-structure?post_type=... (the ACF field groups and fields of one post type: field type, required flag, choices, repeater sub fields and flexible content layouts). They return structure only, never content or field values.
  • Nothing else: no settings screen, no data collection, no external requests.

Security: WordPress itself enforces all permissions. The fields can only be written by authenticated users who can already edit that specific item, exactly as if they edited it in the admin. Values are sanitized as plain text before they are stored. The two structure endpoints are only readable by logged-in users who may edit the post type in question; anonymous requests are refused.

External services

This plugin itself makes no requests to any external service, collects no data and sends nothing anywhere.

It is built for use with SEOptimate (https://seoptimate.com), a paid SEO and GEO content platform. SEOptimate writes to your site through the standard WordPress REST API, using an application password that you create in your own WordPress profile and can revoke at any time. The two read-only endpoints added in version 1.2.0 work the same way: the connector never starts a request itself, it only answers requests that SEOptimate makes with your application password, and it returns the structure of your post types and ACF fields to SEOptimate and to nobody else. Without an SEOptimate account and such a connection, the plugin only registers the fields and does nothing else.

  • Service: https://seoptimate.com
  • Terms and privacy: https://seoptimate.com/privacy

Installation

  1. Install and activate the plugin.
  2. That is all. Your existing SEOptimate connection (application password) now applies approved titles and descriptions directly.

FAQ

Does this change anything on my site by itself?

No. It only makes existing SEO fields writable through the standard WordPress API, for users who could already edit them. Changes only happen when you approve a proposal in SEOptimate.

What if I have neither Rank Math nor Yoast?

Then the plugin registers nothing. A separate SEO title and description require an SEO plugin; SEOptimate will tell you so honestly.

Does it work for category and brand pages with Yoast SEO?

No. Yoast SEO stores the SEO data of categories and brands in a single site option instead of on the term itself, and that option cannot be written through the REST API. SEOptimate then links you directly to the edit screen of that category or brand.

Which data does SEOptimate read through the connector?

Only the structure of your site, and only when you have connected it with an application password. The post-types endpoint returns your public post types with their name, label, REST route, taxonomies and whether the connected user may edit and publish them. The acf-structure endpoint returns, for one post type, the ACF field groups and their fields: name, label, field type, whether it is required, the available choices, repeater sub fields and flexible content layouts. No post content, no field values, no users, no settings and no visitor data are read. Both endpoints answer only to a logged-in user who may edit that post type; without ACF the acf-structure endpoint returns an empty list with a notice.

Changelog

1.2.0

  • New read-only endpoints for SEOptimate: GET /seoptimate/v1/post-types (public post types with a REST route) and GET /seoptimate/v1/acf-structure?post_type=… (ACF field groups and fields for that type, including field type, required flag, choices, repeater sub fields and flexible content layouts). Only users who may edit that post type can read them. Nothing is written or sent anywhere.

1.1.1

  • Readme and plugin header prepared for the WordPress.org directory (tested up to WordPress 7.1).
  • Values written to the SEO fields are sanitized as plain text.

1.1.0

  • Products and other public post types now get the SEO fields too, not only posts and pages.
  • With Rank Math: category and brand pages (taxonomy terms) get the SEO fields as well.
  • Permissions are now checked per item (edit this post, edit this term) instead of the general “edit posts” capability.
  • Registration runs late on init, so WooCommerce products, categories and brands are available.

1.0.0

  • First release: REST registration of Rank Math and Yoast SEO title/description/focus keyword fields for posts and pages, conditional on the owning plugin being active.