instagram · fetch · hashtagsolari:read
solari fetch instagram hashtag posts
ハッシュタグの投稿を 1 ページ分その場で収集します。
- MCP ツール
- solari_fetch_instagram_hashtag_posts
- CLI
- solari fetch instagram hashtag posts
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
Instagram のハッシュタグフィードを 1 ページ分その場で収集し、投稿を保存してフィードの順番で返します。呼び出すたびに Instagram へリクエストが出るので、先に catalog tag search を確認してください。
どんなときに使うか — catalog tag search にハッシュタグがない、または情報が古いとき。あるいは、人気投稿やリールを今すぐ見たいとき。
返される内容 — そのページの投稿（保存済み）と、次のページ用のカーソル。
パラメータ
- hashtagstring必須
- ハッシュタグ（# の有無は問いません）。≤ 150 chars
- tabenum任意
- recent、top、clips（リール）のいずれか。値
recenttopclips - cursorstring任意
- 前のページの next_cursor。≤ 8192 chars
レスポンス
Response
- ingestedboolean
- この呼び出しで投稿を 1 件以上保存した場合は true。
- fetched_on_demandboolean
- 常に true。呼び出すたびにその場で収集します。
- hashtagstring
- 取得に使ったハッシュタグ（# なし）。
- tabstring
- このページを取得したフィード。
- is_hiddenboolean
- このハッシュタグのフィードを Instagram が返さない場合は true。非表示・制限付き・存在しないハッシュタグが該当し、items は空になります。
- hidden_reasonstring | null
- 非表示のハッシュタグに Instagram が付けるラベル。
- foundinteger
- items に含まれる投稿の件数。
- fetched_countinteger
- このページで Instagram が返した投稿の件数。保存できなかった投稿があると found より大きくなります。
- itemsobject[]
- このページの投稿（フィードの順番）。
- next_cursorstring | null
- 次のページを取得するときに cursor として渡します。フィードの終わりでは null。
- notestring
- この後に起きること。
- nextstring
- 同じタグを後から読むためのカタログコマンド。
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 fetch instagram hashtag posts hashtag=ootd tab=topレスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"ingested": true,
"fetched_on_demand": true,
"hashtag": "ootd",
"tab": "top",
"is_hidden": false,
"hidden_reason": null,
"found": 1,
"fetched_count": 1,
"items": [
{
"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": []
}
],
"next_cursor": "eyJwIjoxLCJtIjoiUVZGRC4uLiJ9",
"note": "These posts were collected live and are stored now. solari_catalog_instagram_tag_search lists them after its next daily refresh.",
"next": "solari catalog instagram tag search query=#ootd"
}MCP で呼び出す場合
{
"name": "solari_fetch_instagram_hashtag_posts",
"arguments": {
"hashtag": "ootd",
"tab": "top"
}
}注意点
- 1 ページはおよそ 20〜30 件で、数秒かかります。
- カーソルは、取得したときと同じハッシュタグとタブでしか使えません。
- フィードの終わりは next_cursor が null になったときだけです。found が 0 でも next_cursor が返ることがあるので、その場合は続けて取得してください。
- 非表示・制限付き・スペルミスのハッシュタグには、Instagram はどれも同じ応答を返します。is_hidden=true で、投稿は 0 件です。スペルは hashtag search で確認してください。
- 投稿はすぐに保存されますが、catalog tag search に表示されるのは、1 日 1 回の次回更新の後です。
- 収集した直後の投稿は、メディアファイルの保存に少し時間がかかることがあります。そのため、最初は asset_url が null の場合があります。
- likes_hidden が true のときは like_count を使わないでください。投稿者がいいね数を非表示にしているため、null か、実際の値ではない可能性があります。