# Ghost (/docs/ghost)



The Ghost integration publishes articles from EarlySEO to your Ghost CMS blog using the **Ghost Admin API**. You will need your Ghost site URL and an Admin API key.

Prerequisites [#prerequisites]

* A Ghost site (Ghost.io or self-hosted)
* Ghost Admin access to create an integration and copy the API key
* An EarlySEO account

Setup [#setup]

1. Create a Ghost Admin API key [#1-create-a-ghost-admin-api-key]

1. In Ghost Admin, go to **Settings - Integrations**
2. Click **Add custom integration** and name it "EarlySEO"
3. Copy:
   * **Admin API key** (format: `id:secret`)
   * **API URL** (your Ghost site URL, e.g. `https://yourblog.ghost.io`)

2. Create the integration in EarlySEO [#2-create-the-integration-in-earlyseo]

1. Go to **Integrations** in your EarlySEO dashboard
2. Click **Add Integration** and select **Ghost**
3. Fill in the form:

| Field                 | Description                                                    |
| --------------------- | -------------------------------------------------------------- |
| **Ghost URL**         | Your Ghost site URL, e.g. `https://yourblog.ghost.io`          |
| **Admin API Key**     | Format: `id:secret` from Ghost Admin - Integrations            |
| **API Version**       | Defaults to `v5.0`  change only if your Ghost version requires |
| **Publishing Status** | Publish Immediately or Save as Draft                           |

4. Click **Create Integration**

Troubleshooting [#troubleshooting]

**Authentication fails**

* Use the **Admin API key**, not the Content API key (Content API keys are read-only)
* The format must be `id:secret` with a colon separating the values

**Wrong URL**

* Use your canonical Ghost URL including `https://`
* For Ghost.io: `https://yoursite.ghost.io`
* For self-hosted: `https://yourdomain.com`