# solari fetch instagram account

> Ingest one Instagram handle into the catalog.

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

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

- `username` (string, required, ≤ 64 chars) — Instagram username.

## Response

### `Response`

- `ingested` (boolean) — true if this call collected it live.
- `already_tracked` (boolean) — true if it was already in the catalog.
- `fetched_on_demand` (boolean) — Same as ingested.
- `account_id` (uuid) — The ingested account.
- `username` (string) — Resolved handle.
- `note` (string) — What to expect next.
- `next` (string) — Catalog command to read the result.

## Example

```console
$ solari fetch instagram account username=innisfreeofficial
```

_Long strings and repeated array entries are trimmed for readability._

```json
{
  "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

```json
{
  "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

- [`solari_catalog_instagram_account_search`](https://solari.sh/docs/tools/catalog-instagram-account-search.md)
- [`solari_catalog_instagram_account_profile`](https://solari.sh/docs/tools/catalog-instagram-account-profile.md)
- [`solari_fetch_instagram_posts`](https://solari.sh/docs/tools/fetch-instagram-posts.md)