for agents
← All tools
instagram · fetchsolari:read

solari fetch instagram account

Ingest one Instagram handle into the catalog.

MCP tool
solari_fetch_instagram_account
CLI
solari fetch instagram account
Access
solari:read
Plans
  • Free Trial
  • Plus
  • Pro
  • Enterprise
Credit
1

Overview

Add one Instagram account to the SOLARI catalog by exact username. This is not a search. An account collected within the last day is not scraped again; an older copy is re-collected now. A handle the catalog only knows by name from a tag or mention is crawled now.

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 crawled.
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.
refreshedboolean
true if a stored copy older than a day was re-collected now.
collected_attimestamp
When the stored profile was collected (UTC).

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.
  • A handle that catalog search cannot find but whose profile comes back empty is a name-only placeholder. This call crawls it.

Related tools

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