PeekPanda markpeekpandaDocumentationFor AI ↗Open app

PeekPanda docs

Refresh competitor estimates

Request one bounded estimate refresh for an accessible iOS app.

Download Markdown ↓
POST/v1/competitors/{platform}/{storeId}/estimates/refresh
Auth Bearer API credential or OAuth access tokenScope content:writeMCP refresh_competitor_estimates

Request

The command has no request body. Fresh and in-progress work is coalesced.

curl --request POST 'https://api.peekpanda.com/v1/competitors/ios/0000000000/estimates/refresh' \
  --header "Authorization: Bearer $PEEKPANDA_TOKEN" \
  --header 'x-genviral-tenancy: personal'

Response

updated includes data; pending includes retryAt and an empty data array.

{
  "state": "pending",
  "data": [],
  "retryAt": "2026-09-06T00:15:00.000Z"
}

Parameters

NameInTypeRequiredDescription
platformpathiosYesThe preview supports iOS only.
storeIdpathnumeric stringYesApple App Store identifier.

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

Source

store_rating_observation tape (iTunes userRatingCount) + Apple grossing rank. monthlyInstalls needs two tape days. revenue unknown without a grossing rank (then null).

Refresh

Trigger peekpanda-rating-tape-refresh cron */15 posts Nest; Nest collects at most one US tape point per app per UTC day.