WordPress APIで記事一覧を取得する方法｜slug・カテゴリ検索の実装

WordPressは REST API を使うことで
外部アプリやツールから記事データを取得できます。

例えば以下のような用途で使われます。

• Webアプリでブログ記事を表示
• スマホアプリに記事一覧を表示
• ブログデータの分析
• ヘッドレスCMS構成

この記事では WordPress APIで記事を取得する方法を
実装例付きで解説します。

解説する内容

• 記事一覧取得
• slug検索
• カテゴリ検索
• pagination
• JSONレスポンスの読み方

---

WordPress APIで記事を取得する基本

WordPress REST APIは次のURLでアクセスできます。

https://サイトURL/wp-json/wp/v2/

記事データは postsエンドポイントから取得できます。

/wp-json/wp/v2/posts

例

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

このURLにアクセスすると
WordPressの記事一覧がJSON形式で取得できます。

---

記事一覧を取得する方法

記事一覧取得API

GET /wp-json/wp/v2/posts

例

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

JavaScript実装例

fetch("https://example.com/wp-json/wp/v2/posts")
.then(res => res.json())
.then(posts => {
console.log(posts)
})

取得できるデータ例

[
{
"id": 123,
"slug": "wordpress-api",
"title": {
"rendered": "WordPress APIの使い方"
},
"date": "2024-01-01",
"link": "https://example.com/post"
}
]

主なフィールド

項目	説明
id	投稿ID
slug	URLスラッグ
title	記事タイトル
date	投稿日
link	記事URL

---

slugから記事を取得する

特定の記事を取得する場合は
slug検索を使用します。

/wp-json/wp/v2/posts?slug=記事スラッグ

例

https://example.com/wp-json/wp/v2/posts?slug=wordpress-api

JavaScript例

fetch("https://example.com/wp-json/wp/v2/posts?slug=wordpress-api")
.then(res => res.json())
.then(data => {
const post = data[0]
console.log(post)
})

この方法は

• 記事ページの生成
• 外部サイトでの表示
• アプリ記事表示

などでよく使われます。

---

カテゴリで記事を検索する

カテゴリIDを指定すると
そのカテゴリの記事一覧を取得できます。

/wp-json/wp/v2/posts?categories=ID

例

https://example.com/wp-json/wp/v2/posts?categories=3

JavaScript例

fetch("https://example.com/wp-json/wp/v2/posts?categories=3")
.then(res => res.json())
.then(posts => console.log(posts))

カテゴリIDは以下のAPIで確認できます。

/wp-json/wp/v2/categories

---

pagination（ページネーション）

WordPress APIでは
記事取得数を指定できます。

/wp-json/wp/v2/posts?per_page=10

ページ指定

/wp-json/wp/v2/posts?page=2

例

https://example.com/wp-json/wp/v2/posts?per_page=10&page=2

JavaScript例

fetch("https://example.com/wp-json/wp/v2/posts?per_page=10&page=2")
.then(res => res.json())
.then(posts => console.log(posts))

主なパラメータ

パラメータ	説明
per_page	取得件数
page	ページ番号
categories	カテゴリ検索
slug	スラッグ検索

---

JSONレスポンスの構造

WordPress APIは
JSON形式でデータを返します。

例

{
"id": 101,
"slug": "wordpress-api",
"title": {
"rendered": "WordPress API解説"
},
"content": {
"rendered": "<p>記事本文</p>"
},
"date": "2024-01-01"
}

重要な項目

キー	内容
id	投稿ID
slug	URLスラッグ
title.rendered	タイトル
content.rendered	本文HTML
date	投稿日

---

WordPress API記事取得の活用例

WordPress APIで記事を取得すると
様々なサービスを作れます。

例

• スマホアプリでブログ表示
• 自作ブログリーダー
• ヘッドレスCMS
• AI記事分析ツール
• ブログ検索ツール

特に最近は

AI記事生成 → WordPress API投稿

という構成のツールも増えています。

---

まとめ

WordPress REST APIを使うと
記事データを簡単に取得できます。

今回紹介した内容

• 記事一覧取得
• slug検索
• カテゴリ検索
• pagination
• JSONレスポンス

WordPress APIは

• Webアプリ
• スマホアプリ
• 自動化ツール

などの開発でよく使われます。

WordPressを開発に活用するなら
REST APIはぜひ理解しておきたい機能です。