for agents
← 전체 도구
instagram · catalog · contentsolari:read

solari catalog instagram content detail

id, shortcode, URL로 찾는 Instagram 게시물.

MCP 도구
solari_catalog_instagram_content_detail
CLI
solari catalog instagram content detail
권한
solari:read
이용 가능 플랜
  • 무료 체험
  • Plus
  • Pro
  • Enterprise
크레딧
1

개요

post_id, shortcode, 공개 URL로 Instagram 게시물 하나를 불러옵니다.

언제 쓰나요 — 게시물 하나가 필요할 때. id가 여러 개면 content batch 도구를 쓰세요.

돌려주는 값 — 캡션과 지표가 담긴 게시물.

파라미터

post_idstring선택
post_id. 이 값이나 slug, url 중 하나를 넣으세요.uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
slugstring선택
Instagram shortcode.pattern ^[A-Za-z0-9_-]{3,20}$
urlstring선택
Instagram 게시물 공개 URL.≤ 512 chars

응답

Response

itemobject | null
게시물. 없거나 공개되지 않은 게시물이면 null.
fetched_on_demandboolean
이번 호출에서 게시물을 실시간으로 가져왔으면 true.
notestring
item이 null일 때만 있습니다. 다음에 할 일.
nextstring
item이 null이고 게시물을 URL이나 shortcode로 넣었을 때만 있습니다. 그 게시물을 수집하는 fetch post 명령어.

item

post_iduuid
다른 콘텐츠 도구에 넣을 게시물 id.
slugstring
공개 URL에 들어 있는 shortcode.
author_iduuid
작성자 account_id.
usernamestring
작성자 사용자 이름.
full_namestring | null
표시 이름.
profile_pic_urlstring | null
프로필 사진 URL.
follower_countinteger | null
작성자 팔로워 수.
regionstring | null
작성자 지역.
posted_attimestamp
게시 시각(UTC).
media_typestring
image, video, carousel 중 하나.
play_countinteger | null
영상 재생 수. 이미지면 null입니다.
like_countinteger | null
좋아요 수.
textstring | null
캡션.
media_urlstring
미디어 URL.
thumbnail_urlstring
썸네일 URL.
scorenumber | null
순위 점수. 순위가 매겨진 목록이 아니면 null.
efficiency_scorenumber | null
작성자 팔로워 수 대비 성과.
est_percentilenumber | null
지역 안 백분위(0~1).
total_views_3minteger | null
작성자의 최근 3개월 조회수.
median_views_3minteger | null
작성자의 최근 3개월 조회수 중앙값.
recent_collab_brandsstring[]
작성자가 최근 협업한 브랜드.
item_typestring
항목 종류. 항상 "content".
content_sourcestring | null
게시물이 나온 피드. 피드에서 온 게 아니면 null.
is_savedboolean | null
SOLARI에 이 게시물을 저장했는지. 알 수 없으면 null.
updated_attimestamp | null
지표를 마지막으로 갱신한 시각.
assetsobject[]
미디어 파일 목록(순서대로). 파일마다 asset_url, media_type, video_duration이 있습니다.
assets[].asset_urlstring | null
원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 null입니다.

예시

요청

$ solari catalog instagram content detail slug=DcyMAmUh6FZ

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

{
  "item": {
    "item_type": "content",
    "post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
    "author_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "username": "innisfreeofficial",
    "full_name": "INNISFREE | 이니스프리",
    "profile_pic_url": "https://dcr.bzine.co/instagram/users/innisfreeofficial/profile-picture",
    "follower_count": 847619,
    "region": null,
    "posted_at": "2026-09-02T12:00:06Z",
    "media_type": "video",
    "play_count": 22467,
    "like_count": 3224,
    "score": null,
    "efficiency_score": null,
    "est_percentile": null,
    "updated_at": null,
    "media_url": "https://smr-images-b.bzine.co/users/018cabce-14cc-7544-8890-7811ec33ef74/posts/01a06275-d974-7fda-98ee-dd3ee15b4dcf/medias/01a06275-db2b-77f7-a020-b4beb744771f.mp4",
    "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=0ms/https://smr-images.bzine.co/users/018cabce-14cc-7544-8890-7811ec33ef74/posts/01a06275-d974-7fda-98ee-dd3ee15b4dcf/medias/01a06275-db2b-77f7-a020-b4beb744771f.m …",
    "slug": "DcyMAmUh6FZ",
    "text": "Deeply hydrated skin—NO OFF HOURS. 💚\nwherever the day takes MINGYU (@min9yu_k)—his hydration stays SUPERCHARGED ⚡️\n\nGreen Tea Ceramide Milk: Lightweight milky toner that won‘t clog your pores\nGreen Tea Ceramide Mist: Tou …",
    "brand_match_score": null,
    "recent_collab_brands": [],
    "total_views_3m": null,
    "median_views_3m": null,
    "is_saved": null,
    "content_source": null
  },
  "fetched_on_demand": false
}

MCP 호출

{
  "name": "solari_catalog_instagram_content_detail",
  "arguments": {
    "slug": "DcyMAmUh6FZ"
  }
}

주의사항

  • url에는 /p/, /reel/, /tv/ 링크를 아무거나 넣으면 됩니다. shortcode는 알아서 뽑습니다.
  • SOLARI에 모아 둔 데이터만 읽습니다. 아직 수집하지 않은 게시물은 solari fetch instagram post url=…로 가져오세요. 작성자도 함께 알려 줍니다. 작성자를 이미 알면 solari fetch instagram posts username=…를 쓰세요.
  • likes_hidden이 true면 like_count를 쓰지 마세요. 작성자가 좋아요를 숨겨서 null이거나 실제 값이 아닐 수 있습니다.

관련 도구

에이전트용 문서: /docs/tools/catalog-instagram-content-detail.md