WordPress REST APIの使い方完全ガイド【基礎から応用まで】

• 別ドメインのサイトにWordPressの記事を表示する
• React・Next.jsなどのモダンなフレームワークとWordPressを組み合わせる
• スマホアプリとWordPressのデータを連携させる
• AIで生成した記事をWordPressに自動投稿する
• ChatGPT・ClaudeなどのAIとWordPressを直接つなぐ

• 投稿・固定ページ・メディアなどのデータをJSON形式で取得する
• 外部のプログラム（JavaScript・Python・PHPなど）からWordPressに記事を投稿する
• スマホアプリ・別サイト・外部サービスとWordPressを連携させる
• WordPressをヘッドレスCMSとして使い、フロントエンドを自由に構築する
• AIと連携して記事の自動生成・自動投稿を実現する

• WordPress 4.4（2015年）：REST APIの基盤が導入
• WordPress 4.7（2016年）：コンテンツエンドポイントが正式に統合され、プラグイン不要で使えるように
• WordPress 5.0以降：ブロックエディター（Gutenberg）自体がREST APIを使って動作するように

https://example.com/wp-json/wp/v2/{リソース名}

• https://example.com：WordPressサイトのURL
• /wp-json/：REST APIのベースパス（固定）
• wp/v2/：名前空間とバージョン（WordPressコアAPIはwp/v2）
• {リソース名}：取得したいデータの種類（posts・pages・mediaなど）

https://example.com/wp-json/wp/v2/posts

https://example.com/wp-json/wp/v2/posts

// 記事一覧を取得
GET https://example.com/wp-json/wp/v2/posts

// 特定の記事を取得（IDが123の記事）
GET https://example.com/wp-json/wp/v2/posts/123

// 記事を新規投稿（認証必要）
POST https://example.com/wp-json/wp/v2/posts

// 記事を更新（認証必要）
PUT https://example.com/wp-json/wp/v2/posts/123

// 記事を削除（認証必要）
DELETE https://example.com/wp-json/wp/v2/posts/123

// 固定ページ一覧を取得
GET https://example.com/wp-json/wp/v2/pages

// 特定の固定ページを取得
GET https://example.com/wp-json/wp/v2/pages/456

// メディアライブラリの一覧を取得
GET https://example.com/wp-json/wp/v2/media

// 特定のメディアを取得
GET https://example.com/wp-json/wp/v2/media/789

// カテゴリー一覧を取得
GET https://example.com/wp-json/wp/v2/categories

// タグ一覧を取得
GET https://example.com/wp-json/wp/v2/tags

// ユーザー一覧を取得
GET https://example.com/wp-json/wp/v2/users

【重要】/usersエンドポイントのセキュリティに注意
ユーザー一覧のエンドポイントは、デフォルトでログインユーザー名（スラッグ）が外部に公開されます。
ユーザー名が分かると、ブルートフォース攻撃（総当たり攻撃）のリスクが高まります。
セキュリティ対策については後述のセクションで解説します。

// 1回で5件取得する
https://example.com/wp-json/wp/v2/posts?per_page=5

// 2ページ目を取得する（per_pageと組み合わせて使う）
https://example.com/wp-json/wp/v2/posts?per_page=5&page=2

// 最大100件まで取得可能（per_page=100が上限）
https://example.com/wp-json/wp/v2/posts?per_page=100

// カテゴリーID=5の記事を取得
https://example.com/wp-json/wp/v2/posts?categories=5

// タグID=12の記事を取得
https://example.com/wp-json/wp/v2/posts?tags=12

// カテゴリーID=5かつタグID=12の記事を取得
https://example.com/wp-json/wp/v2/posts?categories=5&tags=12

// タイトルや本文に「WordPress」を含む記事を取得
https://example.com/wp-json/wp/v2/posts?search=WordPress

// タイトル・URL・日付だけ取得する
https://example.com/wp-json/wp/v2/posts?_fields=id,title,link,date

// Fetch APIを使った記事一覧の取得
fetch('https://example.com/wp-json/wp/v2/posts?per_page=5&_fields=id,title,link,date')
  .then(response => response.json())
  .then(posts => {
    posts.forEach(post => {
      console.log(post.title.rendered); // 記事タイトル
      console.log(post.link);           // 記事URL
      console.log(post.date);           // 投稿日時
    });
  })
  .catch(error => console.error('エラー:', error));

add_action( 'rest_api_init', function() {
    register_rest_route(
        '名前空間/v1',          // 名前空間（ユニークな文字列）
        '/エンドポイント名/',    // エンドポイントのパス
        array(
            'methods'             => 'GET',             // HTTPメソッド
            'callback'            => 'コールバック関数名', // 実行する関数
            'permission_callback' => '__return_true',   // アクセス制限
        )
    );
});

add_action( 'rest_api_init', function() {
    register_rest_route( 'mysite/v1', '/latest-posts/', array(
        'methods'             => 'GET',
        'callback'            => 'mysite_get_latest_posts',
        'permission_callback' => '__return_true', // 誰でもアクセス可
    ) );
} );

function mysite_get_latest_posts( $request ) {
    $posts = get_posts( array(
        'numberposts' => 5,
        'post_status' => 'publish',
    ) );

    $data = array();
    foreach ( $posts as $post ) {
        $data[] = array(
            'id'    => $post->ID,
            'title' => get_the_title( $post->ID ),
            'url'   => get_permalink( $post->ID ),
            'date'  => $post->post_date,
        );
    }

    return rest_ensure_response( $data );
}

