APIのレスポンスをタグカテゴリで絞り込みたい

tag_category_idのパラメータを指定して絞込みしてください。
このパラメータの指定はタグカテゴリの親子関係を考慮します。

コンテンツ例

以下のコンテンツをフィルターした場合の結果を確認します。

トピックスID	タイトル	タグカテゴリID	タグカテゴリ名	タグID	タグ名
1152	親カテゴリの記事	7	親タグカテゴリ	186	親タグ
1153	子カテゴリの記事	8	子タグカテゴリ	187	子タグ
1154	孫カテゴリの記事	9	孫タグカテゴリ	188	孫タグ

• タグカテゴリ設定

• タグ一覧

• コンテンツ一覧

tag_category_idでのフィルター

tag_category_idによるフィルターはタグカテゴリの親子関係を考慮し、指定したタグカテゴリ及びその配下のタグカテゴリに所属するタグが付与されたコンテンツの一覧がレスポンスされます。

tag_category_id=[7]を指定

「親カテゴリの記事」「子カテゴリの記事」「孫カテゴリの記事」が表示されます。

Request URL：
https://example.g.kuroco.app/rcms-api/13/news?tag_category_id=7

Response body：

{
  "errors": [],
  "messages": [],
  "list": [
    {
      "topics_id": 1152,
      "ymd": "2023-02-16",
      "contents_type": 17,
      "contents": "",
      "subject": "親カテゴリの記事",
      ・
      ・
      ・
      "tags": [
        {
          "tag_id": 186,
          "tag_nm": "親タグ",
          "open_contents_cnt": 1,
          "all_contents_cnt": 1,
          "inst_ymdhi": "2023-02-16T15:40:07+09:00",
          "update_ymdhi": "2023-02-16T15:40:52+09:00",
          "tag_category_id": 7,
          ・
          ・
          ・
        }
      ],
      ・
      ・
      ・
    },
    {
      "topics_id": 1153,
      "ymd": "2023-02-16",
      "contents_type": 54,
      "contents": "",
      "subject": "子カテゴリの記事",
      ・
      ・
      ・
      "tags": [
        {
          "tag_id": 187,
          "tag_nm": "子タグ",
          "open_contents_cnt": 1,
          "all_contents_cnt": 1,
          "inst_ymdhi": "2023-02-16T15:40:21+09:00",
          "update_ymdhi": "2023-02-16T15:40:52+09:00",
          "tag_category_id": 8,
          ・
          ・
          ・
        }
      ],
      ・
      ・
      ・
    },
    {
      "topics_id": 1154,
      "ymd": null,
      "contents_type": 55,
      "contents": "",
      "subject": "孫カテゴリの記事",
      ・
      ・
      ・
      "tags": [
        {
          "tag_id": 188,
          "tag_nm": "孫タグ",
          "open_contents_cnt": 1,
          "all_contents_cnt": 1,
          "inst_ymdhi": "2023-02-16T15:40:34+09:00",
          "update_ymdhi": "2023-02-16T15:40:52+09:00",
          "tag_category_id": 9,
          ・
          ・
          ・
        }
      ],
      ・
      ・
      ・
    }
  ],
  "pageInfo": {
    "totalCnt": 3,
    ・
    ・
    ・
  }
}

tag_category_id=[8]を指定

「子カテゴリの記事」「孫カテゴリの記事」が表示されます。

Request URL：
https://example.g.kuroco.app/rcms-api/13/news?tag_category_id=8

Response body：

{
  "errors": [],
  "messages": [],
  "list": [
    {
      "topics_id": 1153,
      "ymd": "2023-02-16",
      "contents_type": 54,
      "contents": "",
      "subject": "子カテゴリの記事",
      ・
      ・
      ・
      "tags": [
        {
          "tag_id": 187,
          "tag_nm": "子タグ",
          "open_contents_cnt": 1,
          "all_contents_cnt": 1,
          "inst_ymdhi": "2023-02-16T15:40:21+09:00",
          "update_ymdhi": "2023-02-16T15:40:52+09:00",
          "tag_category_id": 8,
          ・
          ・
          ・
        }
      ],
      ・
      ・
      ・
    },
    {
      "topics_id": 1154,
      "ymd": null,
      "contents_type": 55,
      "contents": "",
      "subject": "孫カテゴリの記事",
      ・
      ・
      ・
      "tags": [
        {
          "tag_id": 188,
          "tag_nm": "孫タグ",
          "open_contents_cnt": 1,
          "all_contents_cnt": 1,
          "inst_ymdhi": "2023-02-16T15:40:34+09:00",
          "update_ymdhi": "2023-02-16T15:40:52+09:00",
          "tag_category_id": 9,
          ・
          ・
          ・
        }
      ],
      ・
      ・
      ・
    }
  ],
  "pageInfo": {
    "totalCnt": 2,
    ・
    ・
    ・
  }
}

関連ドキュメント

• APIのレスポンスをコンテンツカテゴリで絞り込みたい