PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Get Apple chart history

Read dated rank points for one numeric store ID on a stored Apple chart series.

Download Markdown ↓

GEThttps://api.peekpanda.com/v1/charts/apps/{storeId}/history

Request

Path storeId is numeric. Query accepts country, categoryId, chartType and limit. There is no view parameter. This GET never calls Apple.

Parameters

NameInTypeRequiredDescription
storeIdpathnumeric stringYesApple App Store identifier.
countryquery^[a-z]{2}$NoApple storefront. Defaults to us. Coverage is us, gb, fr, de, br, be, jp, kr, cn, ru.
categoryIdqueryall or digitsNoOverall (all) or an Apple category id. Defaults to all.
chartTypequeryfree | paid | grossingNoApple chart type. Defaults to free. Grossing is a position, not dollars.
limitqueryinteger, 1–100NoHistory length. Defaults to 30. There is no view filter.

Response

The response includes the store ID, chart query, dated rank history, optional app context and observed storefront positions. The example uses store ID 0000000000.

Response fields

storeIdstring
query.countrystring
query.categoryIdstring
query.chartTypestring
query.limitnumber
history[].daystring
history[].ranknumber
app.storeIdstring
app.namestring
app.iconUrlstring
app.developerstring
app.categoryNamestring
countries[].countrystring
countries[].daystring
countries[].ranknumber
countries[].depthnumber

Authentication

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

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

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

Source

The same dated public App Store chart observations as GET /v1/charts. Grossing remains a position.

Refresh

History is assembled from stored daily snapshots. New collection does not rewrite completed history.

AI agent or LLM? Read this page as markdown