PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Compare competitors

Read up to 10 iOS apps side by side: identity, rating and current monthly download and revenue estimates in one call.

Download Markdown ↓

GEThttps://api.peekpanda.com/v1/competitors/compare

Request

Send every store ID in one storeIds value. Duplicates are removed before the 2–10 bound applies.

Parameters

NameInTypeRequiredDescription
storeIdsquerycomma-separated numeric strings, 2–10 distinctNoApple App Store identifiers. Put the app in question first; the response keeps this order.

Response

subjectStoreId is the first requested app, the one in question, even when PeekPanda does not hold it. data keeps the request order. Each estimate is the current worldwide monthly range (or below_floor under 5,000 a month) with the night it was scored, and previous is the estimate that held a month earlier. An estimate is null when no nightly score covers the app: unknown, not zero. Store IDs PeekPanda does not hold are listed in missingStoreIds.

Response fields

subjectStoreIdstring
data[].app.storeIdstring
data[].app.namestring
data[].app.iconUrlnull
data[].app.genrestring
data[].app.categorystring
data[].app.developerNamestring
data[].app.ratingnumber
data[].app.totalRatingsnumber
data[].monthlyInstalls.kindstring
data[].monthlyInstalls.scopestring
data[].monthlyInstalls.rangeobject
data[].monthlyInstalls.observedAtstring
data[].monthlyInstalls.previousobject
data[].monthlyRevenue.kindstring
data[].monthlyRevenue.scopestring
data[].monthlyRevenue.ceilingnumber
data[].monthlyRevenue.observedAtstring
data[].monthlyRevenue.previousnull
data[].currencystring
missingStoreIds[]string[]

Authentication

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

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 search_apps with action compare. Path fields go in params, filters in query, and a write body in body.

{
  "name": "search_apps",
  "arguments": {
    "request": {
      "action": "compare"
    }
  }
}

Source

PeekPanda estimates, refreshed nightly, beside dated public App Store listing observations. Figures are worldwide and monthly ranges, never store-reported numbers.

Refresh

This read returns stored estimates and does not start collection.

AI agent or LLM? Read this page as markdown