instagram · insight · accountsolari:read

solari insight instagram account discover

キャンペーンのブリーフに合う Instagram クリエイターを探します。

MCP ツール

solari_insight_instagram_account_discover

アクセス権

solari:read

対象プラン

無料トライアル
Plus
Pro
Enterprise

クレジット

概要

ブリーフをもとにクリエイターの候補リストを作ります。条件にできるのは、投稿の内容、プロフィール文、似ているクリエイター、伸びているかどうか、過去に広告を出した商品です。フォロワー数と 3 か月の再生回数で絞り込み、除外キーワードに当てはまるクリエイターは外せます。

どんなときに使うか — まだ知らないクリエイターを探したいとき。名前がわかっているなら catalog account search を使います。

返される内容 — search_id、見つかった総数、上位のユーザー名のプレビュー、結果のセクション。全件は discover results でページごとに取得します。

パラメータ

intentstring必須: ブリーフを 1 文で。結果のラベルとして使われます。≤ 300 chars
topic_keywordsstring[]任意: 投稿の内容を表す 2〜3 個のフレーズ。対象市場の言語で書きます。複数の単語からなるフレーズのほうが精度が上がります。1–3 items
profile_keywordsstring[]任意: プロフィール文で探す 1〜2 個のフレーズ。職業名や得意ジャンルなど。1–2 items
similar_usernamestring任意: 参考にするクリエイターのユーザー名。そのクリエイターに似たクリエイターを追加します。≤ 64 chars
trendingboolean任意: 再生回数が急上昇しているクリエイターも追加します。既定値 false
product_querystring任意: 商品の短い説明（英語）。似た商品を広告したことのあるクリエイターを優先します。≤ 200 chars
follower_mininteger任意: フォロワー数の下限。≥ 0
follower_maxinteger任意: フォロワー数の上限。≥ 0
total_views_mininteger任意: 直近 3 か月の再生回数の合計の下限。≥ 0
total_views_maxinteger任意: 直近 3 か月の再生回数の合計の上限。≥ 0
median_views_mininteger任意: 直近 3 か月の投稿あたりの再生回数の中央値の下限。≥ 0
median_views_maxinteger任意: 直近 3 か月の投稿あたりの再生回数の中央値の上限。≥ 0
negative_keywordsstring[]任意: プロフィール文か投稿にこれらの語句が 1 つでも含まれるクリエイターを除きます。1–10 items
media_focusenum任意: 見た目のスタイルを照合するとき、写真と動画のどちらの投稿を重視するか。既定値 "balanced"値balancedphotovideo
regionstring任意: KR, JP, US などの国コード。既定値 "KR"
brand_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)$
brand_usernamestring任意: ブランドのユーザー名。brand_account_id を指定した場合は無視されます。≤ 64 chars
limitinteger任意: プレビューに含める上位ユーザー名の件数。全件の一覧は常に別途ページごとに取得します。既定値 201–60

レスポンス

Response

search_iduuid: discover results に渡すと、全件の一覧をページごとに取得できます。
intentstring: 結果のラベルとして使うブリーフ。
totalinteger: 見つかったクリエイターの数。
top_usernamesstring[]: 最も合うクリエイターのプレビュー。合う順に並びます。
sectionsobject[]: 結果のグループ分け。
duration_msinteger: 検索にかかった時間。
nextstring: 全件の一覧をページごとに取得するコマンド。

sections[]

typestring: 最も合うクリエイターは best_match、それ以外は full_results。
labelstring: 表示用のラベル。
countinteger: そのセクションの最初のページに含まれるクリエイター。
has_moreboolean: そのセクションに 2 ページ目以降があるかどうか。

例

リクエスト

$ solari insight instagram account discover intent="KR makeup creators for an autumn eyeshadow palette launch" topic_keywords='["가을 메이크업 팔레트","데일리 아이섀도우"]' follower_min=10000 follower_max=300000 region=KR limit=5

レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。

{
  "search_id": "01a0f3c2-7e41-7b9a-8d2c-5e6f1a9b3c47",
  "intent": "KR makeup creators for an autumn eyeshadow palette launch",
  "total": 184,
  "top_usernames": [
    "beinny_motd",
    "donge_cos",
    "… 18 more"
  ],
  "sections": [
    {
      "type": "best_match",
      "label": "베스트 매칭",
      "count": 12,
      "has_more": false
    },
    {
      "type": "full_results",
      "label": "전체 결과",
      "count": 48,
      "has_more": true
    }
  ],
  "duration_ms": 23871,
  "next": "solari insight instagram account discover results search_id=01a0f3c2-7e41-7b9a-8d2c-5e6f1a9b3c47"
}

MCP で呼び出す場合

{
  "name": "solari_insight_instagram_account_discover",
  "arguments": {
    "intent": "KR makeup creators for an autumn eyeshadow palette launch",
    "topic_keywords": [
      "가을 메이크업 팔레트",
      "데일리 아이섀도우"
    ],
    "follower_min": 10000,
    "follower_max": 300000,
    "region": "KR",
    "limit": 5
  }
}

注意点

topic_keywords, profile_keywords, similar_username, product_query, trending=true のうち、少なくとも 1 つを指定してください。
条件が広いと、最大 1 分ほどかかることがあります。
search_id は有効なまま残ります。あとから検索し直さずに、並べ替えやページ移動ができます。

機械可読な形式: /docs/tools/insight-instagram-account-discover.md

概要

パラメータ

レスポンス

例

注意点

関連ツール