tagru insights

媒体ごとの分析指標（期間の合計と日ごとの値）と、上位投稿を表示します。

text

tagru insights --platform <instagram|x|tiktok|youtube> [--days <n>] [--workspace <id>] [--target <prod|test|localhost>] [--json]
tagru insights top --platform instagram [--days <n>] [--limit <n>] [--workspace <id>] [--target <prod|test|localhost>] [--json]

サブコマンド

サブコマンド	内容
（なし）	期間の合計と日ごとの値（Instagram / YouTube は前期間比つき）
`top`	同じ期間の投稿を、リーチの多い順に表示する（Instagram だけ）

オプション

オプション	内容
`--platform <name>`	媒体（必須）。`instagram` / `x` / `tiktok` / `youtube`。`top` は今のところ `instagram` だけ
`--days <n>`	期間の日数（既定 30、1〜100）
`--limit <n>`	上位投稿の件数（既定 20、1〜100）。`top` のみ
`--workspace <id>`	ワークスペース（`tagru use` で保存した値より優先）
`-t, --target <name>`	接続先
`--json`	JSON で出力する

上位投稿（top）は今のところ instagram だけです。x / tiktok / youtube を指定するとエラー（終了コード 1）になります。TAGRU の画面で確認してください
期間は UTC の今日を終わりとする --days 日間です
- Instagram は、31 日より前の日は TAGRU に保存済みの値だけを出します（取得していない日は値が 0 や null になることがあります）
Instagram と YouTube は、直前の同じ日数の期間との差（前期間比）も出します
ほかの「表示するだけ」のコマンドと違い、実行すると、まだ TAGRU に保存されていない分を SNS の API から取得して保存することがあります（TAGRU の画面で分析を開いたときと同じ）
- SNS の API からの取得は、媒体ごとに 1 日（UTC）1 回までです（TAGRU の画面と共通。上位投稿の指標も同じ）。同じ日の 2 回目以降は、その日に取得済みの値を出します。取得に失敗した日も、翌日まで取り直しません
  - TAGRU の画面で媒体を連携し直した場合は、同じ日でも次の実行で取り直します
ワークスペースを選んでいない場合は、個人で連携したアカウントの値を出します
媒体を連携していない・再連携が必要な場合は、その旨のメッセージを出して終了コード 1 で終わります

使い方

bash

tagru insights --platform instagram            # 直近 30 日の合計と日ごとの値
tagru insights --platform x --days 7           # 媒体と日数を変える（1〜100）
tagru insights top --platform instagram        # 同じ期間の投稿をリーチの多い順に表示する（--limit で件数）

出力例

text

$ tagru insights --platform instagram --days 2
ワークスペース: ws-xxxx
媒体: Instagram
期間: 2026-09-29 〜 2026-09-30（2 日）

リーチ: 2,000（前期間比 -500）
閲覧数: 5,500（前期間比 +500）
反応数: 86（前期間比 ±0）
反応したアカウント: 70（前期間比 +10）
いいね: 65（前期間比 -5）
コメント: 9（前期間比 -1）
シェア: 4（前期間比 +2）
保存: 8（前期間比 ±0）
プロフィール閲覧: 120（前期間比 +20）
リンクタップ: 15（前期間比 +5）
フォロワー: 1,004（前期間比 +4）
フォロワー増減: 4（前期間比 -2）

日付        リーチ  閲覧数  反応数  いいね  保存  フォロワー
2026-09-29   1,200   3,400      56      40     5       1,000
2026-09-30     800   2,100      30      25     3       1,004

text

$ tagru insights top --platform instagram --limit 2
ワークスペース: ws-xxxx
媒体: Instagram
期間: 2026-09-01 〜 2026-09-30
ID         日時              リーチ  反応  保存  シェア  いいね  本文
post-0003  2026-09-22 18:00   3,000   120    30       8      80  秋の新作を先行公開します。
post-0002  2026-09-18 18:00   1,800    64     9       3      50  本日のおすすめ
ほか 1 件あります（--limit で増やせます）

