PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Get competitor paid-ad refresh status

Read an app's latest paid-ad refresh and your remaining daily refreshes.

Download Markdown ↓

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

Request

No request body. This read never starts a refresh; poll it while latest.state is running.

Parameters

NameInTypeRequiredDescription
platformpathiosYesPaid-ad refresh supports iOS apps.
storeIdpathnumeric stringYesApple App Store identifier.

Response

latest is null until the app has been refreshed. latest.state is running, completed, not_matched or failed. newAdCount is null until the walk has started. quota is daily with limit, used, remaining and resetAt, or unlimited.

Response fields

appStoreIdstring
latest.statestring
latest.requestedAtstring
latest.settledAtnull
latest.newAdCountnull
quota.kindstring
quota.limitnumber
quota.usednumber
quota.remainingnumber
quota.resetAtstring

Authentication

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

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

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

Source

Public ads from the app's own advertiser page, matched by its exact app name. Ads are attributed only when the advertiser matches; no looser name matching is used.

Refresh

A refresh walks the advertiser from its newest ad. This endpoint has its own quiet daily limit, separate from your plan's tracked-app number: 1 on Peek and 3 on Panda, in a rolling 24 hours, shared by a workspace. A refresh always walks the advertiser again; while an app's walk is still running, a refresh by anyone joins that walk and is not counted. A failed refresh is not counted at all.

AI agent or LLM? Read this page as markdown