PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Chart one app's paid ads

Chart one competitor app's paid ads: launches, run lengths and creative mixes, for all of its advertisers or one.

Download Markdown ↓

GEThttps://api.peekpanda.com/v1/competitors/{platform}/{storeId}/paid-ads/intelligence

Request

Identify the listing. Every chart covers all of its advertisers unless you name one.

Parameters

NameInTypeRequiredDescription
platformpathiosYesThe preview supports iOS only.
storeIdpathnumeric stringYesApple App Store identifier.
advertiserExternalIdquerystringNoNarrow the charts to one of the advertisers the response lists. Omit it for all of them.

Response

advertisers lists every advertiser of the app, whichever one the charts narrow to. Days are whole UTC days, the same windows the case file reads. weeks holds 26 Monday weeks, oldest first; liveAds is the part of newAds still live now. longestRunning uses the Search paid ads item shape with short-lived media URLs. medianRunDays and longestRunDays are null when no ad is live.

Response fields

generatedAtstring
storeIdstring
advertiserExternalIdnull
advertisersarray
totals.adsnumber
totals.liveAdsnumber
totals.advertisersnumber
totals.newAdsLast7Daysnumber
totals.newAdsLast30Daysnumber
totals.medianRunDaysnumber
totals.longestRunDaysnumber
weeks[].weekStartstring
weeks[].newAdsnumber
weeks[].liveAdsnumber
longevity[].bandstring
longevity[].countnumber
longestRunningarray
formats[].keystring
formats[].labelstring
formats[].countnumber
ctas[].keystring
ctas[].labelstring
ctas[].countnumber
destinations[].keystring
destinations[].labelstring
destinations[].countnumber

Authentication

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

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.

MCP request

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

{
  "name": "get_ads",
  "arguments": {
    "request": {
      "action": "app_intelligence",
      "params": {
        "platform": "<platform>",
        "storeId": "<storeId>"
      }
    }
  }
}

Source

Stored paid-ad observations. An ad belongs to the app its own verified App Store link names. There is no spend, impression, reach or country field: Meta does not publish them.

Refresh

These reads do not collect new ads.

AI agent or LLM? Read this page as markdown