microCMS
ドキュメント
  • 料金プラン
  • ブログ
  • よくある質問
  • お問い合わせ
  • ログイン
  • 無料ではじめる
ナビゲーション
チュートリアル
Next.js
  • Next.jsとの連携
  • Getting Started(App Router)
  • チュートリアル(App Router)
  • Getting Started(Pages Router)
  • チュートリアル(Pages Router)
Astro
  • Astroとの連携
  • Getting Started
  • チュートリアル
Nuxt
  • Nuxtとの連携
  • Getting Started
  • チュートリアル
Gatsby
  • Gatsbyとの連携
  • Getting Started
  • チュートリアル
JavaScript
  • JavaScriptとの連携
  • Getting Started(ブラウザ)
  • Getting Started(サーバー)
PHP
  • PHPとの連携
  • Getting Started
Ruby
  • Rubyとの連携
  • Getting Started
Go
  • Goとの連携
  • Getting Started
操作マニュアル
  • はじめに
アカウントとログイン
  • アカウント登録
  • ログイン
  • メールアドレス認証をする
サービス
  • サービスの作成
  • サービス設定
  • テンプレート
  • サービスの削除
お支払い
  • 料金プランの変更
  • 決済方法の登録と変更
API
  • APIの作成・管理
  • API設定
  • APIスキーマのエクスポート/インポート
フィールド
  • テキストフィールド
  • テキストエリア
  • 画像
  • 複数画像
  • 日時
  • 真偽値
  • セレクトフィールド
  • コンテンツ参照
  • 複数コンテンツ参照
  • 数字
  • ファイル
  • カスタム
  • 繰り返し
  • 拡張フィールド
コンテンツ
  • コンテンツの作成
  • コンテンツの編集
  • コンテンツ管理
  • ビュー
  • コンテンツのステータス
  • カスタムステータス
  • コンテンツIDの設定
  • コンテンツに自動付与される値
  • コンテンツのCSVエクスポート
  • コンテンツのCSVインポート
  • APIプレビュー
  • APIプレビューを活用したクエリパラメータの利用例
  • レンダリング方式ごとの組み込み方法
  • 画面プレビュー
  • コンテンツのWebhookを設定
リッチエディタ
  • リッチエディタの操作方法
  • リッチエディタのWRITE API
  • 旧リッチエディタの操作方法
レビュー機能
  • レビュー
  • AIレビュー
メディア
  • メディア管理
  • メディアのフィルター・表示順の変更
  • メディアのタグ設定
  • メディアのWebhookを設定
  • メディアのカスタムドメイン設定
権限管理
  • メンバーの管理
  • ロール(管理画面の権限管理)
複数環境
  • 複数環境(開発環境)
  • 環境間のAPI設定のマージ
外部連携
  • Amazon S3連携
データログ
  • 監査ログ
  • データ転送量
セキュリティ
  • コンテンツの更新履歴
  • 管理画面のIP制限
  • APIのIP制限
認証設定
  • 2要素認証の設定
  • 2要素認証の必須化
  • シングルサインオン
仕様・制限事項
  • 推奨環境
  • 制限事項/注意事項
コンテンツAPI
  • コンテンツAPIとは
基本操作
  • GET /api/v1/{endpoint}
  • GET /api/v1/{endpoint}/{content_id}
  • POST /api/v1/{endpoint}
  • PUT /api/v1/{endpoint}/{content_id}
  • PATCH /api/v1/{endpoint}/{content_id}
  • DELETE /api/v1/{endpoint}/{content_id}
APIキー
  • APIキー(APIの認証と権限管理)
  • 旧API(X-API-KEYなど)からの移行
レスポンスとエラー処理
  • GET APIのフィールドごとのレスポンス形式
  • GET APIにおけるクエリパラメータの指定
  • コンテンツAPIのエラーレスポンス
マネジメントAPI(ベータ)
  • マネジメントAPIとは
コンテンツ操作
  • GET /api/v1/contents/{endpoint}
  • GET /api/v1/contents/{endpoint}/{content_id}
  • PATCH /api/v1/contents/{endpoint}/{content_id}/status
  • PATCH /api/v1/contents/{endpoint}/{content_id}/createdBy
  • PUT /api/v1/contents/{endpoint}/{content_id}/reservation
メディア操作
  • GET /api/v2/media
  • GET /api/v1/media
  • POST /api/v1/media
  • DELETE /api/v2/media
メンバー操作
  • GET /api/v1/members
  • GET /api/v1/members/{member_id}
API操作
  • GET /api/v1/apis
  • GET /api/v1/apis/{endpoint}
  • POST /api/v1/apis
サービス操作
  • GET /api/v1/service
