instagram · insight · brandsolari:read
solari insight instagram brand ad posts
Instagram ブランドの広告投稿。
- MCP ツール
- solari_insight_instagram_brand_ad_posts
- CLI
- solari insight instagram brand ad posts
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
ブランドの広告投稿を、投稿したクリエイターの情報と一緒に返します。
どんなときに使うか — 合計だけでなく、投稿そのものが必要なとき。
返される内容 — 広告投稿。合計が正確なのは sort=recent のときだけです。
パラメータ
- usernamestring必須
- ブランドの Instagram ユーザー名（@ は付けない）。
- sortenum任意
- recent は期間全体を対象にします。engagement は最近の一部を順位付けします。既定値
"recent"値recentengagement - monthsinteger任意
- 何か月前までさかのぼるか。既定値
31–24 - limitinteger任意
- 1 ページあたりの投稿の件数。既定値
501–200 - offsetinteger任意
- スキップする投稿の件数。既定値
0≥ 0
レスポンス
Response
- itemsobject[]
- タイアップ投稿。
- totalinteger
- sort=recent のときの、期間全体での正確な件数。
- has_moreboolean
- 次のページがあるかどうか。
- ranking_windowinteger | null
- エンゲージメント順の順位付けで対象にした範囲。期間全体ではなく一部だけを並べたときに設定されます。
items[]
- iduuid
- 投稿 ID。
- slugstring
- Instagram のショートコード。
- textstring
- キャプション。
- posted_attimestamp
- 公開日時（UTC）。
- username / user_id / account_idstring
- 投稿したクリエイター。
- like_count / comment_count / play_countinteger
- エンゲージメント。
- media_typestring
- 投稿の形式。
- media / media_url / thumbnail_urlstring
- メディアのリンク。
- virtual_campaignobject | null
- キャンペーンのまとまり。特定できた場合のみ。
- assetsobject[]
- メディアファイル（順番どおり）。それぞれに asset_url, media_type, video_duration があります。
- assets[].asset_urlstring | null
- 元サイズの画像・動画を直接ダウンロードできるリンク。ファイルが保存されていない場合は null。
例
リクエスト
$ solari insight instagram brand ad posts username=innisfreeofficial limit=2レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"items": [
{
"id": "01a062a0-2747-72eb-b20d-670cf30f2c96",
"slug": "DcygG05GrA-",
"text": "#광고 요즘 부쩍 신경 쓰이기 시작한 모공 고민을 직접 경험해보고 싶어 방문한 이니스프리 레티놀 시카 강의실 무빙 팝업💙\n\n업그레이드된 레티놀 시카 모공 흔적 앰플을 직접 테스트해볼 수 있을 뿐 아니라, 제품을 알아보고 체험할 수 있는 다양한 프로그램과 이벤트가 마련되어 있어 더욱 재미있게 둘러볼 수 있었어요.\n\n특히 오늘 방문했을 때는 정말 많은 분들이 찾아와서 놀랐는데요. 대기 줄이 길게 …",
"posted_at": "2026-09-02T14:56:19Z",
"virtual_campaign": null,
"username": "_mini_mming",
"user_id": "018caf92-e08a-78a2-b9c3-59f6f5740182",
"profile_picture_url": null,
"like_count": 384,
"comment_count": 4,
"thumbnail_url": null,
"media_url": null,
"media": [],
"media_type": "post",
"account_id": "018caf92-e08a-78a2-b9c3-59f6f5740182"
},
"… 1 more"
],
"total": 405,
"has_more": true,
"ranking_window": null
}MCP で呼び出す場合
{
"name": "solari_insight_instagram_brand_ad_posts",
"arguments": {
"username": "innisfreeofficial",
"limit": 2
}
}注意点
- username を渡します。存在しないユーザー名を渡すと 404 が返ります。
- sort=engagement は、最近の一部の投稿だけを順位付けします。どこまで対象にしたかは ranking_window でわかります。
- likes_hidden が true のときは like_count を使わないでください。投稿者がいいね数を非表示にしているため、null か、実際の値ではない可能性があります。