instagram · fetchsolari:readAvailable on any SOLARI plan, including the trial. One credit per successful call.
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:readAvailable on any SOLARI plan, including the trial. One credit per successful call.Available on any SOLARI plan, including the trial. One credit per successful call.
- Plans
- Any paid plan or trial
- 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 for this response.
- 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 kind. post in these feeds.
- content_sourcestring | null
- Which feed surfaced this item.
- is_savedboolean | null
- Whether it's saved in SOLARI.
- 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
- solari_catalog_instagram_content_detailAn Instagram post, by id, shortcode, or URL.
- solari_fetch_instagram_accountIngest one Instagram handle into the catalog.
- solari_fetch_instagram_postsCollect one Instagram account's posts into the catalog.
Machine-readable: /docs/tools/fetch-instagram-post.md