PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Get competitor media

Read stored organic matches and paid-ad observations for one listing.

Download Markdown ↓

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

Request

Identify the listing. This GET does not invent paid-ad rows when none are stored.

Parameters

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

Response

organic uses the organic-match page. paidAds stays empty when no ads are stored, and paidAdDestinations reports where the stored ads sent their clicks. paidAds returns a current cursor page with items, nextCursor and hasMore, without collection totals: the listing's live ads, most recently discovered first. Continue it with GET /v1/paid-ads?storeIds={storeId}&status=active&sort=recently_discovered&cursor={nextCursor}; a cursor only continues the query and sort that produced it. Both read the app's stored paid projection, about a minute behind new ads; landing pages not built yet read as an empty list.

Response fields

organic.data[].sourceIdstring
organic.data[].productNamestring
organic.data[].captionstring
organic.data[].linkstring
organic.data[].matchobject
organic.candidateLimitReachedboolean
paidAds.itemsarray
paidAds.nextCursornull
paidAds.hasMoreboolean
paidAdDestinations.appStorenumber
paidAdDestinations.playStorenumber
paidAdDestinations.webnumber
paidAdDestinations.unknownnumber
paidAdDestinations.landingPagesarray

Authentication

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

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

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

Source

The public organic corpus, tied to apps by App Store link, website or name; suggestions, not verified ownership.

Refresh

This read returns stored observations and does not start collection.

AI agent or LLM? Read this page as markdown