Skip to main content
The Ghost connector creates posts on your Ghost site (Ghost(Pro) or self-hosted, version 5+) through the Ghost Admin API. Posts go live as published, with title, slug, excerpt, feature image, SEO meta and structured data filled in.

Before you start

  • You need to be an Administrator or Owner of the Ghost site — only they can add custom integrations.

Step 1 — Create a custom integration in Ghost

  1. In Ghost Admin, open Settings and go to Integrations (in Ghost 5 it sits under Advanced in the settings sidebar). Click Add custom integration.
Ghost settings scrolled to the Advanced section, with Integrations selected in the sidebar and the Add custom integration button highlighted

Settings → Integrations → Add custom integration

  1. Name it SEO Sorted and click Add.
Ghost Add integration dialog with the name SEO Sorted and the Add button highlighted

Name the integration

  1. Ghost opens the integration. Keep this page open — you need two values from it:
    • Admin API key — 24 characters, a colon, then 64 characters.
    • API URL — usually your site address, e.g. https://yourblog.ghost.io.
Ghost custom integration SEO Sorted showing Content API key, a partly masked Admin API key and the API URL

The integration's keys — copy the Admin API key and the API URL

Copy the Admin API key, not the Content API key. The Content API key is read-only and has a different shape, so it is refused before we even contact Ghost.

Step 2 — Connect in SEO Sorted

Project Settings → Integrations → Ghost → Connect.
Connect Ghost dialog with setup steps, and Ghost API URL and Admin API key fields

The Ghost connect form

string
required
The API URL from step 1. A bare domain is fine (https:// is added), and /ghost on the end is stripped.
string
required
The Admin API key from step 1. Stored encrypted.
We call your Ghost site with the key before saving, so a wrong URL or key fails here rather than on your first publish. There is nothing to configure after connecting.

Step 3 — Publish

Open an article, click Publish, then Publish now next to Ghost. The dialog confirms Article Published — “Successfully published to your Ghost site” — with a View article button for the live post.

What gets published

Only the Facebook (Open Graph) card is filled. X/Twitter card fields are left empty, so Ghost falls back to its own defaults for them.

Re-publishing, unpublishing and deleting

  • Re-publish updates the same Ghost post in place — never a duplicate. If the post was deleted in Ghost, a new one is created.
  • Unpublish moves the post back to Draft in Ghost.
  • After an unpublish, SEO Sorted forgets the post. Publishing the article again creates a new Ghost post; the earlier draft stays in Ghost.
  • Deleting the article in SEO Sorted deletes the Ghost post.

Tracking AI crawlers

Ghost(Pro) requires DNS-only records, so Cloudflare can’t run in front of it and AI crawler tracking isn’t available there. On self-hosted Ghost, use Cloudflare (any site), or send visits from your web server with Any other server (API).

Common problems

The value you pasted isn’t an Admin API key — most often it’s the Content API key, which has no colon. Copy the Admin API key from the custom integration.
The key was regenerated in Ghost, or the integration was deleted. Copy the Admin API key again from Settings → Integrations → your custom integration.
Use the API URL shown on the integration. On a custom domain that redirects, try the *.ghost.io address instead.
We couldn’t open a connection to that address. Check the URL is correct and that the site is reachable from the public internet — a localhost or private-network Ghost won’t work.
Ghost converts HTML into its own cards. Anything it can’t convert is kept as an HTML card, so it still renders on the site exactly as published.