https://example.com/wp-json/mysite/v1/latest-posts/

add_action( 'rest_api_init', function() {
    register_rest_field(
        'post',               // 対象の投稿タイプ
        'my_custom_field',    // 追加するフィールド名
        array(
            'get_callback' => function( $post_arr ) {
                return get_post_meta( $post_arr['id'], 'my_custom_field', true );
            },
            'schema' => array(
                'type'        => 'string',
                'description' => 'カスタムフィールドの値',
            ),
        )
    );
} );

// 未ログインユーザーへのusersエンドポイントを制限
add_filter( 'rest_endpoints', function( $endpoints ) {
    if ( ! is_user_logged_in() ) {
        if ( isset( $endpoints['/wp/v2/users'] ) ) {
            unset( $endpoints['/wp/v2/users'] );
        }
        if ( isset( $endpoints['/wp/v2/users/(?P<id>[\d]+)'] ) ) {
            unset( $endpoints['/wp/v2/users/(?P<id>[\d]+)'] );
        }
    }
    return $endpoints;
} );

// ログイン済みユーザーのみREST APIを許可する
add_filter( 'rest_authentication_errors', function( $result ) {
    // すでに認証エラーが発生している場合はそのまま返す
    if ( true === $result || is_wp_error( $result ) ) {
        return $result;
    }

    // ログイン済みユーザーは許可
    if ( is_user_logged_in() ) {
        return $result;
    }

    // 未ログインはエラーを返す
    return new WP_Error(
        'rest_not_logged_in',
        'ログインが必要です。',
        array( 'status' => 401 )
    );
} );

REST APIを完全に無効化すると、以下に影響が出る可能性があります。

• Gutenberg（ブロックエディター）が正常に動作しなくなる
• WooCommerceの一部機能が使えなくなる
• REST APIを利用しているプラグイン全般に影響が出る
• Contact Form 7・Akismetなど定番プラグインが動かなくなるケースがある

add_filter( 'rest_authentication_errors', function( $result ) {
    if ( true === $result || is_wp_error( $result ) ) {
        return $result;
    }

    // 編集権限のあるログイン済みユーザーは全て許可
    if ( current_user_can( 'edit_posts' ) ) {
        return $result;
    }

    // 許可するエンドポイント（プラグインに必要なルートを追加）
    global $wp;
    $rest_route = isset( $wp->query_vars['rest_route'] )
        ? $wp->query_vars['rest_route']
        : '';

    $allowed_routes = array(
        '/oembed/1.0',         // 埋め込み用
        '/contact-form-7/v1',  // Contact Form 7
        '/akismet/v1',         // Akismet
    );

    foreach ( $allowed_routes as $route ) {
        if ( strpos( $rest_route, $route ) === 0 ) {
            return $result;
        }
    }

    return new WP_Error(
        'rest_forbidden',
        'このAPIへのアクセスは制限されています。',
        array( 'status' => 403 )
    );
} );

【活用例】
・グループ会社サイトで本体WordPressのお知らせ記事を共有表示する
・静的サイトのトップページにWordPressの最新記事を表示する
・LP（ランディングページ）にWordPressのブログ記事一覧を埋め込む

• コンテンツ管理は使い慣れたWordPress管理画面で行う
• フロントエンドはNext.jsやReactで高速・モダンなUIを構築する
• REST APIでWordPressのデータをフロント側に渡す

【活用例】
・WordPressで記事を公開したら、自動的にSlackに通知を送る
・新しい記事が追加されたら、メールマガジンの配信を自動でトリガーする
・問い合わせフォームの送信データをGoogleスプレッドシートに自動保存する

① Claude APIにキーワードを渡して記事を自動生成
② 生成した記事をREST API経由でWordPressの下書きとして保存
③ 人間がチェックして公開ボタンを押す（半自動化）

// JavaScript（Node.js）からWordPressに記事を自動投稿する例
const response = await fetch('https://example.com/wp-json/wp/v2/posts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    // Application Passwordsを使った認証
    'Authorization': 'Basic ' + btoa('ユーザー名:アプリケーションパスワード'),
  },
  body: JSON.stringify({
    title:   'AIが生成した記事タイトル',
    content: 'AIが生成した記事本文...',
    status:  'draft', // 'draft'（下書き）または'publish'（公開）
  }),
});

const post = await response.json();
console.log('投稿完了。記事ID:', post.id);

・WordPressの記事一覧を確認する
・新しい記事を作成・投稿する
・メディアをアップロードする
・カテゴリーやタグを管理する

• WordPress REST APIはHTTPリクエストでWordPressのデータを外部から操作できる仕組み
• エンドポイントは https://example.com/wp-json/wp/v2/{リソース名} の形式
• GET（取得）は認証不要、POST・PUT・DELETE（作成・更新・削除）は認証が必要
• パラメータ（per_page・categories・_fieldsなど）でデータを柔軟に絞り込める
• register_rest_route()でカスタムエンドポイントを自作できる
• セキュリティ対策は「全部無効化」ではなく「必要なものだけ制限」が正解
• /usersエンドポイントは未ログインからのアクセス制限を検討する
• 2025年以降はAI（ChatGPT・Claude）との連携が急速に広まっている