---
title: GET /api/v2/mediaのリクエストはどのように行えば良い？
description: → 他のAPIとリクエスト方法が異なるため、手順をご説明します。
---

[コンテンツまでスキップ](https://help.microcms.io/ja/knowledge/management-api-get-media-token#main-content)

[![logo.png\]](https://help.microcms.io/hs-fs/hubfs/logo.png?width=150&height=34&name=logo.png)](https://microcms.io/)

メインナビゲーションを開く

メインナビゲーションを閉じる

 キーワードから探す

- 検索フィールドが空なので、候補はありません。

1. [ヘルプ](https://help.microcms.io/ja/knowledge?hsLang=ja)
2. [実装（全般）](https://help.microcms.io/ja/knowledge/%E5%AE%9F%E8%A3%85%E5%85%A8%E8%88%AC?hsLang=ja)
3. [API](https://help.microcms.io/ja/knowledge/%E5%AE%9F%E8%A3%85%E5%85%A8%E8%88%AC?hsLang=ja#api)

# GET /api/v2/mediaのリクエストはどのように行えば良い？

## → 他のAPIとリクエスト方法が異なるため、手順をご説明します。

マネジメントAPIにてご用意している、メディア取得用のエンドポイント **"[GET /api/v2/media](https://document.microcms.io/management-api/get-media-v2)"** では、limitの件数を超えたメディアを取得する際に [token](https://document.microcms.io/management-api/get-media-v2#hd83587df8f) というクエリパラメータをご利用いただけます。

この記事では "token" を使ったリクエスト方法をご説明します。

GET /api/v1/media では、10,000件より多いメディア情報を取得する場合（offsetに10,000件以上の値を設定する場合）、正常にデータが取得できない不具合がございました。  
GET /api/v2/media では、上記の方法で、**10,000件より多いメディア情報も取得することが可能**となっています。

### 前提

前提として、**200件のメディア**がアップロードされているサービスがあり、それらのメディア情報の一覧を取得するユースケースを考えます。

### 準備

APIキー管理にて、利用するAPIキーの権限としてマネジメントAPIの「メディアの取得」をONにしてください。

![CleanShot 2023-12-05 at 15.45.21](https://help.microcms.io/hs-fs/hubfs/CleanShot%202023-12-05%20at%2015.45.21.png?width=688&height=411&name=CleanShot%202023-12-05%20at%2015.45.21.png)

### リクエスト方法

#### 1. 初回のリクエストを送信する

まず、\`**https://xxxxxxxx.microcms-management.io/api/v2/media?limit=100**\`の形式で初回のリクエストを送信します。

レスポンスは以下のようになります。

```
{    "media": [        {            "height": 95,            "id": "e5df52e8-0fae-4de7-a8aa-24dfb9a7397b",            "url": "https://images.microcms-assets.io/assets/b82a6411a96347e392b4195a9bcc69cb/3ca8e432199b484f89dd9bbba75d2a79/image200.png",            "width": 121        },        {            "height": 95,            "id": "25559d37-d476-441d-a4af-690a9fcb0976",            "url": "https://images.microcms-assets.io/assets/b82a6411a96347e392b4195a9bcc69cb/a721d9ee85f34fe0a44fc5c828b27111cimage199.png",            "width": 121        },        {            "height": 95,            "id": "169d5c16-bef4-4504-b6b3-d92bc59bba72",            "url": "https://images.microcms-assets.io/assets/b82a6411a96347e392b4195a9bcc69cb/cfb15bfa27764f40b9cd5aec9155816e/image198.png",            "width": 121        }        ...（以下、省略）    ],    "token": "FGluY2x1ZGVfY29udGV4dF91dWlkDnF1ZXJ5VGhlbkZldGNoBRZ6aS1MUkZEYVFtNllaV2pGYmVGbG1RAAAAAAAbrkkWUmQ4OFFIV3FTUG02ZER6ZXBtTmZfURZQNWlJajVBNFQtYVV1SHI5OGQtNFNRAAAAAAJgobIWWFR2NGNua25UQml3RDJUeDNraHk5dxZ6aS1MUkZEYVFtNllaV2pGYmVGbG1RAAAAAAAbrkoWUmQ4OFFIV3FTUG02ZER6ZXBtTmZfURZQNWlJajVBNFQtYVV1SHI5OGQtNFNRAAAAAAJgobMWWFR2NGNua25UQml3RDJUeDNraHk5dxZ6aS1MUkZEYVFtNllaV2pGYmVGbG1RAAAAAAAbrksWUmQ4OFFIV3FTUG02ZER6ZXBtTmZfUQ==",    "totalCount": 200}
```

このとき、limitは100なので、1〜100件目のメディア情報が取得できます（※メディアの取得順は、作成日時の降順となります）。

また、レスポンス内に **token** が含まれるので、こちらを次回以降のリクエスト時に利用します。

- [limit](https://document.microcms.io/management-api/get-media-v2#h4cd61f9fa1) および [imageOnly](https://document.microcms.io/management-api/get-media-v2#h1a30ede53f) パラメータを付与する際は、初回のリクエスト時のみが有効となります（token を使ったリクエストでは指定できません）。
- 初回リクエスト時、続きのメディア情報がない場合も token はレスポンスに含まれます。

### 2. token を利用したリクエストを送信する

次に、\`**https://xxxxxxxx.microcms-management.io/api/v2/media?token=FGluY2x......(略)**\`の形式でリクエストを送信します。クエリパラメータの token には、初回のレスポンスに含まれる token の値を指定します。

レスポンスは以下のようになります。

```
{    "media": [        {            "height": 1652,            "id": "e5c54cd5-b5dd-4c1e-b093-ae5134fcd7fc",            "url": "https://images.microcms-assets.io/assets/b82a6411a96347e392b4195a9bcc69cb/576db30c59074bb599c1fe467da37d07/image100.png",            "width": 2490        },        {            "height": 1246,            "id": "baff3755-2872-4b5d-933f-bd5cc6ae6072",            "url": "https://images.microcms-assets.io/assets/b82a6411a96347e392b4195a9bcc69cb/972fbe52260e4c158670dd05ee837088/image99.png",            "width": 1592        },        {            "height": 630,            "id": "b0fe7f64-d66e-4b32-881b-fcc6d766b2ba",            "url": "https://images.microcms-assets.io/assets/b82a6411a96347e392b4195a9bcc69cb/18510f469c254dd09f19d924b32cbff1/image98.png",            "width": 1200        }         ...（以下、省略）    ],    "token": "FGluY2x1ZGVfY29udGV4dF91dWlkDnF1ZXJ5VGhlbkZldGNoBRZ6aS1MUkZEYVFtNllaV2pGYmVGbG1RAAAAAAAbrkkWUmQ4OFFIV3FTUG02ZER6ZXBtTmZfURZQNWlJajVBNFQtYVV1SHI5OGQtNFNRAAAAAAJgobIWWFR2NGNua25UQml3RDJUeDNraHk5dxZ6aS1MUkZEYVFtNllaV2pGYmVGbG1RAAAAAAAbrkoWUmQ4OFFIV3FTUG02ZER6ZXBtTmZfURZQNWlJajVBNFQtYVV1SHI5OGQtNFNRAAAAAAJgobMWWFR2NGNua25UQml3RDJUeDNraHk5dxZ6aS1MUkZEYVFtNllaV2pGYmVGbG1RAAAAAAAbrksWUmQ4OFFIV3FTUG02ZER6ZXBtTmZfUQ==",    "totalCount": 200}
```

このとき、初回に指定したlimitの条件（limit=100）は引き継がれるので、101〜200件目のメディア情報が取得できます。

このように、token を利用しリクエストをすることで、200件のメディア情報を取得することができました。

- **token の有効期限は15秒です。**（ただし、15秒を超えた後も一定期間、トークンは有効な場合があります。）
- メディアの件数がより多い場合は、ここからさらにリクエストを続けてお送りいただくことで、201件目〜300件目、301件目〜400件目...、といった形でメディア情報が取得可能です。

### サンプルコード

以下はfetch APIを用いて、100件を超えるメディア情報を全件取得するスクリプト（Node.js）の実装例になります。

```
const apiKey = 'XXXXXXXXXX'; // ここに実際のAPIキーを設定してくださいconst apiUrl = 'https://xxxxx.microcms-management.io/api/v2/media'; // xxxxxにサービスIDを設定してください// マネジメントAPIのレートリミットは10回／10秒なので、 それぞれ下記のように定義する// 参考: https://document.microcms.io/manual/limitationsconst rateLimit = 10;const rateLimitInterval = 10 * 1000; // ミリ秒単位で指定するasync function fetchData() {  let token = null;  const data = [];  // リクエストヘッダーにAPIキーを追加  const headers = {    'X-MICROCMS-API-KEY': apiKey,  };  async function sendRequest(url) {    // レートリミットに抵触しないようにリクエストを送信    await new Promise((resolve) => setTimeout(resolve, rateLimitInterval / rateLimit));    return await fetch(url, { headers });  }  // 初回のリクエスト  const initialRequestUrl = `${apiUrl}?limit=100`  const initialResponse = await sendRequest(initialRequestUrl);  const initialData = await initialResponse.json();  data.push(...initialData.media);  token = initialData.token;  // 2回目以降のリクエスト  while (token) {    const nextRequestUrl = `${apiUrl}?token=${token}`;    const nextResponse = await sendRequest(nextRequestUrl);    if (nextResponse.status === 404) {      // データがない場合、終了      return data;    }    const nextData = await nextResponse.json();    data.push(...nextData.media);    token = nextData.token;  }  return data;}// fetchData関数を呼び出してデータを取得fetchData()  .then(data => {    console.log('取得したデータ:', data);  })  .catch(error => {    console.error('エラーが発生しました:', error);  });
```

▼実行結果（コンソールの出力）

```
取得したデータ: [  {    height: 100,    id: '8f7caf39-18eb-44c4-b5b1-2ee5e48fda6e',    url: 'https://images.microcms-assets.io/assets/b043d614d8194195a6cfa01b5857aa83/4c0e5314c50f4736ab190fce761d1db2/sample200.png',    width: 100  },  {    height: 100,    id: 'db1b07ea-a834-4ed9-ab0b-8440edf84e4e',    url: 'https://images.microcms-assets.io/assets/b043d614d8194195a6cfa01b5857aa83/300f59d4858e4d36b1394f44c92db83c/sample199.png',    width: 100  },  {    height: 100,    id: '240d8e8b-ce2f-40a2-8892-85f3fb27b0aa',    url: 'https://images.microcms-assets.io/assets/b043d614d8194195a6cfa01b5857aa83/cffd3e6ac4f54d6d9d61ea8f809548c7/sample198.png',    width: 100  },  {    height: 100,    id: 'ef19efcf-53c6-410b-943a-80d908f9e8db',    url: 'https://images.microcms-assets.io/assets/b043d614d8194195a6cfa01b5857aa83/36a1ce031b5b4572a9abe71e2da98077/sample197.png',    width: 100  },　　（...以下略）]
```

#### **参考**

1. [制限事項／注意事項｜microCMSドキュメント](https://document.microcms.io/manual/limitations)
2. [GET /api/v2/media｜microCMSドキュメント](https://document.microcms.io/management-api/get-media-v2)

- [アカウント](https://help.microcms.io/ja/knowledge/%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88?hsLang=ja#main-content)

    - [ログイン](https://help.microcms.io/ja/knowledge/%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88?hsLang=ja#%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3)
    - [登録／変更／削除](https://help.microcms.io/ja/knowledge/%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88?hsLang=ja#%E7%99%BB%E9%8C%B2%E5%A4%89%E6%9B%B4%E5%89%8A%E9%99%A4)
    - [その他](https://help.microcms.io/ja/knowledge/%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88?hsLang=ja#%E3%81%9D%E3%81%AE%E4%BB%96)
- [機能](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#main-content)

    - [コンテンツ](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E3%82%B3%E3%83%B3%E3%83%86%E3%83%B3%E3%83%84)
    - [リッチエディタ](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E3%83%AA%E3%83%83%E3%83%81%E3%82%A8%E3%83%87%E3%82%A3%E3%82%BF)
    - [コンテンツAPI（GET）](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E3%82%B3%E3%83%B3%E3%83%86%E3%83%B3%E3%83%84apiget)
    - [コンテンツAPI（WRITE）](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E3%82%B3%E3%83%B3%E3%83%86%E3%83%B3%E3%83%84apiwrite)
    - [マネジメントAPI](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E3%83%9E%E3%83%8D%E3%82%B8%E3%83%A1%E3%83%B3%E3%83%88api)
    - [Webhook](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#webhook)
    - [インポート / エクスポート](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E3%82%A4%E3%83%B3%E3%83%9D%E3%83%BC%E3%83%88-%E3%82%A8%E3%82%AF%E3%82%B9%E3%83%9D%E3%83%BC%E3%83%88)
    - [API設定](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#api%E8%A8%AD%E5%AE%9A)
    - [レビュー](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC)
    - [メディア（画像/ファイル）](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E3%83%A1%E3%83%87%E3%82%A3%E3%82%A2%E7%94%BB%E5%83%8F-%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB)
    - [メンバー](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E3%83%A1%E3%83%B3%E3%83%90%E3%83%BC)
    - [権限](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E6%A8%A9%E9%99%90)
    - [複数環境](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E8%A4%87%E6%95%B0%E7%92%B0%E5%A2%83)
    - [セキュリティ](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E3%82%BB%E3%82%AD%E3%83%A5%E3%83%AA%E3%83%86%E3%82%A3)
    - [その他](https://help.microcms.io/ja/knowledge/%E6%A9%9F%E8%83%BD?hsLang=ja#%E3%81%9D%E3%81%AE%E4%BB%96)
- [実装（全般）](https://help.microcms.io/ja/knowledge/%E5%AE%9F%E8%A3%85%E5%85%A8%E8%88%AC?hsLang=ja#main-content)

    - [トラブルシューティング](https://help.microcms.io/ja/knowledge/%E5%AE%9F%E8%A3%85%E5%85%A8%E8%88%AC?hsLang=ja#%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0)
    - [ユースケース別の実装方法](https://help.microcms.io/ja/knowledge/%E5%AE%9F%E8%A3%85%E5%85%A8%E8%88%AC?hsLang=ja#%E3%83%A6%E3%83%BC%E3%82%B9%E3%82%B1%E3%83%BC%E3%82%B9%E5%88%A5%E3%81%AE%E5%AE%9F%E8%A3%85%E6%96%B9%E6%B3%95)
    - [API](https://help.microcms.io/ja/knowledge/%E5%AE%9F%E8%A3%85%E5%85%A8%E8%88%AC?hsLang=ja#api)
    - [Webhook](https://help.microcms.io/ja/knowledge/%E5%AE%9F%E8%A3%85%E5%85%A8%E8%88%AC?hsLang=ja#webhook)
    - [インフラ](https://help.microcms.io/ja/knowledge/%E5%AE%9F%E8%A3%85%E5%85%A8%E8%88%AC?hsLang=ja#%E3%82%A4%E3%83%B3%E3%83%95%E3%83%A9)
- [実装（言語／フレームワーク）](https://help.microcms.io/ja/knowledge/%E5%AE%9F%E8%A3%85%E8%A8%80%E8%AA%9E%E3%83%95%E3%83%AC%E3%83%BC%E3%83%A0%E3%83%AF%E3%83%BC%E3%82%AF?hsLang=ja#main-content)

    - [JavaScript](https://help.microcms.io/ja/knowledge/%E5%AE%9F%E8%A3%85%E8%A8%80%E8%AA%9E%E3%83%95%E3%83%AC%E3%83%BC%E3%83%A0%E3%83%AF%E3%83%BC%E3%82%AF?hsLang=ja#javascript)
    - [Next.js](https://help.microcms.io/ja/knowledge/%E5%AE%9F%E8%A3%85%E8%A8%80%E8%AA%9E%E3%83%95%E3%83%AC%E3%83%BC%E3%83%A0%E3%83%AF%E3%83%BC%E3%82%AF?hsLang=ja#next-js)
- [お支払い](https://help.microcms.io/ja/knowledge/%E3%81%8A%E6%94%AF%E6%89%95%E3%81%84?hsLang=ja#main-content)

    - [従量課金](https://help.microcms.io/ja/knowledge/%E3%81%8A%E6%94%AF%E6%89%95%E3%81%84?hsLang=ja#%E5%BE%93%E9%87%8F%E8%AA%B2%E9%87%91)
    - [プラン変更](https://help.microcms.io/ja/knowledge/%E3%81%8A%E6%94%AF%E6%89%95%E3%81%84?hsLang=ja#%E3%83%97%E3%83%A9%E3%83%B3%E5%A4%89%E6%9B%B4)
    - [解約](https://help.microcms.io/ja/knowledge/%E3%81%8A%E6%94%AF%E6%89%95%E3%81%84?hsLang=ja#%E8%A7%A3%E7%B4%84)
    - [請求書](https://help.microcms.io/ja/knowledge/%E3%81%8A%E6%94%AF%E6%89%95%E3%81%84?hsLang=ja#%E8%AB%8B%E6%B1%82%E6%9B%B8)
    - [支払いサイクル](https://help.microcms.io/ja/knowledge/%E3%81%8A%E6%94%AF%E6%89%95%E3%81%84?hsLang=ja#%E6%94%AF%E6%89%95%E3%81%84%E3%82%B5%E3%82%A4%E3%82%AF%E3%83%AB)
- [ご契約](https://help.microcms.io/ja/knowledge/%E3%81%94%E5%A5%91%E7%B4%84?hsLang=ja#main-content)

    - [Hobbyプラン](https://help.microcms.io/ja/knowledge/%E3%81%94%E5%A5%91%E7%B4%84?hsLang=ja#hobby%E3%83%97%E3%83%A9%E3%83%B3)
    - [Enterpriseプラン](https://help.microcms.io/ja/knowledge/%E3%81%94%E5%A5%91%E7%B4%84?hsLang=ja#enterprise%E3%83%97%E3%83%A9%E3%83%B3)
- [セキュリティ](https://help.microcms.io/ja/knowledge/%E3%82%BB%E3%82%AD%E3%83%A5%E3%83%AA%E3%83%86%E3%82%A3?hsLang=ja#main-content)

    - [シングルサインオン](https://help.microcms.io/ja/knowledge/%E3%82%BB%E3%82%AD%E3%83%A5%E3%83%AA%E3%83%86%E3%82%A3?hsLang=ja#%E3%82%B7%E3%83%B3%E3%82%B0%E3%83%AB%E3%82%B5%E3%82%A4%E3%83%B3%E3%82%AA%E3%83%B3)
- [既知の不具合](https://help.microcms.io/ja/knowledge/%E6%97%A2%E7%9F%A5%E3%81%AE%E4%B8%8D%E5%85%B7%E5%90%88?hsLang=ja#main-content)

    - [旧リッチエディタ](https://help.microcms.io/ja/knowledge/%E6%97%A2%E7%9F%A5%E3%81%AE%E4%B8%8D%E5%85%B7%E5%90%88?hsLang=ja#%E6%97%A7%E3%83%AA%E3%83%83%E3%83%81%E3%82%A8%E3%83%87%E3%82%A3%E3%82%BF)
- [その他](https://help.microcms.io/ja/knowledge/%E3%81%9D%E3%81%AE%E4%BB%96?hsLang=ja)

株式会社microCMS