instagram · accountsolari:read

solari instagram account ad posts

크리에이터가 작성한 광고 포스트의 행 단위 목록, 각 행에 타깃 브랜드 포함.

MCP 도구: solari_instagram_account_ad_posts
CLI: solari instagram account ad posts
권한: solari:read로그인한 SOLARI 계정이면 쓸 수 있어요.로그인한 SOLARI 계정이면 쓸 수 있어요.

개요

크리에이터 한 명이 작성한, 식별된 광고 포스트의 행 단위 페이지네이션 목록. 최신순이며 각 행에 타깃 브랜드가 붙어요 — 포스트-브랜드 쌍마다 한 행이므로, 여러 브랜드를 태그한 포스트는 타깃마다 한 번씩 나타나요. 각 항목은 post_id, slug와 url, post_type, posted_at, 캡션 텍스트, like/comment/play 수, media_count, is_paid_partnership, target_account_id/target_username을 담아요. target (브랜드의 account_id 또는 Instagram 핸들)으로 브랜드 하나만 필터링해요. months로 조회 기간을 넓혀요 (기본값 3, 최대 24). 같은 이력을 브랜드별로 묶어 주는 solari_instagram_account_collabs의 행 단위 짝이에요. 크리에이터는 account_id (SOLARI 계정 UUID) 또는 username (Instagram 핸들)으로 지정하며, 알 수 없는 참조는 not-found 에러를 반환해요. 로그인한 SOLARI 계정이면 누구나 사용할 수 있어요.

언제 쓰나 — 협업 이력을 원본 행 단위로 분석할 때. 여러 브랜드를 태그한 포스트는 타깃마다 한 번씩 나타나므로, 각 행은 포스트–브랜드 쌍이에요.

무엇이 돌아오나 — 광고 포스트, 최신순.

파라미터

account_idstring선택: 크리에이터의 account_id (SOLARI 계정 UUID). 이 값 또는 username을 넘기세요.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)$
usernamestring선택: Instagram 핸들. 앞의 @는 있어도 없어도 돼요. account_id가 지정되면 무시돼요.≤ 64 chars
monthsinteger선택: 조회 기간(개월), 기본값 3. 24를 넘는 값은 24로 잘려요.≥ 1
limitinteger선택: 페이지당 항목 수, 기본값 50. 200을 넘는 값은 200으로 잘려요.≥ 1
offsetinteger선택: 페이지네이션 offset, 기본값 0.기본값 0≥ 0
targetstring선택: 선택적 타깃 브랜드 필터: 브랜드의 account_id (SOLARI 계정 UUID) 또는 Instagram 핸들.≤ 64 chars

응답

Response

account_id / usernamestring: 확정된 크리에이터.
monthsinteger: 적용된 조회 기간.
totalinteger: 전체 행 수.
has_moreboolean: 다음 페이지가 있는지 여부.
itemsobject[]: 포스트–브랜드 쌍.

items[]

post_id / slug / urlstring: 포스트 식별자와 공개 링크.
post_typestring: reel, video, photo, 또는 carousel.
posted_attimestamp: 게시 시각 (UTC).
textstring: 캡션 텍스트.
like_count / comment_count / play_countinteger: 인게이지먼트 스냅샷.
media_countinteger: 미디어 개수.
is_paid_partnershipboolean | null: Instagram의 유료 광고 파트너십 라벨.
target_account_id / target_usernamestring: 이 행이 귀속된 브랜드.

예시

요청

$ solari instagram account ad posts username=beinny_motd months=6 limit=2

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

{
  "account_id": "018ecc75-55d8-70a7-a348-d370aa504ed9",
  "username": "beinny_motd",
  "months": 6,
  "total": 12,
  "has_more": true,
  "items": [
    {
      "post_id": "01a05575-7c9b-7232-8519-4a38fa061389",
      "slug": "DcpugJ2kzv8",
      "url": "https://www.instagram.com/p/DcpugJ2kzv8/",
      "post_type": "carousel",
      "posted_at": "2026-08-30T05:08:56Z",
      "text": "#광고 무겁지 않은 가을 데일리 팔레트 로즈밀크티 . .🫖🤎\n차분하고 미지근한 로즈핑크 팔레트인데\n부드러운 밀크티 무드라서 분위기가 넘 예뻐요..🥺\n\n데이지크에서 올리브영 X 산리오 콜라보\n시티팝 에디션으로 미니섀도우팔레트 4종이 출시되는데\n그 중 자주 추천드렸던 로즈밀크티, 밀크라떼가 있더라구요 !\n\nNEW 컬러 피치레코드, 모브카세트도 출시되어요🤍\n도시의 아침과 저녁 무드를 담은 데일리한 …",
      "like_count": 878,
      "comment_count": 19,
      "play_count": 0,
      "media_count": 15,
      "is_paid_partnership": null,
      "target_account_id": "018cab85-8ef8-7dc9-ab0a-7044d463f65e",
      "target_username": "dasique_official"
    },
    "… 1 more"
  ]
}

MCP 호출로 쓰면

{
  "name": "solari_instagram_account_ad_posts",
  "arguments": {
    "username": "beinny_motd",
    "months": 6,
    "limit": 2
  }
}

주의사항

target은 브랜드 하나로 필터링하며, account_id와 핸들 둘 다 받아요.
months는 기본값 3이고 최대 24까지 거슬러 올라가요 — account collabs보다 멀리 가요.
같은 이력을 브랜드별로 묶어서 보려면 account collabs를 사용하세요.

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

개요

파라미터

응답

예시

주의사항

관련 도구