← 전체 도구
instagram · insight · brandsolari:read

solari insight instagram brand ad posts

Instagram 브랜드의 광고 게시물.

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

개요

브랜드의 광고 게시물을 크리에이터 정보와 함께 보여 줍니다.

언제 쓰나요 — 합계만이 아니라 게시물 자체가 필요할 때.

돌려주는 값 — 광고 게시물. 합계는 sort=recent일 때만 정확합니다.

파라미터

usernamestring필수
브랜드의 Instagram 사용자 이름. @는 빼고 넣으세요.
sortenum선택
recent는 기간 전체를 훑습니다. engagement는 최근 일부만 순위를 매깁니다.기본값 "recent"값recentengagement
monthsinteger선택
몇 개월 전까지 볼지.기본값 31–24
limitinteger선택
한 페이지에 가져올 게시물 수.기본값 501–200
offsetinteger선택
건너뛸 게시물 수.기본값 0≥ 0

응답

Response

itemsobject[]
협찬 게시물.
totalinteger
sort=recent일 때 기간 전체의 정확한 개수.
has_moreboolean
다음 페이지가 있는지 여부.
ranking_windowinteger | null
참여 순위를 매긴 범위. 기간 전체가 아니라 일부만 정렬했을 때 채워집니다.

items[]

iduuid
게시물 id.
slugstring
Instagram shortcode.
textstring
캡션.
posted_attimestamp
게시 시각(UTC).
username / user_id / account_idstring
게시물을 올린 크리에이터.
like_count / comment_count / play_countinteger
참여 지표.
media_typestring
게시물 형식.
media / media_url / thumbnail_urlstring
미디어 링크.
virtual_campaignobject | null
캠페인 묶음. 캠페인을 찾았을 때만 있습니다.
assetsobject[]
미디어 파일 목록(순서대로). 파일마다 asset_url, media_type, video_duration이 있습니다.
assets[].asset_urlstring | null
원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 null입니다.

예시

요청

$ solari insight instagram brand ad posts username=innisfreeofficial limit=2

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

{
  "items": [
    {
      "id": "01a062a0-2747-72eb-b20d-670cf30f2c96",
      "slug": "DcygG05GrA-",
      "text": "#광고 요즘 부쩍 신경 쓰이기 시작한 모공 고민을 직접 경험해보고 싶어 방문한 이니스프리 레티놀 시카 강의실 무빙 팝업💙\n\n업그레이드된 레티놀 시카 모공 흔적 앰플을 직접 테스트해볼 수 있을 뿐 아니라, 제품을 알아보고 체험할 수 있는 다양한 프로그램과 이벤트가 마련되어 있어 더욱 재미있게 둘러볼 수 있었어요.\n\n특히 오늘 방문했을 때는 정말 많은 분들이 찾아와서 놀랐는데요. 대기 줄이 길게 …",
      "posted_at": "2026-09-02T14:56:19Z",
      "virtual_campaign": null,
      "username": "_mini_mming",
      "user_id": "018caf92-e08a-78a2-b9c3-59f6f5740182",
      "profile_picture_url": null,
      "like_count": 384,
      "comment_count": 4,
      "thumbnail_url": null,
      "media_url": null,
      "media": [],
      "media_type": "post",
      "account_id": "018caf92-e08a-78a2-b9c3-59f6f5740182"
    },
    "… 1 more"
  ],
  "total": 405,
  "has_more": true,
  "ranking_window": null
}

MCP 호출

{
  "name": "solari_insight_instagram_brand_ad_posts",
  "arguments": {
    "username": "innisfreeofficial",
    "limit": 2
  }
}

주의사항

  • username을 넣으세요. 없는 username이면 404가 나옵니다.
  • sort=engagement는 최근 일부 게시물만 순위를 매깁니다. 얼마나 거슬러 봤는지는 ranking_window에 나옵니다.
  • likes_hidden이 true면 like_count를 쓰지 마세요. 작성자가 좋아요를 숨겨서 null이거나 실제 값이 아닐 수 있습니다.

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