RSS API¶

郡山市公式サイト RSS の feed 一覧と記事情報を JSON で取得できます。防災、子育て、生活、イベント、市政情報などの更新情報を、アプリケーションや一覧画面で扱いやすい形式で返します。

速報性は保証しません

RSS 記事は定期的に取得しますが、郡山市公式サイトの更新直後に必ず反映されるとは限りません。正確な最新情報が必要な場合は、記事 URL から郡山市公式サイトを確認してください。

取得対象¶

この API では、市民向けポータルで扱いやすい次の RSS を取得対象にしています。

`kind`	対象	RSS パス
`global`	全体 RSS	`/rss/10/list*.xml`
`life`	生活分類 RSS	`/rss/10/life*.xml`
`site`	特設サイト RSS	`/rss/10/site-*.xml`

組織別 RSS /rss/10/soshiki-*.xml は対象外です。担当課単位の更新をすべて網羅する API ではありません。

RSS feed を確認する¶

取得対象の RSS feed は /api/v2/rss/feeds で確認できます。

curl "https://civic-koriyama-data.alflag.org/api/v2/rss/feeds"

カテゴリで絞り込む場合は kind を指定します。

curl "https://civic-koriyama-data.alflag.org/api/v2/rss/feeds?kind=life"

主なレスポンス項目は次の通りです。

フィールド	説明
`id`	RSS feed ID
`kind`	`global`、`life`、`site` のいずれか
`title`	feed タイトル
`url`	feed URL
`enabled`	取得対象として有効かどうか
`verification_status`	feed 確認結果
`verified_at`	feed を確認した日時。未確認の場合は `null`

記事を取得する¶

RSS 記事は /api/v2/rss/entries で取得できます。

curl "https://civic-koriyama-data.alflag.org/api/v2/rss/entries?limit=10"

カテゴリ、feed、feed 種別、公開日時で絞り込めます。

curl "https://civic-koriyama-data.alflag.org/api/v2/rss/entries?category=event&limit=20"
curl "https://civic-koriyama-data.alflag.org/api/v2/rss/entries?kind=life&since=2026-06-01T00:00:00.000Z"

主なレスポンス項目は次の通りです。

フィールド	説明
`id`	RSS 記事 ID
`feed_id`	代表 feed ID
`feed_ids`	記事が出現した feed ID の配列
`feed_kinds`	記事が出現した feed 種別の配列
`title`	記事タイトル
`link`	記事 URL
`canonical_url`	重複排除に使う正規化 URL。取得できない場合は `null`
`published_at`	公開日時。RSS にない場合は `null`
`fetched_at`	API が記事を取得した日時
`category`	API 側で分類したカテゴリ
`tags`	分類タグ

RSS カテゴリは disaster、childcare、life、business、event、city_admin です。

feed 確認レポート¶

/api/v2/rss/audit は、登録済み feed の確認結果と、公式サイト上で検出できる RSS feed との差分を返します。

curl "https://civic-koriyama-data.alflag.org/api/v2/rss/audit"

レポートがまだ作成されていない場合は 404 rss_audit_not_found を返します。データの鮮度や取得状態を確認したい場合は運用・状態確認も参照してください。

詳しい query とレスポンス形式は API リファレンスを参照してください。