PeekPanda markpeekpandaDocumentationFor AI ↗Open app

PeekPanda docs

Refresh competitor ASO collection

Refresh ASO coverage for an accessible iOS competitor when collection is available.

Download Markdown ↓
POST/v1/competitors/{platform}/{storeId}/aso/collection
Auth Bearer API credential or OAuth access tokenScope content:writeMCP refresh_competitor_aso_collection

Request

The command has no request body; active work is coalesced and completed work respects its refresh cooldown.

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

Response

The resulting collection lifecycle status.

{
  "storeId": "0000000000",
  "country": "us",
  "language": "en_us",
  "status": "completed",
  "updatedAt": "2026-09-06T00:00:00.000Z",
  "retryAt": null
}

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

Canonical iOS ASO collection owner.

Refresh

Collection runs asynchronously and reports lifecycle, cooldown, and retry timing.