Migrate Blogger API

Migrate from Blogger using the Google API

This tool requires an API key, which you can get here

You also need a blog ID, which is a long number like 12345678123456781234. You can find this by viewing the source of the Blogger site and looking for blogId.

Install

To install the CLI, which is required for the Usage commands below:

npm install --global @tryghost/migrate

To use this package in your own project:

npm install @tryghost/mg-blogger --save

or

pnpm add @tryghost/mg-blogger

Usage

To run a Blogger migration, the required command is:

migrate blogger --apiKey abcd --blogID 1234

It's possible to pass more options, in order to achieve a better migration file for Ghost:

• --apiKey (required)
  • string - default: null
  • API Key
• --blogID (required)
  • array - default: null
  • Comma separated list of site IDs
• -V --verbose
  • Show verbose output
  • bool - default: false
• --zip
  • Create a zip file
  • bool - default: true
• -s --scrape
  • Configure scraping tasks
  • string - default: all
  • Choices: all, web, assets, none
    • all: Scrape web metadata and download assets
    • web: Only scrape metadata from web pages
    • assets: Only download assets (images, media, files)
    • none: Skip all scraping tasks
• --addTag
  • string - default: null
  • Provide a tag slug which should be added to every post in this migration
• --firstImageAsFeatured
  • Use the first image as the post's feature_image
  • bool - default: true
• --fallBackHTMLCard
  • Fall back to convert to HTMLCard, if standard Mobiledoc convert fails
  • bool - default: true
• --cache
  • Persist local cache after migration is complete (Only if --zip is true)
  • bool - default: true

A more complex migration command could look like this:

migrate blogger --apiKey abcd --blogID 1234, 5678 --addTag 'Blog Posts' --pages false

This will fetch posts only from 2 sites, and add a 'Blog Posts' tag to each post.

Develop

This is a mono repository, managed with Nx and pnpm workspaces.

Follow the instructions for the top-level repo.

1. git clone this repo & cd into it as usual
2. Run pnpm install to install top-level dependencies.

Run

To run a local development copy, cd into this directory, and use pnpm dev instead of migrate like so:

pnpm dev blogger --apiKey abcd --blogID 1234

Test

• pnpm lint run just eslint
• pnpm test run lint and tests

Copyright & License

Copyright (c) 2013-2026 Ghost Foundation - Released under the MIT license.