PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Get competitor

Read one stored iOS competitor-catalogue listing.

Download Markdown ↓

GEThttps://api.peekpanda.com/v1/competitors/{platform}/{storeId}

Request

Identify the listing with platform ios and a numeric Apple store ID.

Parameters

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

Response

Returns one listing object. Show currentFacts: each value names its provenance, observed from an App Store storefront or the catalogue snapshot, and its own asOf date. The top-level appName, rating, totalRatings and price keep the dated snapshot values. When collected, storeInAppPurchases contains dated Apple purchase names and prices for the US store. A missing field means not checked. An empty items array means the checked public page showed no purchases. Apple shows at most 10 items; this is not a full product catalogue or proof of subscription billing.

Response fields

platformstring
storeIdstring
appNamestring
categorystring
developerIdstring
pricenumber
adSupportednull
inAppPurchasesboolean
totalRatingsnumber
ratingnumber
installs.kindstring
installs.valuenumber
releaseDatestring
storeUpdatedAtstring
sourceUpdatedAtstring
descriptionUpdatedAtnull
descriptionnull
shortDescriptionnull
sourcestring
snapshotDatestring
currentFacts.appNameobject
currentFacts.ratingobject
currentFacts.totalRatingsobject
currentFacts.priceobject
storeInAppPurchases.appleIdstring
storeInAppPurchases.countrystring
storeInAppPurchases.fetchedAtstring
storeInAppPurchases.totalnumber
storeInAppPurchases.sourcestring
storeInAppPurchases.items[].namestring
storeInAppPurchases.items[].pricestring
storeInAppPurchases.items[].amountnumber
storeInAppPurchases.items[].currencystring
storeInAppPurchases.items[].kindstring

Authentication

Requires Bearer API credential or OAuth access token. Scope context:read. MCP calls get_app with action get.

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.
403workspace_not_accessible when x-genviral-tenancy names a workspace the credential cannot reach.
404not_found when the record is outside the accessible catalogue.
429rate_limited; honor Retry-After when present.
429daily_call_limit; the plan's daily API and MCP calls are used until 00:00 UTC.

MCP request

Call get_app with action get. Path fields go in params, filters in query, and a write body in body.

{
  "name": "get_app",
  "arguments": {
    "request": {
      "action": "get",
      "params": {
        "platform": "<platform>",
        "storeId": "<storeId>"
      }
    }
  }
}

Source

Dated public App Store listing observations. Installs, when present, are directional estimates rather than store-reported downloads.

Refresh

Reads return stored observations. When newer listing data is requested, collection continues asynchronously.

AI agent or LLM? Read this page as markdown