レスポンスとエラー処理
  • マネジメントAPIのエラーレスポンス
画像API
  • 画像APIとは
主なパラメータ
  • 画像サイズ
  • 品質
  • 解像度・画面サイズ
  • フォーマット
  • テキスト
  • 枠線
  • パディング
  • 形状
  • ダウンロード
  • ウォーターマーク
MCPサーバー
  • microCMS MCP
  • microCMS Document MCP Server
  • トップ
  • コンテンツAPI

GET APIにおけるクエリパラメータの指定

最終更新日: 2026/09/02

GET APIにおいて下記のクエリパラメータは、該当APIが持つスキーマ構造の内容によらずご利用いただけます。

  • draftKey
  • limit
  • offset
  • q
  • ids
  • depth(コンテンツ参照、複数コンテンツ参照のみに適用されます)
  • richEditorFormat(旧リッチエディタのみに適用されます)

一方、下記のクエリパラメータは、利用対象となるフィールドが限定され、またフィールドごとに利用方法が異なる場合もございます。

  • orders
  • fields
  • filters(equals, not_equals, less_than, greater_than, exists, not_exists, begins_with)

クエリパラメータごとの対象フィールドは以下の通りです。

orders

fields

filters
(equals, not_equals)

filters
(contains, not_contains)

filters
(less_than, greater_than)

filters
(exists, not_exists)

filters
(begins_with)

テキストフィールド

◯

◯

◯

◯

-

◯

◯

テキストエリア

◯

◯

◯

◯

-

◯

◯

リッチエディタ

-

◯

-

◯

-

◯

◯(※3)

旧リッチエディタ(非推奨)

-

◯

-

◯

-

◯

◯(※3)

画像

-

◯(※1)

-

-

-

◯

-

複数画像

-

◯(※1)

-

-

-

◯

-

日時
(自動付与される日時も含む)

◯

◯

◯

◯

◯

◯

◯(※4)

真偽値

-

◯

◯

-

-

◯(※2)

-

セレクトフィールド

-

◯

-

◯

-

◯

-

コンテンツ参照
(フィールド自体)

-

◯

◯

-

-

◯

-

コンテンツ参照
(参照先のフィールド)

-

◯

-

-

-

-

-

複数コンテンツ参照
(フィールド自体)

-

◯

-

◯

-

◯

-

複数コンテンツ参照
(参照先のフィールド)

-

◯

-

-

-

-

-

数字

◯

◯

◯

-

◯

◯

-

カスタムフィールド
(フィールド自体)

-

◯

-

-

-

-

-

カスタムフィールド
(カスタムフィールド内のフィールド)

◯

-

◯

◯

◯

◯

◯

繰り返しフィールド
(フィールド自体)

-

◯

-

-

-

-

-

繰り返しフィールド
(繰り返しフィールド内のフィールド)

◯(※5)

-

-

◯

-

◯

◯

ファイル

-

◯(※1)

-

-

-

◯

-

拡張フィールド
(拡張フィールド自体)

-

◯

-

-

-

-

-

拡張フィールド
(updatedAtメタ情報)

◯(※6)

-

◯(※6)

◯(※6)

◯(※6)

◯(※6)

◯(※6)

拡張フィールド
(updatedAt以外のメタ情報)

◯(※6)

-

◯(※6)

◯(※6)

-

◯(※6)

◯(※6)

Information
  • 「-」と表記されている箇所については、未対応または動作不定となります。
  • コンテンツ参照やカスタムフィールドなど、入れ子構造の構築が可能なフィールドについては、その下層のフィールドに対して各種クエリパラメータを指定した場合、動作が不定となる場合がございます。あらかじめご了承ください。
  • 「カスタムフィールド(カスタムフィールド内のフィールド)」および「繰り返しフィールド(繰り返しフィールド内のフィールド)」において、「◯」とされている箇所についてはフィールドによっては利用できない場合もございます。

補足事項

(※1)画像やファイル内のキー(url、width、height など)については、指定できません。
(※2)true or false、いずれの場合もコンテンツは存在するものとみなされます。
(※3)HTMLのタグを除いた文字列の前方一致となります。
(※4)開始期間の指定ではなく、日付の前方一致となります。
(※5)カスタムフィールドが複数挿入されている場合、降順と昇順で基準とする値が異なります。詳細については「繰り返しフィールド内のフィールドを指定した場合の並び順について」をご確認ください。
(※6)拡張フィールドのメタ情報のみ指定可能です。詳細については「拡張フィールド」をご確認ください。

目次

  • 補足事項
  • 運営会社
  • 特定商取引法に基づく表記
  • 利用規約
  • プライバシーポリシー

Copyright © microcms.io All rights reserved.