# solari fetch instagram post

> Collect one Instagram post by URL and get its author.

- **CLI**: `solari fetch instagram post`
- **MCP tool**: `solari_fetch_instagram_post`
- **Access**: `solari:read` — Available on any SOLARI plan, including the trial. One credit per successful call.
- **Plans**: Any paid plan or trial
- **Credit**: 1

Collect one Instagram post into the SOLARI catalog by its public URL or shortcode, and learn who posted it. If the post is already stored, nothing is scraped.

**When to use it** — When you were given a post link, catalog content detail says item=null, and you do not know the author.

**What comes back** — Whether it was collected, the post with its author, and the fetch command to crawl that author.

## Parameters

- `url` (string, optional, ≤ 512 chars) — Public post URL (/p/, /reel/, or /tv/).
- `slug` (string, optional, pattern ^[A-Za-z0-9_-]{3,20}$) — Instagram shortcode. Wins over url.

## 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.
- `found` (boolean) — false if Instagram has no public post at that reference.
- `post_id` (uuid) — The stored post.
- `account_id` (uuid) — The author's account.
- `username` (string) — The author's handle.
- `item` (object | null) — The post, with assets.
- `note` (string) — What to expect next.
- `next` (string) — Fetch command to crawl the author.

### `item`

- `post_id` (uuid) — Post id for other content tools.
- `slug` (string) — Shortcode from the public URL.
- `author_id` (uuid) — Author account_id.
- `username` (string) — Author username.
- `full_name` (string | null) — Display name.
- `profile_pic_url` (string | null) — Profile picture URL.
- `follower_count` (integer | null) — Author follower count.
- `region` (string | null) — Author region.
- `posted_at` (timestamp) — Published at (UTC).
- `media_type` (string) — image, video, or carousel.
- `play_count` (integer | null) — Video plays. Null for images.
- `like_count` (integer | null) — Likes.
- `text` (string | null) — Caption.
- `media_url` (string) — Media URL.
- `thumbnail_url` (string) — Thumbnail URL.
- `score` (number | null) — Ranking score for this response.
- `efficiency_score` (number | null) — Performance vs. the author's followers.
- `est_percentile` (number | null) — Region percentile, 0–1.
- `total_views_3m` (integer | null) — Author views in the last 3 months.
- `median_views_3m` (integer | null) — Author median views in the last 3 months.
- `recent_collab_brands` (string[]) — Brands the author recently collaborated with.
- `item_type` (string) — Item kind. post in these feeds.
- `content_source` (string | null) — Which feed surfaced this item.
- `is_saved` (boolean | null) — Whether it's saved in SOLARI.
- `updated_at` (timestamp | null) — When metrics were last refreshed.
- `assets` (object[]) — Media files in order. Each has asset_url, media_type, and video_duration.
- `assets[].asset_url` (string | null) — Direct download link to the full-size image or video. Null when no file is stored.

## Example

```console
$ solari fetch instagram post url=https://www.instagram.com/p/DcyMAmUh6FZ/
```

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

```json
{
  "ingested": true,
  "already_tracked": false,
  "fetched_on_demand": true,
  "found": true,
  "post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "username": "innisfreeofficial",
  "item": {
    "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "item_type": "content",
    "post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
    "author_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "username": "innisfreeofficial",
    "slug": "DcyMAmUh6FZ",
    "posted_at": "2026-09-02T12:00:06Z",
    "media_type": "video",
    "play_count": 22467,
    "like_count": 3224
  },
  "note": "Collected live and stored now. The author is known by name only: run next to crawl their profile and posts.",
  "next": "solari fetch instagram account username=innisfreeofficial"
}
```

## As an MCP call

```json
{
  "name": "solari_fetch_instagram_post",
  "arguments": {
    "url": "https://www.instagram.com/p/DcyMAmUh6FZ/"
  }
}
```

## Notes

- The author arrives as a name-only account. Run next (fetch instagram account) to crawl their profile and posts.
- A first-time collect takes a few seconds.

## Related tools

- [`solari_catalog_instagram_content_detail`](https://solari.sh/docs/tools/catalog-instagram-content-detail.md)
- [`solari_fetch_instagram_account`](https://solari.sh/docs/tools/fetch-instagram-account.md)
- [`solari_fetch_instagram_posts`](https://solari.sh/docs/tools/fetch-instagram-posts.md)