PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Get competitor organic content

Read one listing's organic posts and where PeekPanda's search for more stands.

Download Markdown ↓

GEThttps://api.peekpanda.com/v1/competitors/{platform}/{storeId}/organic

Request

Identify the listing. This GET does not take query filters.

Parameters

NameInTypeRequiredDescription
platformpathiosYesThe preview supports iOS only.
storeIdpathnumeric stringYesApple App Store identifier.

Response

data holds the matched posts, newest first, as suggestions rather than verified ownership. search.state is idle when PeekPanda has no search for this app and none is on the way: nobody tracks it or requested its organic posts, or PeekPanda cannot read its App Store listing yet, queued when it is tracked or requested and PeekPanda will set up its searches, stopped when PeekPanda set up a search for the app but none of its searches ever ran and none can (they are paused or retired, or there was nothing to search for), so a request changes nothing, searching while an active search has not run yet or found posts still wait for review (searches and searchesRun count the active searches, waitingForReview the posts), and searched once no active search waits for its first run and nothing waits for review (searches counts the searches that ran, activeSearches those still checking). When the search status could not be read, search is kind unavailable and data still holds the posts. An empty data list is never proof the app has no organic content.

Response fields

data[].sourceIdstring
data[].productNamestring
data[].captionstring
data[].linkstring
data[].match.statusstring
data[].match.evidencestring
data[].match.scorenumber
candidateLimitReachedboolean
search.statestring
search.startedAtstring
search.searchesnumber
search.searchesRunnumber
search.waitingForReviewnumber

Authentication

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

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

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

Source

The public organic corpus, tied to apps by App Store link, website or name; suggestions, not verified ownership.

Refresh

This read starts no collection. PeekPanda searches for the organic posts of apps someone tracks or requested organic posts for; search says where that stands.

AI agent or LLM? Read this page as markdown