instagram · insight · rankingsolari:read
solari insight instagram ranking posts
ランキングの行を支える上位の投稿。
- MCP ツール
- solari_insight_instagram_ranking_posts
- CLI
- solari insight instagram ranking posts
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
ランキングの 1 行を支える、成果の高い投稿。ブランドやクリエイターの数値の根拠になります。各投稿にタイアップかどうかが付き、kind=organic を指定するとタイアップ以外の投稿だけを返します。
どんなときに使うか — ブランドやクリエイターのランキングを見たあと、ある行の数値が何によるものか確認したいとき。
返される内容 — 上位の投稿と投稿者（成果の高い順）。
パラメータ
- boardenum必須
- brand または creator。行を取得したランキングです。値
brandcreator - account_idstring必須
- ランキングの行の account_id。uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
- regionenum任意
- 一覧と同じ市場。既定値
"KR"値KRJPUS - daysinteger任意
- 一覧と同じ期間。30 または 90。既定値
30 - scopestring任意
- クリエイターランキングのみ。一覧で使ったのと同じ scope。≤ 120 chars
- kindenum任意
- all、タイアップ投稿のみの sponsored、タイアップ以外の投稿のみの organic のいずれか。既定値
"all"値allsponsoredorganic - limitinteger任意
- 返す投稿数。既定値
61–12
レスポンス
Response
- account_iduuid
- 行のアカウント。
- kindstring
- all、sponsored、organic のいずれか。
- checked_top_postsinteger
- kind=organic の場合のみ。行の上位投稿のうち確認した件数。
- itemsobject[]
- 上位の投稿（成果の高い順）。
items[]
- post_id / slugstring
- 投稿の ID。
- posted_attimestamp | null
- 投稿日時（UTC）。
- media_typestring
- image または video。
- thumbnail_urlstring
- サムネイルの URL。
- media_urlstring | null
- メディアの URL。ファイルが保存されていない場合は null。
- play_countinteger | null
- 動画の再生数。
- sponsoredboolean
- タイアップ投稿かどうか。
- authorobject
- account_id、username、full_name、follower_count、profile_pic_url。
例
リクエスト
$ solari insight instagram ranking posts board=brand account_id=018cabce-14cc-7544-8890-7811ec33ef74 region=KR limit=2レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
"kind": "all",
"items": [
{
"post_id": "01a04c73-3ec3-7873-9e84-334c644abfe4",
"slug": "DckGrZ6vZiU",
"posted_at": "2026-08-21T10:03:52+00:00",
"media_type": "video",
"media_url": null,
"thumbnail_url": "https://dcr.bzine.co/instagram/posts/DckGrZ6vZiU/thumbnails/m",
"play_count": 155729,
"author": {
"account_id": "0196c474-c96e-71ad-aceb-61af051c81d3",
"user_id": "0196c474-c96e-71ad-aceb-61af051c81d3",
"username": "hwitto_",
"full_name": null,
"follower_count": 48210,
"profile_pic_url": "https://dcr.bzine.co/instagram/users/hwitto_/profile-picture"
},
"sponsored": true
},
"… 1 more"
]
}MCP で呼び出す場合
{
"name": "solari_insight_instagram_ranking_posts",
"arguments": {
"board": "brand",
"account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
"region": "KR",
"limit": 2
}
}注意点
- 一覧と同じ region、days、（クリエイターの場合は）scope を使います。そうしないと、投稿が数値と一致しません。
- ブランドランキングの場合、投稿者の多くはそのブランドをタグ付け・メンションしたクリエイターです。
- 1 行につき、再生数の上位 6 件の投稿を保持しています。kind=organic はその中からタイアップ以外の投稿を返すため、件数が少なくなったり空になったりすることがあります。