PeekPanda markpeekpandaDocumentationFor AI ↗Open app

PeekPanda docs

Add a temporary ASO app

Add an app idea before it has an App Store listing.

Download Markdown ↓
POST/v1/aso/apps/temporary
Auth Bearer API credential or OAuth access tokenScope content:writeMCP add_temporary_aso_app

Request

Creates a temporary app without an App Store ID. Reuse the same Idempotency-Key when retrying this exact request.

curl --request POST 'https://api.peekpanda.com/v1/aso/apps/temporary' \
  --header "Authorization: Bearer $PEEKPANDA_TOKEN" \
  --header 'x-genviral-tenancy: personal' \ \
  --header 'Idempotency-Key: temporary-app-example-1'
  --header 'content-type: application/json' \
  --data '{"name":"New concept","folderId":"44444444-4444-4444-8444-444444444444"}'

Response

The temporary tracked-app object.

{
  "storeId": null,
  "name": "New concept",
  "iconUrl": null,
  "developerName": null,
  "primaryGenre": null,
  "rating": null,
  "ratingCount": null,
  "inCatalogue": false,
  "id": "11111111-1111-4111-8111-111111111111",
  "kind": "temporary",
  "folderId": "44444444-4444-4444-8444-444444444444",
  "role": "mine",
  "createdAt": "2026-09-06T00:00:00.000Z",
  "lastRefreshedAt": "2026-09-06T00:00:00.000Z",
  "keywordCount": 1
}

Parameters

NameInTypeRequiredDescription
namebodystringYesTemporary app name.
folderIdbodyuuid | nullYesOptional folder.

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

Dated public App Store search results and suggestion observations for the US English storefront. Positions are observed result order. Difficulty and demand are directional indicators, not search volume or advertising data.

Refresh

This read returns stored observations. Use the related refresh command when newer evidence is needed.