instagram · catalog · tagsolari:read
solari catalog instagram tag search
ハッシュタグやメンションを含む投稿を探すときに使います。
- MCP ツール
- solari_catalog_instagram_tag_search
- CLI
- solari catalog instagram tag search
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
収集済みの全期間から、ハッシュタグやメンションを完全一致で探します。本文中のどこかに含まれるキーワードを探す場合は、コンテンツ検索を使います。
どんなときに使うか — キャンペーンのハッシュタグの広がりや、あるアカウントをメンションした投稿を知りたいとき。
返される内容 — タグを含む投稿（収集が新しい順）。
パラメータ
- querystring必須
- ハッシュタグ（#ootd）またはメンション（@username）。≤ 200 chars
- limitinteger任意
- 1 ページあたりの投稿数。既定値
201–1000 - cursorstring任意
- 前のページで返された next_cursor。
レスポンス
Response
- querystring
- 実際に検索に使ったタグ（先頭の # や @ は除きます）。
- tag_kindstring
- hashtag または mention。query をどちらとして扱ったかを表します。
- matched_tagsinteger
- 一致した保存済みの表記の数。0 の場合、そのタグは一度も確認されていません。
- itemsobject[]
- 見つかった投稿。
- foundinteger
- 詳細データまで読み込めた投稿の数。
- next_cursorstring | null
- 次のページの cursor として渡す値。最後のページでは null。
- mirror_synced_attimestamp | null
- タグのインデックスを最後に更新した日時（UTC）。
items[]
- iduuid
- 投稿 ID。
- slugstring
- Instagram のショートコード。
- textstring
- キャプション。
- posted_attimestamp
- 投稿日時（UTC）。
- username / user_id / account_idstring
- 投稿したアカウント。
- like_count / comment_countinteger
- エンゲージメント。
- play_countinteger | null
- 動画の再生数。
- media_typestring
- 投稿の形式。
- assetsobject[]
- メディアファイルの一覧（表示順）。それぞれ asset_url、media_type、video_duration を持ちます。
- assets[].asset_urlstring | null
- フルサイズの画像または動画の直接ダウンロードリンク。ファイルが保存されていない場合は null。
例
リクエスト
$ solari catalog instagram tag search query=#ootd limit=3レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"query": "ootd",
"tag_kind": "hashtag",
"matched_tags": 1,
"items": [
{
"id": "01a06a16-781f-7578-822b-1c326e72f28d",
"slug": "DW1jniHiVSU",
"text": "御殿場是一個一天逛不完的地方 希望下次有時間可以慢慢逛 —— OOTD —— Pants：LAKOLE / Shirt：HARE #LYNN__OOTD #日常穿搭 #ootd …",
"posted_at": "2026-04-07T16:16:21Z",
"virtual_campaign": null,
"username": "llling_yinnnnn",
"user_id": "019dbc46-1a67-7ef5-b95a-2fb466790d04",
"account_id": "019dbc46-1a67-7ef5-b95a-2fb466790d04",
"profile_picture_url": null,
"like_count": 3,
"comment_count": 4,
"media_type": "post",
"play_count": null,
"media": []
},
{
"id": "01a06a16-552d-7099-ae0a-77e6b68de960",
"slug": "DaS66VzJBPW",
"text": "SEOUL OOTD — 這次搭配了四種完全不同風格 #ootd #lynn__ootd #穿搭販賣機 #韓國穿搭",
"posted_at": "2026-07-02T15:33:13Z",
"virtual_campaign": null,
"username": "llling_yinnnnn",
"user_id": "019dbc46-1a67-7ef5-b95a-2fb466790d04",
"account_id": "019dbc46-1a67-7ef5-b95a-2fb466790d04",
"profile_picture_url": null,
"like_count": 32,
"comment_count": 1,
"media_type": "reel",
"play_count": 888,
"media": []
},
"… 1 more"
],
"found": 3,
"next_cursor": "01a06a16-552d-7099-ae0a-77e6b68de960",
"mirror_synced_at": "2026-09-03T21:47:19Z"
}MCP で呼び出す場合
{
"name": "solari_catalog_instagram_tag_search",
"arguments": {
"query": "#ootd",
"limit": 3
}
}注意点
- 並び順は posted_at ではなく収集した時刻です。投稿日時が重要な場合は、posted_at で並べ替えてください。
- タグのインデックスは毎日更新されます。mirror_synced_at が反映済みの時点です。
- 完全一致で照合します。#ootd は #ootdkorea に一致しません。メンションは先頭に @ を付けます。
- likes_hidden が true のときは like_count を使わないでください。投稿者がいいね数を非表示にしているため、null か、実際の値ではない可能性があります。