PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Refresh an ASO keyword

Queue a refresh for one keyword snapshot.

Download Markdown ↓

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

Request

Requests a newer observation when the stored keyword evidence is missing or stale.

Parameters

NameInTypeRequiredDescription
querypathstringYesKeyword to refresh.

Response

`queries` lists the searches accepted for refresh and is empty when the observation was already current.

Response fields

jobIdstring
queries[]string[]
refresh.statestring
refresh.lastRefreshedAtstring
refresh.nextAllowedAtstring
refresh.staleQueryCountnumber
refresh.activeJobIdnull
refresh.budgetobject

Authentication

Requires Bearer API credential or OAuth access token. Scope content:write. MCP calls refresh with action aso_keyword.

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.
409conflict when the write would duplicate an exclusive row.

MCP request

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

{
  "name": "refresh",
  "arguments": {
    "request": {
      "action": "aso_keyword",
      "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

Stored observations are reused while current. Explicit refresh commands run asynchronously and report freshness, progress and any applicable limits.

AI agent or LLM? Read this page as markdown