instagram · insight · rankingsolari:read

solari insight instagram ranking brands

주변 콘텐츠 성과로 Instagram 브랜드 순위를 매깁니다.

MCP 도구

solari_insight_instagram_ranking_brands

권한

solari:read

이용 가능 플랜

무료 체험
Plus
Pro
Enterprise

크레딧

개요

한 시장의 브랜드 순위표입니다. 브랜드를 태그하거나 멘션한 게시물의 성과로 순위를 매깁니다. 행마다 협찬 게시물과 비협찬 게시물을 나눠서 보여 줍니다. 그래서 브랜드의 비협찬 성과와 도달 중 유료 비중을 함께 볼 수 있습니다.

언제 쓰나요 — 카테고리 1위가 누구인지, 한 브랜드가 몇 위인지, 비협찬 콘텐츠 성과가 어떤지 알고 싶을 때. 크리에이터는 크리에이터 순위 도구를 쓰세요.

돌려주는 값 — 순위가 매겨진 브랜드 한 페이지. 내 브랜드 위치(me)와 찾아 달라고 한 브랜드(lookup)도 함께 옵니다.

파라미터

regionenum선택: KR, JP, US 중 하나.기본값 "KR"값KRJPUS
daysinteger선택: 30 또는 90.기본값 30
sortenum선택: 순위 기준. 총 조회수, 게시물당 조회수, 게시물 수, 크리에이터 수, 좋아요, 협찬 조회수, 비협찬 조회수 중 하나.기본값 "plays"값playsmedian_playspostscreatorslikessponsored_playsorganic_plays
scopestring선택: 카테고리. all, d1:<group>, d2:<group>/<category> 중 하나. 쓸 수 있는 값은 categories와 category_groups에 옵니다.≤ 120 chars
brand_account_idstring선택: 내 브랜드 account_id. 기본 카테고리를 정하고 내 순위를 me로 돌려줍니다.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)$
brand_usernamestring선택: 내 브랜드 username. brand_account_id가 있으면 무시합니다.≤ 64 chars
find_usernamestring선택: 이 순위표에서 위치를 찾을 브랜드 username.≤ 64 chars
min_postsinteger선택: 게시물이 이 개수 이상인 브랜드만. 1, 3, 10 중 하나.기본값 1
limitinteger선택: 한 페이지에 받을 행 수.기본값 201–100
offsetinteger선택: 건너뛸 행 수.기본값 0≥ 0

응답

Response

region / days / sort / min_postsstring · integer: 적용된 설정.
scopestring: 순위를 매긴 카테고리.
scope_sourcestring: explicit(직접 지정), brand_default(내 브랜드의 대표 카테고리), default(all) 중 하나.
totalinteger: 이 카테고리에 있는 브랜드 수.
median_metricnumber | null: 카테고리 전체의 정렬 지표 중앙값. 첫 페이지에만 옵니다.
sponsored_share_mediannumber | null: 협찬 게시물 비중의 중앙값(0–1). 첫 페이지에만 옵니다.
snapshot_attimestamp | null: 순위표를 만든 시각.
itemsobject[]: 순위가 매겨진 브랜드.
meobject | null: 내 브랜드의 rank, total, top_pct, row.
me_reasonstring | null: me가 null인 이유. no_brand, not_in_category, below_min_posts, no_posts 중 하나.
lookupobject | null: find_username으로 찾은 브랜드의 rank, total, top_pct, row.
lookup_reasonstring | null: lookup이 null인 이유. not_in_category, below_min_posts, no_posts 중 하나.
lookup_scopesstring[]: 찾은 브랜드가 속한 카테고리를 scope 값으로 담았습니다. 이 중 하나로 다시 요청하세요.
brand_categoriesobject[]: 내 브랜드의 카테고리. 비중이 큰 순서입니다.
categories / category_groupsobject[]: 쓸 수 있는 scope 값과 각각의 브랜드 수.

items[] · me.row · lookup.row

