PeekPanda markpeekpandaDocumentationFor AI ↗Open app

PeekPanda docs

Get similar competitors

Read similar stored iOS listings for one competitor, with the list page envelope.

Download Markdown ↓
GET/v1/competitors/{platform}/{storeId}/similar
Auth Bearer API credential or OAuth access tokenScope context:readMCP get_similar_competitors

Request

Send an optional opaque cursor and limit. Defaults match the competitor list page.

curl --get 'https://api.peekpanda.com/v1/competitors/ios/0000000000/similar' \
  --header "Authorization: Bearer $PEEKPANDA_TOKEN" \
  --header 'x-genviral-tenancy: personal' \
  --data-urlencode 'limit=24'

Response

The same paginated listing envelope as GET /v1/competitors.

{
  "data": [
    {
      "platform": "ios",
      "storeId": "0000000000",
      "appName": "Example Calorie Tracker",
      "category": "Health & Fitness",
      "developerId": "example-developer",
      "price": 0,
      "adSupported": null,
      "inAppPurchases": true,
      "totalRatings": 12450,
      "rating": 4.7,
      "installs": {
        "kind": "ratings_proxy",
        "value": 622500
      },
      "releaseDate": "2024-05-01",
      "storeUpdatedAt": "2026-09-06",
      "sourceUpdatedAt": "2026-09-06",
      "descriptionUpdatedAt": null,
      "description": null,
      "shortDescription": null,
      "source": "itunes",
      "snapshotDate": "2026-03-01"
    }
  ],
  "pagination": {
    "nextCursor": null,
    "hasMore": false
  }
}

Parameters

NameInTypeRequiredDescription
platformpathiosYesThe preview supports iOS only.
storeIdpathnumeric stringYesApple App Store identifier.
cursorqueryopaque stringNoCursor returned by the previous page.
limitqueryinteger, 1–100NoPage size; defaults to 24.

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

March dump listings may still say source appgoblin; current Apple lookups use itunes. Installs kind ratings_proxy is lifetime ratings × 50, not store-reported downloads.

Refresh

list/get may enqueue a US iTunes lookup when today's tape row is missing. The GET itself never waits on Apple.