for agents
← 전체 도구
instagram · insight · rankingsolari:read

solari insight instagram ranking posts

순위 행 뒤에 있는 상위 게시물.

MCP 도구
solari_insight_instagram_ranking_posts
CLI
solari insight instagram ranking posts
권한
solari:read
이용 가능 플랜
  • 무료 체험
  • Plus
  • Pro
  • Enterprise
크레딧
1

개요

순위표 한 행 뒤에 있는 성과가 가장 좋은 게시물입니다. 브랜드나 크리에이터 수치의 근거가 됩니다. 게시물마다 협찬 여부가 표시되고, kind=organic이면 비협찬 게시물만 남깁니다.

언제 쓰나요 — 브랜드나 크리에이터 순위를 본 뒤, 한 행의 수치가 어디서 나왔는지 보고 싶을 때.

돌려주는 값 — 작성자 정보가 붙은 상위 게시물. 성과가 좋은 순서입니다.

파라미터

boardenum필수
brand 또는 creator. 행이 나온 순위표입니다.값brandcreator
account_idstring필수
순위 행의 account_id.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)$
regionenum선택
목록과 같은 시장.기본값 "KR"값KRJPUS
daysinteger선택
목록과 같은 기간. 30 또는 90.기본값 30
scopestring선택
크리에이터 순위표만. 목록에서 쓴 것과 같은 scope.≤ 120 chars
kindenum선택
all, 협찬 게시물만 보는 sponsored, 비협찬 게시물만 보는 organic 중 하나.기본값 "all"값allsponsoredorganic
limitinteger선택
받을 게시물 수.기본값 61–12

응답

Response

account_iduuid
행의 계정.
kindstring
all, sponsored, organic 중 하나.
checked_top_postsinteger
kind=organic일 때만. 행의 상위 게시물 중 확인한 개수.
itemsobject[]
상위 게시물. 성과가 좋은 순서입니다.

items[]

post_id / slugstring
게시물 식별자.
posted_attimestamp | null
게시 시각(UTC).
media_typestring
image 또는 video.
thumbnail_urlstring
썸네일 URL.
media_urlstring | null
미디어 URL. 파일이 저장돼 있지 않으면 null.
play_countinteger | null
영상 재생 수.
sponsoredboolean
협찬 게시물인지 여부.
authorobject
account_id, username, full_name, follower_count, profile_pic_url.

예시

요청

$ solari insight instagram ranking posts board=brand account_id=018cabce-14cc-7544-8890-7811ec33ef74 region=KR limit=2

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

{
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "kind": "all",
  "items": [
    {
      "post_id": "01a04c73-3ec3-7873-9e84-334c644abfe4",
      "slug": "DckGrZ6vZiU",
      "posted_at": "2026-08-21T10:03:52+00:00",
      "media_type": "video",
      "media_url": null,
      "thumbnail_url": "https://dcr.bzine.co/instagram/posts/DckGrZ6vZiU/thumbnails/m",
      "play_count": 155729,
      "author": {
        "account_id": "0196c474-c96e-71ad-aceb-61af051c81d3",
        "user_id": "0196c474-c96e-71ad-aceb-61af051c81d3",
        "username": "hwitto_",
        "full_name": null,
        "follower_count": 48210,
        "profile_pic_url": "https://dcr.bzine.co/instagram/users/hwitto_/profile-picture"
      },
      "sponsored": true
    },
    "… 1 more"
  ]
}

MCP 호출

{
  "name": "solari_insight_instagram_ranking_posts",
  "arguments": {
    "board": "brand",
    "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "region": "KR",
    "limit": 2
  }
}

주의사항

  • 목록과 같은 region, days, (크리에이터라면) scope를 쓰세요. 다르면 게시물이 수치와 맞지 않습니다.
  • 브랜드 순위표에서는 작성자가 대부분 브랜드를 태그하거나 멘션한 크리에이터입니다.
  • 행마다 조회수 기준 상위 6개 게시물만 보관합니다. kind=organic은 그중 비협찬 게시물만 돌려주니까 개수가 적거나 비어 있을 수 있습니다.

관련 도구

에이전트용 문서: /docs/tools/insight-instagram-ranking-posts.md