for agents
← All tools
instagram · fetchsolari:read

solari fetch instagram post

Collect one Instagram post by URL and get its author.

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

Overview

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

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

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 Instagram has no public post at that reference.
post_iduuid
The stored post.
account_iduuid
The author's account.
usernamestring
The author's handle.
itemobject | null
The post, with assets.
notestring
What to expect next.
nextstring
Fetch command to crawl the author.

item

post_iduuid
Post id for other content tools.
slugstring
Shortcode from the public URL.
author_iduuid
Author account_id.
usernamestring
Author username.
full_namestring | null
Display name.
profile_pic_urlstring | null
Profile picture URL.
follower_countinteger | null
Author follower count.
regionstring | null
Author region.
posted_attimestamp
Published at (UTC).
media_typestring
image, video, or carousel.
play_countinteger | null
Video plays. Null for images.
like_countinteger | null
Likes.
textstring | null
Caption.
media_urlstring
Media URL.
thumbnail_urlstring
Thumbnail URL.
scorenumber | null
Ranking score. Null outside ranked lists.
efficiency_scorenumber | null
Performance vs. the author's followers.
est_percentilenumber | null
Region percentile, 0–1.
total_views_3minteger | null
Author views in the last 3 months.
median_views_3minteger | null
Author median views in the last 3 months.
recent_collab_brandsstring[]
Brands the author recently collaborated with.
item_typestring
Item type. Always "content".
content_sourcestring | null
Which feed the post came from. Null when not from a feed.
is_savedboolean | null
Whether you saved this post in SOLARI. Null when unknown.
updated_attimestamp | null
When metrics were last refreshed.
assetsobject[]
Media files in order. Each has asset_url, media_type, and video_duration.
assets[].asset_urlstring | null
Direct download link to the full-size image or video. Null when no file is stored.

Example

Request

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

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

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

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

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