instagram · insight · accountsolari:read

solari insight instagram account discover

Find Instagram creators that fit a campaign brief.

MCP tool: solari_insight_instagram_account_discover
CLI: solari insight instagram account discover
Access: solari:readAvailable on any SOLARI plan, including the trial. One credit per successful call.Available on any SOLARI plan, including the trial. One credit per successful call.
Plans: Any paid plan or trial
Credit: 1

Overview

Build a creator shortlist from a brief: what they post about, what their bio says, who they resemble, whether they're growing, and what they've advertised before. Filter by followers and 3-month views, and drop anyone matching excluded keywords.

When to use it — When you need creators you don't know yet. If you already have a name, use catalog account search.

What comes back — A search_id, the total found, a preview of top usernames, and the result sections. Page the full list with discover results.

Parameters

intentstringrequired: The brief in one sentence. It becomes the result label.≤ 300 chars
topic_keywordsstring[]optional: 2–3 phrases about the content, in the target market's language. Multi-word phrases work better.1–3 items
profile_keywordsstring[]optional: 1–2 phrases to look for in bios, such as a job title or niche.1–2 items
similar_usernamestringoptional: A reference creator's username. Adds creators like them.≤ 64 chars
trendingbooleanoptional: Also add creators whose views are growing fast.default false
product_querystringoptional: Short English product description. Favors creators who advertised something similar.≤ 200 chars
follower_minintegeroptional: Minimum followers.≥ 0
follower_maxintegeroptional: Maximum followers.≥ 0
total_views_minintegeroptional: Minimum total views over the last 3 months.≥ 0
total_views_maxintegeroptional: Maximum total views over the last 3 months.≥ 0
median_views_minintegeroptional: Minimum median views per post over the last 3 months.≥ 0
median_views_maxintegeroptional: Maximum median views per post over the last 3 months.≥ 0
negative_keywordsstring[]optional: Drop creators whose bio or posts contain any of these.1–10 items
media_focusenumoptional: Favor photo or video posts when matching visual style.default "balanced"Valuesbalancedphotovideo
regionstringoptional: Country code such as KR, JP, or US.default "KR"
brand_account_idstringoptional: Brand account_id. Ranks creators by fit with the brand's audience.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_usernamestringoptional: Brand username. Ignored when brand_account_id is set.≤ 64 chars
limitintegeroptional: How many top usernames to preview. The full list is always paged separately.≥ 1

Response

search_iduuid: Pass to discover results to page the full list.
intentstring: The brief, as the result label.
totalinteger: Creators found.
top_usernamesstring[]: Preview of the best matches, best first.
sectionsobject[]: How the results are grouped.
duration_msinteger: How long the search took.
nextstring: Command that pages the full list.

sections[]

typestring: best_match for the strongest fits, full_results for the rest.
labelstring: Display label.
countinteger: Creators in the section's first page.
has_moreboolean: Whether the section continues past its first page.

Example

Request

$ 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

Response · Long strings and repeated array entries are trimmed for readability.

{
  "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"
}

As an MCP call

{
  "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
  }
}

Notes

Give at least one of topic_keywords, profile_keywords, similar_username, product_query, or trending=true.
A broad brief can take up to a minute.
The search_id stays valid, so you can re-sort or page later without searching again.

Machine-readable: /docs/tools/insight-instagram-account-discover.md

Overview

Parameters

Response

Example

Notes

Related tools