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

solari fetch instagram account

Ingest one Instagram handle into the catalog.

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

Overview

Add one Instagram account to the SOLARI catalog by exact username. This is not a search. If it is already stored, nothing is scraped.

When to use it — When catalog search does not know an exact handle you already have.

What comes back — Whether it was ingested, the account_id, and the catalog command to read it.

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.
account_iduuid
The ingested account.
usernamestring
Resolved handle.
notestring
What to expect next.
nextstring
Catalog command to read the result.

Example

Request

$ solari fetch instagram account username=innisfreeofficial

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

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

As an MCP call

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

Notes

  • Do not use this to search a name. Use catalog account search first.
  • A first-time ingest can take several seconds. Metrics and collaborations stay empty until the crawl finishes.

Related tools

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