PeekPanda docs

Get Apple chart history

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

GET/v1/charts/apps/{storeId}/history

Auth Bearer API credential or OAuth access tokenScope context:readMCP get_apple_chart_history

Request

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

curl --get 'https://api.peekpanda.com/v1/charts/apps/0000000000/history' \
  --header "Authorization: Bearer $PEEKPANDA_TOKEN" \
  --header 'x-genviral-tenancy: personal' \
  --data-urlencode 'country=us' \
  --data-urlencode 'categoryId=all' \
  --data-urlencode 'chartType=free' \
  --data-urlencode 'limit=30'

Response

Matches appleChartHistorySchema: { storeId, query, history:[{day, rank}], app:{...}|null, countries:[{country, day, rank, depth}] }. The example uses store ID 0000000000.

{
  "storeId": "0000000000",
  "query": {
    "country": "us",
    "categoryId": "all",
    "chartType": "free",
    "limit": 30
  },
  "history": [
    {
      "day": "2026-09-05",
      "rank": 2
    },
    {
      "day": "2026-09-06",
      "rank": 1
    }
  ],
  "app": {
    "storeId": "0000000000",
    "name": "Example Calorie Tracker",
    "iconUrl": "https://example.com/icon.png",
    "developer": "Example Labs",
    "categoryName": "Health & Fitness"
  },
  "countries": [
    {
      "country": "us",
      "day": "2026-09-06",
      "rank": 1,
      "depth": 100
    }
  ]
}

Parameters

NameInTypeRequiredDescription

storeIdpathnumeric stringYesApple App Store identifier.

countryquery^[a-z]{2}$NoApple storefront. Defaults to us. Coverage is us, gb, fr, de, br, be.

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.

Known 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.

404not_found when the record is outside the accessible catalogue.

429rate_limited; honor Retry-After when present.

Source

The same stored Apple ranking RSS / modern RSS snapshots as GET /v1/charts. Grossing remains a position. Chart GET never calls Apple.

Refresh

History is assembled from published daily snapshots. peekpanda-apple-charts-refresh only fills unfinished UTC-day lists; it does not rewrite completed history.