PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Explore an ASO keyword

Read the stored explore view for one keyword.

Download Markdown ↓

GEThttps://api.peekpanda.com/v1/aso/keywords/{query}

Request

Reads the stored keyword observation and its freshness state.

Parameters

NameInTypeRequiredDescription
querypathstringYesKeyword to explore.

Response

The response includes observed apps, directional difficulty and demand indicators, related suggestions and refresh state. `demand` is Apple's weekly search popularity for the phrase (1 to 100, with Apple's 1 to 5 tier). Where Apple reports nothing for a US phrase, `popularityEstimate` carries PeekPanda's own estimate: a tier (`very_low`, `low`, `medium` or `high`), never a number on Apple's scale, with `estimatedAt` and the `modelTrainedAt` of the weekly model behind it. The two never appear together: when `demand` is set, `popularityEstimate` is null. Neither is a search count.

Response fields

querystring
countrystring
observedAtstring
isStaleboolean
apps[].storeIdstring
apps[].positionnumber
apps[].namestring
apps[].isSubjectboolean
apps[].inCatalogueboolean
difficulty.scorenumber
demand.scorenumber
demand.tiernumber
demand.countrystring
demand.periodStartstring
demand.periodEndstring
demand.observedAtstring
popularityEstimatenull
relatedHints[]string[]
refresh.statestring
refresh.lastRefreshedAtstring
refresh.nextAllowedAtstring
refresh.staleQueryCountnumber
refresh.activeJobIdnull
refresh.budgetobject

Authentication

Requires Bearer API credential or OAuth access token. Scope context:read. MCP calls aso with action explore.

Errors

400invalid_request for an invalid filter, identity or limit.
401authentication_required for a missing or invalid credential.
402subscription_required when access is not entitled.
403authorization_required for a missing scope or unavailable preview access.
403workspace_not_accessible when x-genviral-tenancy names a workspace the credential cannot reach.
404not_found when the record is outside the accessible catalogue.
429rate_limited; honor Retry-After when present.
429daily_call_limit; the plan's daily API and MCP calls are used until 00:00 UTC.

MCP request

Call aso with action explore. Path fields go in params, filters in query, and a write body in body.

{
  "name": "aso",
  "arguments": {
    "request": {
      "action": "explore",
      "params": {
        "query": "<query>"
      }
    }
  }
}

Source

Dated public App Store search results and suggestion observations for the US English storefront. Positions are observed result order. Difficulty and demand are directional indicators, not search volume or advertising data.

Refresh

This read returns stored observations. Use the related refresh command when newer evidence is needed.

AI agent or LLM? Read this page as markdown