Ghost

The Ghost integration publishes Grandranker articles straight to your Ghost publication using Ghost's Admin API. It works with both Ghost(Pro) and self-hosted Ghost sites. You create a custom integration in Ghost, paste its Admin API key into Grandranker, and choose whether new posts land as drafts or go live immediately.

How to Connect

1. Log in to your Ghost Admin panel.
2. Go to Settings → Integrations.
3. Click Add Custom Integration and name it (e.g. "GrandRanker").
4. Copy the Admin API Key. It looks like id:secret.
5. In Grandranker, open Integrations, pick Ghost, and fill in the form:
   • Admin URL: your Ghost site address, e.g. https://yourblog.ghost.io.
   • Admin API Key: the id:secret key from step 4.
   • Default Status: Draft or Published. Draft means every article arrives in Ghost for you to review. Published means posts go live on your blog immediately.
6. Click Test Connection. You should see "Connection successful!".
7. Click Save & Connect.

Publishing & Verifying

After connecting, articles publish to Ghost as posts with your chosen default status. Articles approved on the Content Planner publish automatically on their scheduled date.

To verify:

• Publish one article from Grandranker.
• Open Ghost Admin → Posts. The article should appear as a draft or published post, depending on your Default Status.
• If it published live, open the post URL on your site and check the formatting.

To disconnect later, open the Ghost integration page and click Disconnect. Your existing Ghost posts are not touched.

Troubleshooting

Test Connection fails

• Check the Admin URL. It must be the root of your Ghost site (e.g. https://yourblog.ghost.io), with https://, and no trailing path like /ghost.
• Check the Admin API Key. It must be the Admin API Key from your custom integration, not the Content API Key. It contains a colon (id:secret). Copy the whole string.
• If your Ghost site sits behind a firewall or security plugin, make sure it doesn't block requests to /ghost/api/admin/.

"Failed to test connection. Please check your credentials and try again."

This usually means the request never reached Ghost. A wrong URL, a site that's offline, or a network block could be the issue. Confirm the site loads in your browser at the exact Admin URL you entered.

Posts arrive but nothing goes live

Your Default Status is set to Draft. Drafts wait in Ghost Admin for your review. Switch Default Status to Published on the integration page and save if you want articles to go live automatically.

The key stopped working

If you delete or regenerate the custom integration in Ghost, the old key becomes invalid and publishing fails. Create the integration again in Ghost, copy the new Admin API Key, and re-save the Grandranker form with it.

Questions? Contact us at [email protected].