instagram · accountsolari:read

solari instagram account ad posts

クリエイターが投稿した広告投稿を行単位で返し、各行にターゲットブランドを付けます。

MCP ツール: solari_instagram_account_ad_posts
CLI: solari instagram account ad posts
アクセス権: solari:readサインイン済みの SOLARI アカウントであれば利用できます。サインイン済みの SOLARI アカウントであれば利用できます。

概要

1 人のクリエイターが投稿した、判定済みの広告投稿を行単位でページネーションして新しい順に返します。各行にはターゲットブランドが付きます。1 行が 1 つの投稿とブランドの組み合わせなので、複数ブランドの投稿はターゲットごとに 1 回ずつ現れます。各アイテムは post_id、slug と url、post_type、posted_at、キャプションのテキスト、like/comment/play の各カウント、media_count、is_paid_partnership、target_account_id / target_username を持ちます。target (ブランドの account_id または Instagram ハンドル) で 1 ブランドに絞り込めます。months で遡る期間を広げられます (デフォルト 3、最大 24)。同じ履歴をブランド単位でまとめる solari_instagram_account_collabs の行単位版。クリエイターは account_id (SOLARI アカウントの UUID) または username (Instagram ハンドル) で指定します。不明な指定は not-found エラーになります。サインイン済みの SOLARI アカウントであれば利用できます。

どんなときに使うか — コラボレーション履歴を生の行として分析するとき。複数ブランドをタグ付けした投稿はターゲットごとに 1 回ずつ現れるため、各行は投稿とブランドの組み合わせになります。

何が返るか — 広告投稿を新しい順に返します。

パラメータ

account_idstring任意: クリエイターの account_id (SOLARI アカウントの UUID)。これか username のいずれかを指定してください。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)$
usernamestring任意: Instagram ハンドル。先頭の @ はあってもなくてもかまいません。account_id が指定されている場合は無視されます。≤ 64 chars
monthsinteger任意: 遡る期間を月数で指定、デフォルトは 3。24 を超える値は上限の 24 に切り詰められます。≥ 1
limitinteger任意: 1 ページあたりのアイテム数、デフォルトは 50。200 を超える値は上限の 200 に切り詰められます。≥ 1
offsetinteger任意: ページネーションの offset、デフォルトは 0。既定値 0≥ 0
targetstring任意: 任意のターゲットブランドのフィルタ。ブランドの account_id (SOLARI アカウントの UUID) または Instagram ハンドル。≤ 64 chars

レスポンス

Response

account_id / usernamestring: 解決されたクリエイター。
monthsinteger: 適用された遡及期間。
totalinteger: 行の総数。
has_moreboolean: 次のページが存在するかどうか。
itemsobject[]: 投稿とブランドの組み合わせ。

items[]

post_id / slug / urlstring: 投稿の識別子と公開リンク。
post_typestring: reel、video、photo、または carousel。
posted_attimestamp: 公開時刻 (UTC)。
textstring: キャプションのテキスト。
like_count / comment_count / play_countinteger: エンゲージメントのスナップショット。
media_countinteger: メディアの数。
is_paid_partnershipboolean | null: Instagram のタイアップ投稿 (paid partnership) ラベル。
target_account_id / target_usernamestring: この行が帰属するブランド。

例

リクエスト

$ solari instagram account ad posts username=beinny_motd months=6 limit=2

レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。

{
  "account_id": "018ecc75-55d8-70a7-a348-d370aa504ed9",
  "username": "beinny_motd",
  "months": 6,
  "total": 12,
  "has_more": true,
  "items": [
    {
      "post_id": "01a05575-7c9b-7232-8519-4a38fa061389",
      "slug": "DcpugJ2kzv8",
      "url": "https://www.instagram.com/p/DcpugJ2kzv8/",
      "post_type": "carousel",
      "posted_at": "2026-08-30T05:08:56Z",
      "text": "#광고 무겁지 않은 가을 데일리 팔레트 로즈밀크티 . .🫖🤎\n차분하고 미지근한 로즈핑크 팔레트인데\n부드러운 밀크티 무드라서 분위기가 넘 예뻐요..🥺\n\n데이지크에서 올리브영 X 산리오 콜라보\n시티팝 에디션으로 미니섀도우팔레트 4종이 출시되는데\n그 중 자주 추천드렸던 로즈밀크티, 밀크라떼가 있더라구요 !\n\nNEW 컬러 피치레코드, 모브카세트도 출시되어요🤍\n도시의 아침과 저녁 무드를 담은 데일리한 …",
      "like_count": 878,
      "comment_count": 19,
      "play_count": 0,
      "media_count": 15,
      "is_paid_partnership": null,
      "target_account_id": "018cab85-8ef8-7dc9-ab0a-7044d463f65e",
      "target_username": "dasique_official"
    },
    "… 1 more"
  ]
}

MCP 呼び出しとして

{
  "name": "solari_instagram_account_ad_posts",
  "arguments": {
    "username": "beinny_motd",
    "months": 6,
    "limit": 2
  }
}

注意点

target は 1 ブランドに絞り込むフィルタで、その account_id かハンドルのどちらでも受け付けます。
months のデフォルトは 3 で、最大 24 まで遡れます。account collabs より長いです。
同じ履歴をブランド単位でまとめて見るには account collabs をお使いください。

機械可読な形式: /docs/tools/instagram-account-ad-posts.md

概要

パラメータ

レスポンス

例

注意点

関連ツール