PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Get paid ad

Read one stored paid-ad observation with its matched listing and the ads around it.

Download Markdown ↓

GEThttps://api.peekpanda.com/v1/paid-ads/{platform}/{archiveId}

Request

Identify the ad with the platform and archive id carried in its canonicalKey. This read returns stored observations and never collects new ads.

Parameters

NameInTypeRequiredDescription
platformpathmeta | tiktokYesAdvertising platform.
archiveIdpathstring, 1–255YesProvider archive id.

Response

item is the stored observation. product is the matched iOS listing, or null when the ad carries no verified store link. sameAppAds holds up to six further stored ads of the app the ad belongs to, latest start first with undated ads last, and otherAppAds up to six of the newest ads of other apps. transcript and analysis are null until they have been collected. The route answers 404 when no stored ad matches the identity.

Response fields

item.idstring
item.canonicalKeystring
item.sourcestring
item.platformstring
item.archiveIdstring
item.advertiserobject
item.statusstring
item.startedAtstring
item.endedAtnull
item.discoveredAtstring
item.sourceUrlstring
item.creativeobject
item.productLinkobject
item.destinationobject
item.productIconUrlnull
item.performanceobject
item.savedboolean
productnull
sameAppAdsarray
otherAppAdsarray
transcriptnull
analysisnull

Authentication

Requires Bearer API credential or OAuth access token. Scope context:read. MCP calls get_ads 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.
429daily_call_limit; the plan's daily API and MCP calls are used until 00:00 UTC.

MCP request

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

{
  "name": "get_ads",
  "arguments": {
    "request": {
      "action": "get",
      "params": {
        "platform": "<platform>",
        "archiveId": "<archiveId>"
      }
    }
  }
}

Source

Stored public advertising-library observations with source dates. Spend is unavailable unless the public record reports it.

Refresh

This read returns stored observations. Saving an ad changes boards only.

AI agent or LLM? Read this page as markdown