Ghost

Rankturn publishes articles directly to your self-hosted or Ghost(Pro) site. Each article becomes a Ghost post, carrying across its title, content, feature image, excerpt, meta description, slug, canonical URL, and tags. The images in your article and its thumbnail are copied into your Ghost media library, so once a post is live it no longer depends on Rankturn.

Your connection stays secure: Rankturn signs in to your site fresh on each publish using your Admin API key, and nothing is shared with Ghost ahead of time beyond your site URL and that key.

Connecting

Connect Ghost from Settings → Integrations. Find the Ghost card and click Connect (or Edit settings to update an existing connection). You will be asked for two fields.

Ghost URL

Enter the base URL of your Ghost site, for example https://your-blog.ghost.io. A trailing slash is harmless. For security, the URL must point to a real, publicly reachable site (internal or private addresses are rejected).

Admin API Key

The Admin API key authenticates Rankturn against your site. To create one:

1. Open your Ghost Admin panel
2. Go to Settings → Integrations
3. Click Add custom integration
4. Give it a name (e.g. "Rankturn") and copy the Admin API Key

The key looks like id:secret, with a colon in the middle. Paste the whole value, including the colon — a key that's missing it will be rejected.

You can also choose a default Publish Format here (see below). When editing an existing connection, leave the Admin API key field blank to keep the key you saved previously.

Testing the connection. When you connect, Rankturn checks your credentials against your Ghost site and, if everything works, shows your site's title back to you (e.g. "Connected to Ghost: My Blog").

Publish Formats

Ghost supports two publish formats. You set a default for the connection, and you can change it for any individual publication when you schedule it:

The default format is Publish — the post goes live immediately. If you want to review AI-generated output before it goes public, pick Draft when connecting. The format you set on the connection is the default; you can still change it for individual publications.

Images in your Ghost media library

When an article is published, Rankturn copies its images into your Ghost media library, so the published post serves images from Ghost itself rather than from Rankturn.

• Thumbnail → feature image. Your article's thumbnail becomes the post's feature image (keeping its alt text). It's removed from the body, because Ghost shows the feature image separately above the post.
• Inline images. Images inside the body that are hosted in Rankturn are copied over too, and the post is updated to use the new Ghost copies.
• One bad image won't stop a publish. If a single image fails to copy, the post still publishes and that one image simply keeps its original link.
• External images stay external. If your thumbnail is already hosted somewhere else (not in Rankturn), it's used as the feature image as-is and isn't copied.

The article's formatting — such as tables and lists — is preserved exactly. The post's title is shown by Ghost on its own, so it isn't repeated at the top of the body, and structured data (Schema.org) is added to help with SEO.

Title, excerpt, and meta length limits

Ghost sets strict maximum lengths on a few short fields, and it will reject the entire publish if any of them runs too long. Because AI-generated excerpts and meta descriptions often run long, Rankturn automatically trims these fields to fit before sending:

Trimming cuts at a sensible word boundary where possible and adds an ellipsis, so a slightly-too-long excerpt is shortened gracefully instead of breaking the publish. Your article's body is never trimmed — only these short fields are. If you want precise control, keep your excerpt and meta description within these limits in the Article Editor.

For where Ghost fits among the other destinations, see Integrations. To control when posts go out, see Publishing & Scheduling. For how your saved credentials are protected, see Credentials & Security.