---
title: APIのレスポンスをタグカテゴリで絞り込みたい
description: tag_category_idのパラメータを指定して絞込みしてください。このパラメータの指定はタグカテゴリの親子関係を考慮します。 
category: howto 
---

import StructuredDataFaqs from '@site/src/components/StructuredDataFaqs';

<StructuredDataFaqs faqs={[
    { question: "APIのレスポンスをタグカテゴリで絞り込みたい", answer: "tag_category_idのパラメータを指定して絞込みしてください。このパラメータの指定はタグカテゴリの親子関係を考慮します。" }
]} />

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

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

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

- タグカテゴリ設定
  ![Image from Gyazo](https://t.gyazo.com/teams/diverta/7b0c4420598d83f884aa2d5d78e3c32b.png)

- タグ一覧
  ![Image from Gyazo](https://t.gyazo.com/teams/diverta/698a6bb0d9a23c7928acca421efea9a9.png)

- コンテンツ一覧
  ![Image from Gyazo](https://t.gyazo.com/teams/diverta/cef0804c19153bddc8c8a6e2aa9cb4d1.png)

### 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：
```json
{
  "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：
```json
{
  "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のレスポンスをコンテンツカテゴリで絞り込みたい](/ja/docs/faq/filtering-api-responses-by-content-category)