こんにちは！更新情報のお知らせです。

メディア一覧取得のマネジメントAPIが拡張され、より便利にお使いいただけるようになりました。
この記事ではAPIの変更内容についてご紹介します。

APIの詳細については、ドキュメントの「GET /api/v2/media」をご覧ください。

メディア一覧取得APIの変更点

今回の変更は次の2点です。

レスポンスに「メディアタグ」「作成日時」「更新日時」を追加
クエリパラメータに「メディアタグ」「代替テキスト（画像alt）」を追加

それぞれ詳しくご紹介します。

レスポンスに「メディアタグ」「作成日時」「更新日時」を追加

メディア一覧取得APIのレスポンスは以下のようになっています。

{
  "media": [
    {
      "id": "42420d9f-1406-47ee-a8ff-6b32c23ec957",
      "createdAt": "2025-02-28T05:34:48.722Z",
      "updatedAt": "2026-04-08T01:32:39.694Z",
      "url": "https://images.microcms-assets.io/assets/xxxxxxxxx/yyyyyyyyy/illustration.png",
      "width": 1504,
      "height": 1128,
      "tags": [
        "イラスト",
        "drawings"
      ]
    },
    {
      "id": "7284cdc9-d380-47b4-86a2-09b23be82986",
      "createdAt": "2026-04-08T01:32:10.812Z",
      "updatedAt": "2026-04-08T01:32:22.642Z",
      "url": "https://images.microcms-assets.io/assets/xxxxxxxxx/zzzzzzzzzzzzz/dog.png",
      "width": 1024,
      "height": 1024,
      "alt": "walking with dog in the park",
      "tags": []
    }
  ],
  "totalCount": 2,
  "token": "FGluY2x1ZGVfY29ud...R0cHljVU5KUQ==" // 一部省略
}

これまでと比べて、tags createdAt updatedAt の3つが追加されています。

メディアタグについてはドキュメントの「メディアのタグ設定」をご覧ください。

クエリパラメータに「メディアタグ」「代替テキスト（画像alt）」を追加

メディア一覧取得APIではクエリパラメータを指定することで取得するメディアを絞り込むことができます。

これまではファイル名での絞り込み（fileName ）、画像のみを取得（imageOnly）のオプションを指定できましたが、さらに2種類のオプションが追加されました。

メディアタグでの絞り込み

tags=drawings のように指定することで、そのタグが含まれたメディアのみを取得できます。

メディアタグはカンマ区切りで複数指定できます。 tags=drawings,animals のように指定した場合、 drawings と animals の両方のタグがセットされたメディアが取得されます。

代替テキスト（画像alt）での絞り込み

alt=dog のように指定することで、その値がaltに含まれるメディアのみを取得できます。

どちらもメディア取得が柔軟にできるアップデートとなっています。ぜひお試しください。

おわりに

今回はメディア一覧取得のマネジメントAPIの拡張について紹介しました。

より使いやすいサービスを目指してAPI、管理画面ともに改善してまいります。ご要望などございましたら管理画面右下のチャットボタンよりご意見いただけますと幸いです。