Skip to main content
Intent clusters are an optional layer on top of the ASO Decision Brief: opportunity keywords are grouped by meaning so you can prioritize themes (“relaxation / sleep” vs “brain games”) instead of a flat list.

​
When to use it

  • You have many keyword opportunities and want fewer, strategy-sized buckets.
  • You need a single “start here” group (prioritizeClusterId in the API response).
  • You are aligning copy, screenshots, and keyword field around consistent user intents.

​
How it works (short)

  1. The brief loads keyword opportunities for the app.
  2. With intentClusters=1, those keywords are analyzed and split into a small number of intent groups.
  3. Each group gets a label (typically the strongest opportunity keyword in that group) and avgOpportunityScore.
  4. The brief adds an intentClusters object and usually a prioritized action like “Prioritize this intent group: …”.

​
API

Use the same endpoint as the brief: 
GET /v1/aso/brief/:appId?intentClusters=1&country=us
  • intentClusters=1 or true — enable clustering (+2 credits on top of the brief base cost × country multiplier).
  • countries=us,gb,de — multi-country brief; clustering runs per country (each storefront can have different opportunity mixes).
See full parameters and response fields in ASO Decision Brief.

​
MCP

Tool: aso_brief
ArgumentDescription
intent_clusterstrue to enable semantic intent clustering (maps to intentClusters query)
countriesOptional comma-separated ISO codes for multi-country briefs
Auth: same as MCP Server (Authorization: Bearer <api-key>).

​
See also