Skip to content

Keywords · MCP TOOL

list_trending_keywords

List the day's popular, trending, new or opportunity App Store and Google Play searches in one country.

Set up your assistant · Authentication and errors

When to use it

Find search terms gaining demand right now, or the head searches of a storefront, before choosing keywords. Popularity is ordinal (0–100), not a search count; trend compares today with the last 7 complete days. Pass day for any earlier day.

Parameters

NameTypeRequiredDefaultAllowed valuesDescription
sourcestringNo"apple_mobile"apple_mobile, google_mobile, ios, androidStore: apple_mobile/ios or google_mobile/android.
countrystringNo"us"—Two-letter storefront country code. Pattern: ^[a-z]{2}$.
liststringNo"popular"popular, trending, new, opportunitiesResource identifier validated by the tool.
daystringNo——Resource identifier validated by the tool. Pattern: ^\d{4}-\d{2}-\d{2}$.
qstringNo——Words in an extension’s name or publisher. Maximum length: 80.
categorystringNo——Store category ID; all means the overall chart where supported. Maximum length: 60.
hideBrandsbooleanNofalse—Resource identifier validated by the tool.
limitintegerNo50—Maximum number of results requested. Minimum: 1. Maximum: 200.
cursorintegerNo0—Zero-based offset; use the returned nextCursor to continue. Minimum: 0. Maximum: 5000.

Defaults and constraints come from the published Zod input schema. “—” means no schema default or no enum restriction. Use JSON values of the listed type; additional handler rules are described above.

Example prompts

  • Which App Store searches are trending in Germany today?
  • What new Google Play searches appeared in Brazil this week, without brand names?

Example call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_trending_keywords",
    "arguments": {
      "source": "apple_mobile",
      "country": "de",
      "list": "trending",
      "hideBrands": true,
      "limit": 20
    }
  }
}

Example result

Illustrative, abridged JSON-RPC result. Only selected fields are shown; empty arrays illustrate a response with no rows. These are not current catalog observations. Parse the JSON inside content[].text.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"data\":{\"platform\":\"ios\",\"country\":\"de\",\"day\":\"2026-11-15\",\"latestDay\":\"2026-11-15\",\"status\":\"complete\",\"list\":\"trending\",\"total\":84,\"rows\":[{\"position\":1,\"term\":\"ki foto\",\"rank\":140,\"popularity\":86,\"band\":\"high\",\"competition\":34,\"variants\":[\"ki fotos\"],\"topApps\":[{\"id\":\"ios:1470373330\",\"name\":\"Remini - AI Photo Enhancer\",\"iconUrl\":null}],\"trend\":64,\"flags\":[\"rising\"],\"streak\":3,\"countries\":6,\"label\":{\"brand\":false,\"brandOwner\":null,\"category\":\"Photo & Video\",\"intent\":\"feature\",\"gloss\":\"AI photo\"}}]},\"nextCursor\":\"20\"}"
      }
    ]
  }
}

Free vs paid results

Free sees the first 20 rows of the latest day's lists with every figure. Rows past 20, and every row of a past day, keep their figures but lose the term and its labels. Basic and Pro unlock every row and every past day.

Paid access does not fill coverage gaps or unknown values. Returned plan metadata and lock notes explain redaction where applicable. Read the full Free data policy.

Rate limits and usage credit

PlanCalls per tool / dayAll tools / week
Free10100
Basic2001,400
Pro6005,000

Days reset at 00:00 UTC. The combined ISO week resets Monday at 00:00 UTC. Every served tool call counts, including cached reads. Failed or refused calls are released along with any charge. Compare plans.

After either allowance, Basic and Pro can opt in to pay $0.02 in usage credit per call to list_trending_keywords. A call exceeding both windows is charged once. Free is refused past its allowances; paid plans without opt-in or enough credit are also refused with HTTP 402 / JSON-RPC -32004.

Credential request throttles and, for live keyword work, store-work throttles also apply. Follow retry instructions in the error reference.