PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Get organic post analysis

Read where one post’s creative analysis stands, and the analysis once it is ready.

Download Markdown ↓

GEThttps://api.peekpanda.com/v1/organic/{postId}/analysis

Request

This read never starts an analysis. status is not_requested when nobody has asked, pending while the worker runs it, ready with the persisted analysis and its generation-time provenance, or failed with failedAt when the last run produced nothing; ask again with POST to retry. Treat creative observations as analysis, not a performance claim.

Parameters

NameInTypeRequiredDescription
postIdpathstring, 1–300YesOrganic corpus post id.

Response

Returns the analysis state. A slideshow analysis has no timeline.

Response fields

statusstring
analysis.summarystring
analysis.visibleText[]string[]
analysis.hookNotes[]string[]
analysis.editingPatternstring
analysis.reusablePromptIngredients[]string[]
analysis.modelstring
analysis.generatedAtstring

Authentication

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

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

{
  "name": "search_organic",
  "arguments": {
    "request": {
      "action": "analysis",
      "params": {
        "postId": "<postId>"
      }
    }
  }
}

Source

The post's stored copy in the organic corpus: its mirrored video, or its stored slides, with its caption, hook and creator handle as context.

Refresh

This read returns the stored state and does not begin analysis.

AI agent or LLM? Read this page as markdown