Preview a starter board

Preview a curated niche or find potential competitors for a selected app.

Last reviewed September 21, 2026Download Markdown ↓

GEThttps://api.peekpanda.com/v1/starter-boards/{nicheKey}

Request

No query or body. Use a curated key such as `calorie-tracking`, or `app-<numericStoreId>` for an app returned by starter-board search. The app is first, followed by up to five distinct stored iOS candidates ranked from shared keyword searches, listing names, descriptions and category. Sparse evidence produces a smaller preview. Unknown keys or apps return 404 `not_found`.

Parameters

NameInTypeRequiredDescription

nicheKeypathstringYesCurated niche key, or app-<numericStoreId> to seed a preview with that stored iOS app and up to five potential competitors.

Response

The preview includes at most two paid ads per app, five keywords per app and three organic posts total, plus total and locked counts. App previews also return `seed.storeId`, ordered `seed.matches` with match reasons and nullable shared-search counts, and `seed.previewToken` for adoption. Curated previews return `seed: null`. The example below is illustrative only, not a live observation.

Response fields

keystring

labelstring

seednull

appsarray

organicPostsarray

organicPostsTotalnumber

organicPostsLockednumber

Authentication

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

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

{
  "name": "starter_boards",
  "arguments": {
    "request": {
      "action": "detail",
      "params": {
        "nicheKey": "<nicheKey>"
      }
    }
  }
}

Source

Curated PeekPanda starter-board catalogue and public competitor evidence. No private customer board content is returned.

Refresh

Reads stored listing, paid-ad, keyword and organic observations only. These requests never start provider collection. Each observed stream carries its observation date; missing evidence remains null or an empty list.

Preview bounds

The lists are deliberately bounded for onboarding. Locked counts describe additional stored public evidence when available. Null counts mean the source has not been observed; zero means no matching records are available in the stored projection, without claiming complete provider coverage.

Potential competitors

Match reasons are `shared_searches`, `similar_listing`, `similar_description` or `same_category`. Category is a weaker match, not proof of direct competition. Preserve the returned `seed.previewToken` with the chosen IDs: it binds this displayed set for 24 hours without granting subscription access. Refresh an expired preview before adoption.

Rate limits and daily budget

Authenticated API and MCP calls share the plan holder’s daily allowance: Peek 30 or Panda 1,000 calls, reset at 00:00 UTC. The standard per-minute rate limit also applies; honor Retry-After and daily-call reset headers on 429 responses.

AI agent or LLM? Read this page as markdown