PeekPanda docs

Save paid ad

Save one stored paid-ad observation to the authenticated caller account bookmarks.

POST/v1/paid-ads/{platform}/{archiveId}/saved

Auth Bearer API credential or OAuth access tokenScope content:writeMCP save_paid_ad

Request

The command has no request body. Repeating it is naturally idempotent.

curl --request POST 'https://api.peekpanda.com/v1/paid-ads/meta/111222333/saved' \
  --header "Authorization: Bearer $PEEKPANDA_TOKEN" \
  --header 'x-genviral-tenancy: personal'

Response

Confirms the actor-owned paid-ad bookmark was saved.

{
  "message": "Saved paid ad"
}

Parameters

NameInTypeRequiredDescription

platformpathmeta | tiktokYesAdvertising platform.

archiveIdpathstring, 1–255YesProvider archive id.

Known 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.

404not_found when the record is outside the accessible catalogue.

429rate_limited; honor Retry-After when present.

409conflict when the write would duplicate an exclusive row.

Source

Account bookmarks on stored Meta/TikTok ad-library observations. Not Apple.

Refresh

Save and remove update account bookmark state only. Paid-ad ingestion is a separate operator path.