Ghost integration

Connect Ghost through a custom integration and publish OverSerp posts with the Admin API.

OverSerp publishes to Ghost using the Admin API and a custom integration key. It works with Ghost(Pro) and self-hosted Ghost 5.x.

Step 1: Create a custom integration

  1. In Ghost admin open Settings → Integrations.
  2. Click Add custom integration and name it OverSerp.

Step 2: Copy the credentials

On the integration screen copy:

  • API URL, for example https://yourblog.ghost.io
  • Admin API key, in the format id:secret

Do not use the Content API key; it's read-only.

Step 3: Connect in OverSerp

  1. Open your site → Integrations → Ghost.
  2. Paste the API URL and the Admin API key.
  3. Choose Publish or Draft.
  4. Save. OverSerp signs a short-lived token with your key and checks access to your site.

What gets published

Ghost fieldValue
TitleArticle title
SlugSEO slug
ContentHTML (converted to Ghost's editor format by Ghost)
Custom excerptExcerpt (max 300 characters)
Meta descriptionMeta description
Code injection (head)Article + FAQPage JSON-LD
Statuspublished or draft

Troubleshooting

“Admin API key must look like id:secret”: you pasted the Content API key or only part of the Admin key.

401 / invalid token: the key was regenerated in Ghost. Copy the new one.

Custom integrations unavailable: your Ghost(Pro) plan doesn't include integrations. Upgrade or use the webhook.

Stuck? Email hello@overserp.com with your site URL and the error shown in the dashboard. A human answers.

← PreviousShopify integrationNext →Webhook reference