rankinteger: 순위표에서의 순위.
account_iduuid: 다른 도구에 넘기는 account_id.
username / full_namestring: 핸들과 표시 이름.
follower_countinteger | null: 팔로워 수.
post_count / creator_countinteger: 브랜드에 관한 게시물 수와 그 게시물을 만든 크리에이터 수.
total_plays / median_playsinteger: 총 조회수와 게시물당 조회수.
total_likes / total_commentsinteger: 참여.
sponsored_post_count / sponsored_total_plays / sponsored_median_playsinteger: 협찬 게시물만 따로 센 같은 수치.
organic_median_playsinteger | null: 비협찬 게시물의 게시물당 조회수.
organic_post_count / organic_total_playsinteger | null: 협찬을 뺀 게시물 수와 총 조회수. 수치가 맞지 않으면 null.
sponsored_sharenumber | null: 전체 게시물 중 협찬 게시물 비중(0–1). 게시물이 없으면 null.
sponsored_reel_count / organic_reel_countinteger | null: 각 부분 집합의 릴스 수.
categoriesstring[]: 브랜드의 카테고리. <group>/<category> 형식입니다.

예시

요청

$ solari insight instagram ranking brands region=KR days=30 find_username=innisfreeofficial limit=1

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

{
  "region": "KR",
  "days": 30,
  "sort": "plays",
  "scope": "all",
  "scope_source": "default",
  "min_posts": 1,
  "offset": 0,
  "limit": 1,
  "total": 21483,
  "median_metric": 18250,
  "sponsored_share_median": 0.25,
  "snapshot_at": "2026-09-22T19:04:11.482913+00:00",
  "me_reason": "no_brand",
  "lookup_username": "innisfreeofficial",
  "lookup_reason": null,
  "lookup_scopes": [],
  "brand_categories": [],
  "categories": [
    {
      "depth_1": "BEAUTY",
      "depth_2": "MAKEUP",
      "brands": 1622
    },
    {
      "depth_1": "BEAUTY",
      "depth_2": "SKINCARE",
      "brands": 1843
    },
    "… 41 more"
  ],
  "category_groups": [
    {
      "depth_1": "BEAUTY",
      "brands": 3120
    },
    "… 11 more"
  ],
  "items": [
    {
      "account_id": "018cab6d-1648-7071-9734-c47a2be2fd19",
      "rank": 1,
      "user_id": "018cab6d-1648-7071-9734-c47a2be2fd19",
      "username": "oliveyoung_official",
      "full_name": "올리브영 OLIVE YOUNG",
      "follower_count": 1199628,
      "post_count": 18342,
      "creator_count": 6120,
      "total_plays": 412880000,
      "median_plays": 9840,
      "total_likes": 15230000,
      "total_comments": 402100,
      "sponsored_post_count": 7010,
      "sponsored_total_plays": 131200000,
      "sponsored_median_plays": 11200,
      "organic_median_plays": 9100,
      "sponsored_reel_count": 5230,
      "organic_reel_count": 8120,
      "categories": [
        "BEAUTY/SKINCARE",
        "BEAUTY/MAKEUP"
      ],
      "organic_post_count": 11332,
      "organic_total_plays": 281680000,
      "sponsored_share": 0.3822
    }
  ],
  "me": null,
  "lookup": {
    "rank": 7,
    "total": 21483,
    "top_pct": 0.1,
    "row": {
      "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "rank": 7,
      "user_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "username": "innisfreeofficial",
      "full_name": "INNISFREE | 이니스프리",
      "follower_count": 847619,
      "post_count": 1204,
      "creator_count": 688,
      "total_plays": 38920400,
      "median_plays": 14120,
      "total_likes": 1182300,
      "total_comments": 30440,
      "sponsored_post_count": 402,
      "sponsored_total_plays": 17610200,
      "sponsored_median_plays": 21800,
      "organic_median_plays": 11900,
      "sponsored_reel_count": 318,
      "organic_reel_count": 611,
      "categories": [
        "BEAUTY/SKINCARE"
      ],
      "organic_post_count": 802,
      "organic_total_plays": 21310200,
      "sponsored_share": 0.3339
    }
  }
}

MCP 호출

{
  "name": "solari_insight_instagram_ranking_brands",
  "arguments": {
    "region": "KR",
    "days": 30,
    "find_username": "innisfreeofficial",
    "limit": 1
  }
}

주의사항

순위표는 매일 새로 만듭니다. 만든 시각은 snapshot_at에 있습니다.
브랜드를 넣고 scope를 비우면 all이 아니라 그 브랜드의 대표 카테고리 순위표가 열립니다.
me와 lookup은 첫 페이지(offset=0)에서만 옵니다.

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

개요

파라미터

응답

예시

주의사항

관련 도구