PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Get a board

Read one board: pinned apps with stored evidence, saved ads, the seven-day pulse and activity.

Download Markdown ↓

GEThttps://api.peekpanda.com/v1/boards/{boardId}

Request

Render saved ad creatives with `GET /v1/paid-ads?savedToBoardId=`. `watch` is the caller's own watchlist entry for the app, or null.

Parameters

NameInTypeRequiredDescription
boardIdpathuuidYesBoard id.

Response

Zero ads means none collected yet, never that an app runs no ads. New ads count ads whose run started that UTC day.

Response fields

idstring
namestring
colorstring
scopestring
workspaceIdnull
ownerUserIdstring
appCountnumber
adCountnumber
createdAtstring
updatedAtstring
apps[].idstring
apps[].kindstring
apps[].storeIdstring
apps[].namestring
apps[].iconUrlnull
apps[].notenull
apps[].addedByUserIdstring
apps[].createdAtstring
apps[].watchnull
apps[].evidence.liveAdsnumber
apps[].evidence.newAdsThisWeeknumber
apps[].evidence.savedAdsOnBoardnumber
apps[].evidence.inCatalogueboolean
ads[].idstring
ads[].kindstring
ads[].platformstring
ads[].archiveIdstring
ads[].storeIdstring
ads[].advertiserNamestring
ads[].notestring
ads[].addedByUserIdstring
ads[].createdAtstring
pulse.appsnumber
pulse.savedAdsnumber
pulse.liveAdsnumber
pulse.newAdsThisWeeknumber
pulse.newAdsByDay[].datestring
pulse.newAdsByDay[].newAdsnumber
activity[].kindstring
activity[].datestring
activity[].storeIdstring
activity[].appNamestring
activity[].countnumber

Authentication

Requires Bearer API credential or OAuth access token. Scope context:read. MCP calls boards 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.

MCP request

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

{
  "name": "boards",
  "arguments": {
    "request": {
      "action": "get",
      "params": {
        "boardId": "<boardId>"
      }
    }
  }
}

Source

Boards are the caller's own organization, stored in PeekPanda. Pinned apps carry the listing name and icon as pinned; evidence counts are stored paid-ad observations.

Refresh

Board reads and writes never call a provider or start collection. Pinning an app does not watch it; watching stays on the ASO tracked-app list.

AI agent or LLM? Read this page as markdown