text

$ tagru insights --platform x --days 2
ワークスペース: ws-xxxx
媒体: X
期間: 2026-09-29 〜 2026-09-30（2 日）

投稿数: 3
インプレッション: 2,100
エンゲージメント: 84
いいね: 52
返信: 6
リポスト: 6
引用: 1
ブックマーク: 9
リンククリック: 12
プロフィールクリック: 15
フォロワー: 1,520

日付        投稿数  インプレッション  エンゲージメント  いいね  リポスト
2026-09-29       1             1,200                48      30         4
2026-09-30       2               900                36      22         2

text

$ tagru insights top --platform x
上位投稿は Instagram だけに対応しています（X は TAGRU の画面で確認してください）。

`--json`

`tagru insights --json`

詳細の外枠（item）で出します。

jsonc

{
  "target": "prod",
  "workspaceId": "ws-xxxx",
  "item": {
    "platform": "instagram",
    "startDate": "2026-09-01",           // YYYY-MM-DD（UTC）
    "endDate": "2026-09-30",
    "days": 30,
    "summary": { "reach": 12345, ... },  // 期間の合計。項目は下の表
    "previousSummary": { ... },          // 直前の同じ日数の合計。X / TikTok など無ければ null
    "daily": [ { "date": "2026-09-01", "reach": 410, ... } ],
    "note": null                         // サーバーからの補足。無ければ null
  }
}

媒体	`summary` / `previousSummary` の項目	`daily` の項目（`date` のほか）
`instagram`	`reach` `views` `interactions` `accountsEngaged` `likes` `comments` `shares` `saves` `profileViews` `linkTaps` `followers` `netFollows`	`reach` `views` `interactions` `likes` `saves` `followers`
`x`	`posts` `impressions` `engagements` `likes` `replies` `reposts` `quotes` `bookmarks` `linkClicks` `profileClicks` `followers`	`posts` `impressions` `engagements` `likes` `reposts`
`tiktok`	`videos` `views` `likes` `comments` `shares` `engagements` `followers`	`videos` `views` `likes` `comments` `shares`
`youtube`	`views` `watchMinutes` `averageViewDurationSeconds` `likes` `comments` `shares` `subscribersGained` `subscribersLost` `netSubscribers` `subscribers`	`views` `watchMinutes` `likes` `netSubscribers` `subscribers`

指標はすべて数値で、値が無い場合は null です。

`tagru insights top --json`

一覧の外枠（items）に、媒体と期間を加えて出します。

jsonc

{
  "target": "prod",
  "workspaceId": "ws-xxxx",
  "platform": "instagram",
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "items": [
    {
      "id": "post-0003",
      "postedAt": "2026-09-22T18:00:00+09:00",
      "text": "秋の新作を先行公開します。",
      "reach": 3000,
      "engagements": 120,
      "saves": 30,
      "shares": 8,
      "likes": 80,
      "metricsUpdatedAt": "2026-09-30T09:00:00+09:00"  // 指標を取得した日時。無ければ null
    }
  ],
  "count": 20,
  "hasMore": true
}

項目	型	内容
`id`	string	投稿の ID
`postedAt`	string \| null	投稿日時（ISO 8601）
`text`	string	本文
`reach`	number \| null	リーチ
`engagements`	number \| null	反応数
`saves`	number \| null	保存
`shares`	number \| null	シェア
`likes`	number \| null	いいね
`metricsUpdatedAt`	string \| null	指標を取得した日時（ISO 8601）

tagru insights ​

サブコマンド ​

オプション ​

使い方 ​

出力例 ​

--json ​

tagru insights --json ​

tagru insights top --json ​

tagru insights

サブコマンド

オプション

使い方

出力例

`--json`

`tagru insights --json`

`tagru insights top --json`