Docs
Ghost
Publish articles straight to your Ghost blog. Each published article is created through Ghost's Admin API with its slug, SEO settings, tags, and feature image, live on your site right away.
How it works
Ghost is a publishing platform built around its blog, available hosted as Ghost(Pro) or self-hosted. With the connection in place, clicking Publish creates the article on your Ghost site through the Admin API — already published, at its own slug, with the SEO settings filled in. It appears on your live site right away, with nothing to do in Ghost Admin.
Before you start
- You need admin access to the Ghost site, since custom integrations are created in Ghost Admin's settings.
- Works with Ghost(Pro) and self-hosted Ghost version 5 or newer. Your site must be reachable over public https.
Connect Ghost
- In Ghost Admin, open Settings → Integrations and click Add custom integration.
- Name it "blogr" and copy the Admin API key it shows. The Content API key isn't used.
- In your blogr.ai dashboard, open Setup → Publishing, choose Ghost, then paste your site URL and the Admin API key.
- Save. We verify the URL answers as a Ghost site and that the key works before the connection is stored.
A website publishes to one destination, so connecting Ghost replaces any other integration on the website.
What gets published
- The article body lands as the post content: headings, paragraphs, lists, links, and images.
- The article's slug becomes the post's URL, the SEO page title and meta description fill Ghost's meta fields, and the meta description doubles as the post excerpt.
- Categories and tags merge into the post's tag list.
- The generated share image becomes the post's feature image, with its alt text.
The article's URL on your site is recorded on the article in your workspace.
Failed deliveries and retries
If Ghost rejects a publish, say a revoked key, an offline site, or a rate limit, the article is marked "Failed to publish" in your workspace with the reason on the row. Fix the cause (or reconnect in Setup → Publishing) and click Retry publish.
Good to know
- Publishing an article again updates the post at the same slug in place — its URL, and the rankings attached to it, survive.
- Your Admin API key is stored encrypted and is never shown again after saving. Paste a new one anytime to rotate it.
- Deleting the custom integration in Ghost Admin revokes the key and breaks the connection. If that happens, create a new one and reconnect.
- Posts are created under Ghost's default author (the site owner). Reassign authors in Ghost Admin if you want a different byline.