PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Add a board item

Put an App Store app on a board, which tracks it, or save one paid ad.

Download Markdown ↓

POSThttps://api.peekpanda.com/v1/boards/{boardId}/items

Request

Repeating the same app or ad returns the existing item. An app on a board is tracked in the tenancy and counts once toward the plan holder allowance; over it the API answers 409 `tracked_app_limit` with `limit` and `plan`. At most 500 items per board.

Parameters

NameInTypeRequiredDescription
boardIdpathuuidYesBoard id.
kindbody'app' | 'ad'YesWhat to add.
storeIdbodystringYesFor an app: numeric App Store id of a catalogue app.
platformbody'meta' | 'tiktok'YesFor an ad: advertising platform.
archiveIdbodystringYesFor an ad: archive id.
notebodystring | nullYesOptional note, up to 500 characters.

Response

The board item. An app item carries its tracked app id and stored evidence.

Response fields

idstring
kindstring
storeIdstring
namestring
iconUrlnull
notenull
addedByUserIdstring
createdAtstring
trackedAppIdstring
stopsTrackingOnRemoveboolean
evidence.liveAdsnumber
evidence.newAdsThisWeeknumber
evidence.savedAdsOnBoardnumber
evidence.inCatalogueboolean
evidence.adsLastCollectedAtstring
evidence.adsFreshnessstring

Authentication

Requires Bearer API credential or OAuth access token. Scope content:write. MCP calls manage_boards with action add_item.

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.
409conflict when the write would duplicate an exclusive row.

MCP request

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

{
  "name": "manage_boards",
  "arguments": {
    "request": {
      "action": "add_item",
      "params": {
        "boardId": "<boardId>"
      }
    }
  }
}

Source

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

Refresh

Board reads never call a provider or start collection. An app on any board in a space is tracked there, and tracking collects its paid ads, organic posts, keywords and chart position.

AI agent or LLM? Read this page as markdown