← 전체 도구
instagram · fetch · hashtagsolari:read로그인한 SOLARI 계정이면 쓸 수 있어요.

solari fetch instagram hashtag posts

Collect a live page of a hashtag's posts.

MCP 도구
solari_fetch_instagram_hashtag_posts
CLI
solari fetch instagram hashtag posts
권한
solari:read로그인한 SOLARI 계정이면 쓸 수 있어요.로그인한 SOLARI 계정이면 쓸 수 있어요.
Required plan
Free
Credit
0

개요

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 a hashtag is missing or stale in catalog tag search, or you need its top posts or reels right now.

무엇이 나오나 — The posts of that page, already stored, and a cursor for the next page.

파라미터

hashtagstring필수
Hashtag, with or without #.≤ 150 chars
tabenum선택
recent, top, or clips (reels).값recenttopclips
cursorstring선택
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.

예시

요청

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

응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였어요.

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

MCP 호출로 쓰면

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

주의사항

  • 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.

관련 도구

기계가 읽는 형식: /docs/tools/fetch-instagram-hashtag-posts.md