All tools
instagram · catalog · accountsolari:readWorks with any signed-in SOLARI account.

solari catalog instagram account posts

Posts from an Instagram account.

MCP tool
solari_catalog_instagram_account_posts
CLI
solari catalog instagram account posts
Access
solari:readWorks with any signed-in SOLARI account.Works with any signed-in SOLARI account.
Required plan
Free
Credit
0

Overview

List an Instagram account's posts with media, tags, and likes. You can filter by date or format.

When to use itWhen you need more posts than the profile preview, or a date range or format.

What comes backPosts, including carousel slides and tagged accounts or hashtags.

Parameters

account_idstringoptional
Pass account_id or 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)$
usernamestringoptional
Instagram username. Ignored when account_id is set.≤ 64 chars
limitintegeroptional
How many posts per page.≥ 1
offsetintegeroptional
How many posts to skip.default 0≥ 0
sincestringoptional
Only posts on or after this UTC date (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
untilstringoptional
Only posts on or before this UTC date (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
post_typeenumoptional
Limit to reel, video, photo, or carousel.Valuesreelvideophotocarousel

Response

Response

foundboolean
false if the username is not on Instagram.
account_id / usernamestring
The resolved account.
totalinteger
Posts matching the filters.
has_moreboolean
Whether there is another page.
itemsobject[]
Posts, newest first.
fetched_on_demandboolean
true when only the most recent posts are available so far.

items[]

post_iduuid
SOLARI post id.
slugstring
Instagram shortcode.
urlstring
Public permalink.
post_typestring
reel, video, photo, or carousel.
posted_attimestamp
Published at (UTC).
textstring
Caption.
like_count / comment_count / play_countinteger
Engagement.
media_countinteger
Number of medias.
is_paid_partnershipboolean | null
Instagram paid-partnership label.
mediasobject[]
Every media in carousel order.
medias[].tagsobject[]
Accounts and hashtags tagged on the media.
thumbnail_urlstring
Thumbnail.

Example

Request

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

Response · Long strings and repeated array entries are trimmed for readability.

{
  "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,
      "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"
  ]
}

As an MCP call

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

Notes

  • since and until are UTC dates, and both ends are included.
  • post_type=reel is short-form video. video is a non-reel video.
  • This reads the catalog only. If the username is missing, call solari fetch instagram posts username=… then retry.

Machine-readable: /docs/tools/catalog-instagram-account-posts.md