WonderRankWonderRankDOCS
Coming Soon • Ghost Admin API v5 in Testing

Publish Directly to Ghost CMS

Automatically publish and synchronize researched, SEO-optimized articles directly into your Ghost blog using Ghost's Admin API v5. Includes native Lexical-safe schema cards, optimistic locking conflict resolution, and full OpenGraph social metadata.

Native connector in final testing: You can publish to Ghost today using our live Custom Webhooks or pull-based REST API.
View Webhook Setup Guide →

Instant Live or Staged Draft

Choose between immediate live publishing or staged drafts for human editorial review before going live.

Lexical Schema Protection

Structured JSON-LD schema & FAQ accordions are wrapped in Ghost HTML cards so Ghost never mangles rich snippet scripts.

Collision-Proof Updates

Republishing fetches Ghost's current timestamp first, eliminating UpdateCollisionError on concurrent updates.

1. Understanding Ghost's API Architecture

Ghost provides two separate APIs. WonderRank requires the Admin API Key because:

Content API (Read-Only)

Designed for frontend rendering (Next.js, Gatsby). It has no write endpoints and cannot create or update posts. WonderRank ignores this key.

Admin API (Read & Write)

The only official API capable of creating drafts, publishing posts, updating metadata, and managing tags with short-lived HMAC-SHA256 tokens.

Ghost Starter Plan Limitation:

If you are hosted on Ghost(Pro), custom integrations are blocked on the $9–$11/mo Starter tier. You need a Ghost Creator, Team, or Business plan, or any self-hosted Ghost install (where the Admin API is 100% unlocked).

2. Step-by-Step Setup Guide

Connect your Ghost publication to WonderRank in less than 60 seconds:

1

Open Ghost Admin → Settings → Integrations

Log into your Ghost admin panel (usually at yourdomain.com/ghost/), click the Settings (gear icon) at the bottom-left, and select Integrations.

2

Add Custom Integration

Scroll to the bottom under Custom Integrations and click Add custom integration. Name it "WonderRank" and click Create.

3

Copy Admin API Key & API URL

Copy the Admin API Key (formatted as 64a7c...:abcdef01...) and the API URL. Keep the Admin API key secret. (Ignore the Content API Key).

4

Paste in WonderRank Integrations

In your WonderRank dashboard, open Integrations → Ghost, paste your Site URL and Admin API Key, choose your default publish mode (Draft vs. Live), and click Connect & Save Ghost.

3. What Gets Published

WonderRank synchronizes every SEO and media attribute into Ghost's native schema:

WonderRank FieldGhost FieldNotes & Guarantees
titletitleMain article headline. Rendered as single <h1> in Ghost themes.
slugslugCanonical post URL path: yourdomain.com/{slug}/
html_body + schemahtmlPassed via ?source=html. JSON-LD schema is encapsulated in <!--kg-card-begin: html--> to prevent Lexical corruption.
seo_titlemeta_titleSERP page title displayed in Google search results.
meta_descriptionmeta_description & custom_excerptPopulates both Google search meta description and the Ghost post excerpt.
featured_imagefeature_image + og_imageHigh-resolution cover image + alt tag across Google, OpenGraph, and Twitter.
primary_keywordtags[0]Elevated to primary tag, controlling post category badges in Ghost themes.
publish_modestatus"published" (instant live) or "draft" (review mode).

4. Topical Clusters, Primary Tags & Post Scope (Articles Only)

WonderRank exclusively publishes blog articles into Ghost Posts (/ghost/api/admin/posts/) and never creates or modifies static Ghost Pages (/pages/) or site navigation menus:

Ghost Posts Only (Blog Stream)

All pillar and supporting cluster articles are published to /ghost/api/admin/posts/ so they appear in your blog index, tag archives, and RSS feeds without altering static pages.

Primary Tag Silos & Internal Links

Your article's primary keyword and pillar category are assigned to tags, while contextual links between cluster articles and pillar hubs are woven directly into the HTML body.

Ghost Navigation Prompt

Ghost does not allow third-party integrations to edit your theme navigation menus automatically. Use this guide to set up hub-and-spoke links:

I am using WonderRank to automate SEO blog publishing to my Ghost site. Articles are published directly to /posts/ with Lexical-safe JSON-LD schema cards, OpenGraph metadata, and primary category tags.

In Ghost Admin, help me verify:
1. Under Settings → Navigation, my primary menu includes a link to my blog index or primary topic tag archive (e.g. /tag/seo-strategy/) so search crawlers discover new articles immediately.
2. My Ghost theme's post.hbs template renders {{title}} as the single <h1> on the page, and renders {{content}} below it without wrapping the body in a second <h1>.

5. Troubleshooting & Common Issues

403 Forbidden (Ghost Starter Plan)

Ghost(Pro) blocks the Admin API on their lowest Starter plan. If you see this error, upgrade to Ghost Creator/Team, or point WonderRank to any self-hosted Ghost installation on DigitalOcean, AWS, or Hetzner.

401 Unauthorized (Invalid Token)

Verify that you copied the Admin API Key (contains a colon like id:secret), and not the Content API Key. If the custom integration was deleted or regenerated in Ghost Admin, copy the updated key.

409 Conflict (UpdateCollisionError)

Ghost prevents accidental overwrites when another editor is modifying a post simultaneously. WonderRank automatically fetches the latest updated_at timestamp before updating to prevent collision drops.