PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Get competitor estimate history

Read bounded, dated download and revenue estimates for one iOS app.

Download Markdown ↓

GEThttps://api.peekpanda.com/v1/competitors/{platform}/{storeId}/estimates/history

Request

This read returns stored PeekPanda observations and never calls the App Store.

Parameters

NameInTypeRequiredDescription
platformpathiosYesThe preview supports iOS only.
storeIdpathnumeric stringYesApple App Store identifier.
limitqueryinteger, 1–366NoMaximum observations; defaults to 60.

Response

app names the listing the series describes. Estimate fields are null when the available public evidence cannot support them.

Response fields

app.storeIdstring
app.namestring
app.iconUrlnull
app.genrestring
app.categorystring
app.developerNamenull
app.ratingnumber
app.totalRatingsnumber
data[].storeIdstring
data[].platformstring
data[].sourcestring
data[].observedAtstring
data[].countrystring
data[].ratingVelocityPerDaynumber
data[].monthlyInstalls.kindstring
data[].monthlyInstalls.scopestring
data[].monthlyInstalls.rangeobject
data[].previousMonthlyInstalls.kindstring
data[].previousMonthlyInstalls.scopestring
data[].previousMonthlyInstalls.ceilingnumber
data[].monthlyRevenue.kindstring
data[].monthlyRevenue.scopestring
data[].monthlyRevenue.rangeobject
data[].previousMonthlyRevenuenull
data[].currencystring

Authentication

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

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 get_app with action estimates. Path fields go in params, filters in query, and a write body in body.

{
  "name": "get_app",
  "arguments": {
    "request": {
      "action": "estimates",
      "params": {
        "platform": "<platform>",
        "storeId": "<storeId>"
      }
    }
  }
}

Source

PeekPanda estimates, refreshed nightly. Figures are worldwide and monthly: a low, mid and high range, or below_floor under 5,000 a month. A day before an app was first scored returns null.

Refresh

Refreshes run asynchronously and return dated observations when available.

AI agent or LLM? Read this page as markdown