for agents
← すべてのツール
instagram · catalog · accountsolari:read

solari catalog instagram account posts

Instagram アカウントの投稿。

MCP ツール
solari_catalog_instagram_account_posts
CLI
solari catalog instagram account posts
アクセス権
solari:read
対象プラン
  • 無料トライアル
  • Plus
  • Pro
  • Enterprise
クレジット
1

概要

Instagram アカウントの投稿を、メディア・タグ・いいね数と一緒に一覧で返します。日付や形式で絞り込めます。

どんなときに使うか — プロフィールのプレビューより多くの投稿が必要なとき。または期間や形式を指定したいとき。

返される内容 — 投稿。カルーセルの各スライドと、タグ付けされたアカウント・ハッシュタグを含みます。

パラメータ

account_idstring任意
account_id か 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
limitinteger任意
1 ページあたりの投稿の件数。既定値 121–200
offsetinteger任意
スキップする投稿の件数。既定値 0≥ 0
sincestring任意
この UTC の日付（YYYY-MM-DD）以降の投稿だけを返します。pattern ^\d{4}-\d{2}-\d{2}$
untilstring任意
この UTC の日付（YYYY-MM-DD）以前の投稿だけを返します。pattern ^\d{4}-\d{2}-\d{2}$
post_typeenum任意
reel, video, photo, carousel のいずれかに絞り込みます。値reelvideophotocarousel

レスポンス

Response

foundboolean
そのユーザー名が Instagram に存在しない場合は false。
account_id / usernamestring
特定したアカウント。
totalinteger
フィルターに合う投稿の数。
has_moreboolean
次のページがあるかどうか。
itemsobject[]
投稿。新しい順。
fetched_on_demandboolean
現時点で最新の投稿しか取得できていない場合は true。
collected_attimestamp
Instagram からプロフィールを最後に収集した時刻（UTC）。
posts_collected_attimestamp
保存済みの投稿がどこまで収集されているか（UTC）。それ以降の投稿はまだカタログにありません。
refreshes_regularlyboolean
定期的に再収集されるアカウントかどうか。
stored_post_count / profile_post_countinteger
カタログに保存された投稿数と、プロフィールに表示された投稿数。保存数がかなり少ない場合は収集が不十分です。
refreshedboolean
1 日以上前の保存データをこの呼び出しで再収集した場合は true。
notestring | null
結果が不完全な可能性がある理由、または found が false の理由（名前の変更や削除）。

items[]

post_iduuid
SOLARI の投稿 ID。
slugstring
Instagram のショートコード。
urlstring
公開パーマリンク。
post_typestring
reel, video, photo, carousel のいずれか。
posted_attimestamp
公開日時（UTC）。
textstring
キャプション。
like_count / comment_count / play_countinteger
エンゲージメント。
media_countinteger
メディアの数。
is_paid_partnershipboolean | null
Instagram の「タイアップ投稿」ラベル。
mediasobject[]
すべてのメディア（カルーセルの順番どおり）。
medias[].tagsobject[]
メディアにタグ付けされたアカウントとハッシュタグ。
thumbnail_urlstring
サムネイル。
assetsobject[]
メディアファイル（順番どおり）。それぞれに asset_url, media_type, video_duration があります。
assets[].asset_urlstring | null
元サイズの画像・動画を直接ダウンロードできるリンク。ファイルが保存されていない場合は null。

例

リクエスト

$ solari catalog instagram account posts username=innisfreeofficial limit=2

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

{
  "found": true,
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "username": "innisfreeofficial",
  "fetched_on_demand": false,
  "total": 4196,
  "has_more": true,
  "items": [
    {
      "post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
      "slug": "DcyMAmUh6FZ",
      "url": "https://www.instagram.com/p/DcyMAmUh6FZ/",
      "post_type": "reel",
      "posted_at": "2026-09-02T12:00:06+00:00",
      "text": "Deeply hydrated skin—NO OFF HOURS. 💚\nwherever the day takes MINGYU (@min9yu_k)—his hydration stays SUPERCHARGED ⚡️\n\nGreen Tea Ceramide Milk: Lightweight milky toner that won‘t clog your pores\nGreen Tea Ceramide Mist: Tou …",
      "like_count": 3224,
      "comment_count": 57,
      "play_count": 22467,
      "likes_hidden": false,
      "media_count": 1,
      "is_paid_partnership": false,
      "medias": [
        {
          "media_type": "video",
          "media_url": "https://smr-images-b.bzine.co/users/018cabce-14cc-7544-8890-7811ec33ef74/posts/01a06275-d974-7fda-98ee-dd3ee15b4dcf/medias/01a06275-db2b-77f7-a020-b4beb744771f.mp4",
          "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=0ms/https://smr-images.bzine.co/users/018cabce-14cc-7544-8890-7811ec33ef74/posts/01a06275-d974-7fda-98ee-dd3ee15b4dcf/medias/01a06275-db2b-77f7-a020-b4beb744771f.m …",
          "video_duration": 23.868000030517578,
          "tags": []
        }
      ],
      "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=0ms/https://smr-images.bzine.co/users/018cabce-14cc-7544-8890-7811ec33ef74/posts/01a06275-d974-7fda-98ee-dd3ee15b4dcf/medias/01a06275-db2b-77f7-a020-b4beb744771f.m …"
    },
    "… 1 more"
  ]
}

MCP で呼び出す場合

{
  "name": "solari_catalog_instagram_account_posts",
  "arguments": {
    "username": "innisfreeofficial",
    "limit": 2
  }
}

注意点

  • since と until は UTC の日付で、両端の日を含みます。
  • post_type=reel はショート動画です。video はリール以外の動画です。
  • カタログには抜けがあったり、古かったりすることがあります。solari fetch instagram posts username=…（再生数は type=reels）でその場で収集すると、投稿がそのまま返ります。
  • 指定した日付が posts_collected_at より後の場合、結果が空でも投稿がないとは限りません。solari fetch instagram posts username=… で最新の投稿をその場で収集してください。
  • likes_hidden が true のときは like_count を使わないでください。投稿者がいいね数を非表示にしているため、null か、実際の値ではない可能性があります。

関連ツール

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