Newtの画像を一括ダウンロードする方法|エクスポートJSONには入らない

Newtの画像を一括ダウンロードする方法|エクスポートJSONには入らない

今回は、こんな疑問にお答えします。

  • Newtの画像は、エクスポートJSONに入っている?
  • 何十枚もある画像を、一括で保存できる?
  • ターミナルに慣れていなくても、できる?

こんにちは、ヘッドレスCMS「ハルCMS」を自分で作って運営しているマサトです。

Newtは2026年11月24日(火)13:59にサービスを終了します。

記事のJSONは、Professional以上なら「App設定→一般→Appのデータをエクスポートする」で保存します。

Free・SmallはNewt APIかCDN APIで取ります(公式の料金表・2026年11月5日確認)。

ただ、JSONだけでは半分しか救出できていません。

先に結論から書きます。

JSONに、画像ファイルの本体は入っていません。入っているのは {spaceUid}.assets.newt.so などNewtの配信先を指すURLだけです。

つまりサービス終了の日、記事本文は手元に残っていても、アイキャッチも本文中の画像もすべてリンク切れになります。

画像の退避は、公式の一括ダウンロードでzipにします。URLの一覧が欲しいときは、JSONから抜き出して落とす方法もあります。順番に見ていきましょう。

この記事の要点
目次

公式のzipで一括ダウンロードする

管理画面の「スペース設定 > 一般」にある「アセットの一括ダウンロード」で「ダウンロード開始」を押します。ファイルの生成には通常数分かかります。

生成が終わったら「ダウンロード」を押します。アセットの数によってファイルは複数に分かれるので、全部落としてください。スペースごとに必要です。

解凍すると、Assets APIのURLと同じフォルダ構成で入っています。移行先へ置き直すときに使うので、構成を崩さず保管してください。

公式のデータエクスポートの案内に、プランの条件は書かれていません(2026年11月5日確認)。

以下の手順0〜3は、URLの一覧が欲しいときや、zipと突き合わせたいときに使ってください。

手順0:何枚あるかを先に把握する(1分)

Newt移行チェッカー(無料・登録不要)にエクスポートJSONをドロップすると、記事数・画像数・モデル構成が数秒で分かります。解析はブラウザ内で完結し、サーバーには送信されません。

数枚なら手動で、数十枚以上なら以下のコマンドで一括退避しましょう。

手順1:JSONから画像URLを抽出する

MacのターミナルまたはWindowsのWSLで、エクスポートJSONのあるフォルダに移動して次を実行します(ファイル名は export.json に読み替えてください)。

grep -oE 'https://[^"\\)<[:space:]]+' export.json | grep -E 'assets\.newt\.so|newt-images' | sort -u > images.txt
wc -l images.txt

1行目で画像URLを重複なしで images.txt に書き出し、2行目で枚数を確認します。チェッカーの診断枚数とおおむね一致していれば抽出は成功です。

大幅に少ないときは、2023年5月29日以前に作ったスペースなどで別の形のURLが残っている可能性があります。JSONを newt で検索して確かめてください。

ターミナルに慣れていない場合は、上記の公式のzipで足ります。

手順2:一括ダウンロードする

mkdir newt-images && cd newt-images
n=0; while read -r u; do
  n=$((n+1))
  curl -fsS "$u" -o "$(printf '%04d' $n)_$(basename "${u%%\?*}")"
  sleep 0.2
done < ../images.txt
echo "done: $n files"

連番+元ファイル名で保存するので、同名ファイルがあっても上書きされません。sleep 0.2 はサーバーへの配慮です(外さないでください)。

終わったら newt-images フォルダをクラウドストレージ等にもコピーして、二重に保管しておくと安心です。

手順3:移行先での画像の扱いを決める

退避した画像は、移行先のCMSにアップロードし直し、記事内の画像URLを新しい配信URLへ書き換える必要があります。ここが移行作業でいちばん時間のかかる部分なんですよね。

なお、当社が開発するハルCMSのNewtインポータは、この「ダウンロード→再アップロード→URL書き換え」を取り込み時に自動で行います。

エクスポートJSONを取り込むと、記事と一緒に画像もハルCMS側の配信に切り替わります。

ただし枚数やサイズの上限を超えた画像と、画像以外のファイルは元のURLのまま残ります。残った画像は終了後に取り出せないので、公式のzipは別に落としてください。

Free・SmallでAPIから取ったJSONを入れたい場合は、お問い合わせから先に相談してください。

移行の全体手順はNewtからハルCMSへ移行する完全ガイド【教科書】に、移行先の比較はNewtの移行先・代替比較にまとめています。

まとめ

  • JSONに画像は入っていない(URLだけ)
  • 画像は「スペース設定 > 一般 > アセットの一括ダウンロード」でzipにする。zipは複数に分かれることがある
  • URLの一覧が欲しいときは grep で抜き出して curl のループで落とす
  • 移行先で「再アップロード→URL書き換え」が必要。画像自動取り込み対応の移行先でも、原本のzipは別に落とす

終了日が近づくほど移行系の作業は混みます。画像の退避だけでも、今日のうちにどうぞ。

制作実績

よくある質問

Newtのエクスポートに画像は含まれますか?

含まれません。JSONに記録されるのは {spaceUid}.assets.newt.so などNewtの配信先を指す画像URLだけです。画像ファイル本体は「アセットの一括ダウンロード」のzipで別に退避します。

サービス終了後も画像URLは見られますか?

見られなくなります。公式は、2026年11月24日(火)13:59に全サービスを終え、アセット情報もすべて削除すると案内しています。終了日より前に退避してください。

画像が何百枚もある場合はどうすればいいですか?

公式の「アセットの一括ダウンロード」でzipにしてください。アセットの数によってファイルは複数に分かれるので、全部落とします。ハルCMSへ移す場合も、枚数やサイズの上限を超えた画像は元のURLのまま残るので、zipは別に落としてください。

ダウンロードした画像は移行先でそのまま使えますか?

移行先のCMSにアップロードし直して、記事内の画像URLを新しい配信URLに書き換える必要があります。ハルCMSのNewtインポータはこの「ダウンロード→再アップロード→URL書き換え」を取り込み時に自動で行います。枚数やサイズの上限を超えた画像は元のURLのまま残ります。