instagram · fetch · hashtagsolari:read

solari fetch instagram hashtag posts

Collect a live page of a hashtag's posts.

MCP tool: solari_fetch_instagram_hashtag_posts
CLI: solari fetch instagram hashtag posts
Access: solari:readWorks with any signed-in SOLARI account.Works with any signed-in SOLARI account.
Required plan: Free
Credit: 0

Overview

Collect one live page of an Instagram hashtag feed, store the posts, and get them back in feed order. Every call goes out to Instagram, so read catalog tag search first.

When to use it — When a hashtag is missing or stale in catalog tag search, or you need its top posts or reels right now.

What comes back — The posts of that page, already stored, and a cursor for the next page.

Parameters

hashtagstringrequired: Hashtag, with or without #.≤ 150 chars
tabenumoptional: recent, top, or clips (reels).Valuesrecenttopclips
cursorstringoptional: next_cursor from the previous page.≤ 8192 chars

Response

ingestedboolean: true if this call stored at least one post.
fetched_on_demandboolean: Always true: every call collects live.
hashtagstring: The hashtag the fetch ran on, without #.
tabstring: Feed the page came from.
is_hiddenboolean: true if Instagram hides this hashtag's posts. items is empty then.
hidden_reasonstring | null: Instagram's label for a hidden hashtag.
foundinteger: Posts in items.
fetched_countinteger: Posts Instagram returned for this page. Higher than found when some could not be stored.
itemsobject[]: The posts of this page, in feed order.
next_cursorstring | null: Pass back as cursor for the next page. null when the feed ends.
notestring: What to expect next.
nextstring: Catalog command that reads the same tag later.

items[]

iduuid: Post id.
slugstring: Instagram shortcode.
textstring: Caption.
posted_attimestamp: Published at (UTC).
username / user_id / account_idstring: Authoring account.
like_count / comment_countinteger: Engagement.
play_countinteger | null: Video plays.
media_typestring: Post format.
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 yet.

Example

Request

$ solari fetch instagram hashtag posts hashtag=ootd tab=top

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

{
  "ingested": true,
  "fetched_on_demand": true,
  "hashtag": "ootd",
  "tab": "top",
  "is_hidden": false,
  "hidden_reason": null,
  "found": 1,
  "fetched_count": 1,
  "items": [
    {
      "id": "01a06a16-552d-7099-ae0a-77e6b68de960",
      "slug": "DaS66VzJBPW",
      "text": "SEOUL OOTD — 這次搭配了四種完全不同風格 #ootd #lynn__ootd #穿搭販賣機 #韓國穿搭",
      "posted_at": "2026-07-02T15:33:13Z",
      "virtual_campaign": null,
      "username": "llling_yinnnnn",
      "user_id": "019dbc46-1a67-7ef5-b95a-2fb466790d04",
      "account_id": "019dbc46-1a67-7ef5-b95a-2fb466790d04",
      "profile_picture_url": null,
      "like_count": 32,
      "comment_count": 1,
      "media_type": "reel",
      "play_count": 888,
      "media": []
    }
  ],
  "next_cursor": "eyJwIjoxLCJtIjoiUVZGRC4uLiJ9",
  "note": "These posts were collected live and are stored now. solari_catalog_instagram_tag_search lists them after its next daily refresh.",
  "next": "solari catalog instagram tag search query=#ootd"
}

As an MCP call

{
  "name": "solari_fetch_instagram_hashtag_posts",
  "arguments": {
    "hashtag": "ootd",
    "tab": "top"
  }
}

Notes

One page is roughly 20 to 30 posts and takes several seconds.
A cursor only works with the hashtag and tab it came from.
The feed ends only when next_cursor is null. A page can come back with found 0 and a next_cursor: keep going.
The posts are stored at once, but catalog tag search lists them only after its next daily refresh.
Media files of a just-collected post can take a moment to be stored, so asset_url may be null at first.

Machine-readable: /docs/tools/fetch-instagram-hashtag-posts.md

Overview

Parameters

Response

Example

Notes

Related tools