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

solari fetch instagram posts

Collect one Instagram account's posts into the catalog.

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

Overview

Collect posts for one Instagram account into the SOLARI catalog by exact username. This is not a post listing. If the handle is already stored, nothing is scraped.

When to use itWhen catalog posts does not know an exact handle you already have.

What comes backWhether it was ingested, how many posts came back, and the catalog command to read them.

Parameters

usernamestringrequired
Instagram username.≤ 64 chars

Response

Response

ingestedboolean
true if this call collected it live.
already_trackedboolean
true if it was already in the catalog.
fetched_on_demandboolean
Same as ingested.
foundboolean
false if the handle could not be collected.
account_iduuid
The ingested account.
usernamestring
Resolved handle.
totalinteger
Posts available so far.
notestring
What to expect next.
nextstring
Catalog command to read the result.

Example

Request

$ solari fetch instagram posts username=innisfreeofficial

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

{
  "ingested": false,
  "already_tracked": true,
  "fetched_on_demand": false,
  "found": true,
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "username": "innisfreeofficial",
  "total": 12,
  "note": "Already in the SOLARI catalog. Nothing was scraped.",
  "next": "solari catalog instagram account posts username=innisfreeofficial"
}

As an MCP call

{
  "name": "solari_fetch_instagram_posts",
  "arguments": {
    "username": "innisfreeofficial"
  }
}

Notes

  • Do not use this to list stored posts. Use catalog instagram account posts for that.
  • A first-time ingest can take several seconds. Only recent posts exist until the crawl finishes.

Machine-readable: /docs/tools/fetch-instagram-posts.md