# PeekPanda documentation

> PeekPanda is an iOS competitor catalogue and stored creative intelligence service. Its public API and MCP server are live.

## Get started

- [Plans and tracked apps](https://peekpanda.com/docs/plans-and-refreshes.md): Peek and Panda plans, how many apps each one tracks, and the API and MCP call allowance.
- [How to read the evidence](https://peekpanda.com/docs/reading-the-evidence.md): Read observation dates, estimates, unavailable values, and suggested matches with appropriate care.
- [Start peeking in 4 steps](https://peekpanda.com/docs/start-peeking.md): Find an app, open its case file, read the evidence, and put it on a board so changes come to you.
- [What is PeekPanda](https://peekpanda.com/docs/what-is-peekpanda.md): PeekPanda is an iOS competitor catalogue where every app has a case file of dated, stored evidence.

## The case file

- [Open a case file](https://peekpanda.com/docs/open-a-case-file.md): Every panel on an app's page, what it holds, and how to move between them.
- [Rank history and App Store charts](https://peekpanda.com/docs/rank-history-and-charts.md): Browse stored App Store charts and see one app’s observed chart position over time.
- [Revenue and download estimates](https://peekpanda.com/docs/revenue-and-download-estimates.md): How to read the case-file download and revenue estimates without mistaking them for measured results.
- [Finding similar apps](https://peekpanda.com/docs/similar-apps.md): Three ways to reach the apps that sit next to the one you are reading, and what each neighbourhood actually means.

## Find apps

- [Catalogue and search](https://peekpanda.com/docs/catalogue-and-search.md): Find iOS apps in the PeekPanda catalogue and understand the results you are viewing.
- [Categories](https://peekpanda.com/docs/categories.md): Browse the catalogue by App Store category and see how many listings sit on each shelf.
- [Emerging apps](https://peekpanda.com/docs/emerging-apps.md): Find recently launched iOS apps with early public signals and understand what the emerging-app board means.
- [Leaderboards](https://peekpanda.com/docs/leaderboards.md): Browse stored App Store charts by storefront, category, and chart type, then interpret rank changes responsibly.
- [Request an app](https://peekpanda.com/docs/request-an-app.md): Add an App Store listing the catalogue does not hold yet, and ask for evidence that has not been collected for one it does.

## Creative

- [Boards](https://peekpanda.com/docs/boards.md): Put apps on boards to track them, save single ads, then look at Paid Ads, Organic Content and ASO through one board.
- [Organic content library](https://peekpanda.com/docs/organic-content-library.md): Search stored public organic posts, inspect their dated engagement evidence, and save useful creative references.
- [Paid ads library](https://peekpanda.com/docs/paid-ads-library.md): Search dated public paid-ad observations, inspect creative evidence, and understand what the library does not measure.
- [Reading a creative card](https://peekpanda.com/docs/reading-a-creative-card.md): What every part of a creative card means, in both the paid ads library and the organic content library.
- [Saving creatives](https://peekpanda.com/docs/saving-creatives.md): Save posts to your account and ads to your boards, and use the Saved views to get back to them.

## ASO

- [ASO workstation](https://peekpanda.com/docs/aso-workstation.md): The ASO board holds the iOS apps you track and opens one case file per app, showing every collected search it appears in.
- [Keyword explorer](https://peekpanda.com/docs/keyword-explorer.md): Explore an App Store phrase, its public search evidence, and PeekPanda’s directional keyword signals.
- [Keyword gap](https://peekpanda.com/docs/keyword-gap.md): Compare the searches your app ranks for against a rival's, split into theirs only, both, and yours only.
- [Refreshing keywords](https://peekpanda.com/docs/refreshing-keywords.md): What a keyword refresh does, how to read its state, and what happens when fresh data is not yet available.
- [Track your app](https://peekpanda.com/docs/track-your-app.md): Add an iOS app to the ASO workspace, identify it as yours or a competitor’s, and track relevant keywords.

## Your account

- [API keys](https://peekpanda.com/docs/api-keys.md): Create a named API key, copy its secret once, and revoke keys you no longer trust.
- [Billing](https://peekpanda.com/docs/billing.md): Peek and Panda launch pricing, access sources, and where to manage a subscription.
- [Profile and plan](https://peekpanda.com/docs/profile-and-plan.md): The account desk holds your name, your mark, your plan chip and where that plan came from.
- [Usage and limits](https://peekpanda.com/docs/usage-and-limits.md): What the Account usage area shows, what your plan covers, and how PeekPanda handles a limit.

## How the data works

- [Freshness and source dates](https://peekpanda.com/docs/freshness-and-source-dates.md): How to read observation dates, source dates, stale data, and a requested refresh.
- [Honest unknowns](https://peekpanda.com/docs/honest-unknowns.md): What PeekPanda does not know about an app, and why unavailable evidence is more useful than a confident guess.
- [App revenue and download estimates](https://peekpanda.com/docs/how-estimates-are-computed.md): What PeekPanda’s app revenue and download estimates mean, how to read them, and when an estimate is unavailable.
- [Keyword metrics explained](https://peekpanda.com/docs/keyword-metrics-explained.md): What Popularity, Difficulty, Opportunity, and Ranking apps mean in PeekPanda’s ASO surfaces.
- [Where the data comes from](https://peekpanda.com/docs/where-the-data-comes-from.md): The public sources PeekPanda observes, what each contributes, and what PeekPanda does not collect.

## MCP

- [Pull new competitor ads on a schedule](https://peekpanda.com/docs/scheduled-competitor-ads.md): Check your competitors for newly found paid ads on a timer, read only what is new since the last run, and transcribe the video ads.
- [Get started](https://peekpanda.com/docs/mcp.md): Connect an assistant to PeekPanda so it can ask about competitors, creatives, keywords, and charts. You need a PeekPanda account.
- [Tool reference](https://peekpanda.com/docs/mcp-tools.md): Every MCP call names a tool and passes request.action. That action is one HTTP route, not a second catalogue.
- [OAuth reference](https://peekpanda.com/docs/mcp-oauth.md): OAuth lets a client sign in to PeekPanda and receive an access token for the MCP resource. The token is not your dashboard session.

## API reference

- [Get started](https://peekpanda.com/docs/quickstart.md): Read stored iOS competitor evidence from your backend, a script, or an AI agent.
- [Authentication](https://peekpanda.com/docs/authentication.md): Use a PeekPanda API credential or the shared OAuth issuer without exposing internal secrets.
- [Scopes and tenancy](https://peekpanda.com/docs/scopes-and-tenancy.md): Understand permissions and the owner scope attached to each request.
- [List workspaces](https://peekpanda.com/docs/list-workspaces.md): List where this credential may work, with the tenancy selector for each.
- [All endpoints](https://peekpanda.com/docs/api-reference.md): The initial versioned HTTP surface, generated from the shared endpoint contract.
- [Errors and retries](https://peekpanda.com/docs/errors-and-retries.md): Handle safe envelopes, authorization failures and rate limits predictably.

## Competitors API

- [Search competitors](https://peekpanda.com/docs/search-competitors.md): Search the stored iOS competitor catalogue with bounded, cursor-based filters.
- [List competitor categories](https://peekpanda.com/docs/list-competitor-categories.md): List stored competitor-catalogue category strings and their listing counts.
- [Get competitor](https://peekpanda.com/docs/get-competitor.md): Read one stored iOS competitor-catalogue listing.
- [Get similar competitors](https://peekpanda.com/docs/get-similar-competitors.md): Read similar stored iOS listings for one competitor, strongest evidence first, each with why it matched.
- [Compare competitors](https://peekpanda.com/docs/compare-competitors.md): Read up to 10 iOS apps side by side: identity, rating and current monthly download and revenue estimates in one call.
- [Get an app developer](https://peekpanda.com/docs/get-app-developer.md): Read one iOS App Store developer and every app PeekPanda catalogues for it, with store facts, monthly download and revenue estimates and paid-ad counts, in one call.
- [Get competitor case file](https://peekpanda.com/docs/get-competitor-case-file.md): Read one competitor app’s whole overview in one request.
- [Browse observed competitor ASO keywords](https://peekpanda.com/docs/browse-competitor-aso-keywords.md): Page through the searches an iOS listing currently appears in, most popular first.
- [Get competitor organic content](https://peekpanda.com/docs/get-competitor-organic.md): Read one listing's organic posts and where PeekPanda's search for more stands.
- [Get competitor ASO intelligence](https://peekpanda.com/docs/get-competitor-aso.md): Read stored App Store search observations for one iOS listing.
- [Get competitor ASO collection status](https://peekpanda.com/docs/get-competitor-aso-collection.md): Read whether ASO coverage is queued, running, complete, or unavailable.
- [Refresh competitor ASO collection](https://peekpanda.com/docs/refresh-competitor-aso-collection.md): Refresh ASO coverage for an accessible iOS competitor when collection is available.
- [Get competitor paid-ad refresh status](https://peekpanda.com/docs/get-competitor-paid-ad-refresh.md): Read an app's latest paid-ad refresh and your remaining daily refreshes.
- [Refresh competitor paid ads](https://peekpanda.com/docs/refresh-competitor-paid-ads.md): Look for an iOS app's newest paid ads now instead of waiting for the next scheduled pass.
- [List competitor data requests](https://peekpanda.com/docs/list-competitor-data-requests.md): List recorded intelligence-request rows for one listing.
- [Request competitor data](https://peekpanda.com/docs/request-competitor-data.md): Record deduplicated demand for one missing competitor-intelligence kind.
- [Request an iOS competitor](https://peekpanda.com/docs/request-ios-competitor.md): Add one explicitly requested iOS app without requiring established-app status.
- [Discover emerging iOS competitors](https://peekpanda.com/docs/discover-emerging-ios-competitors.md): Admit emerging iOS apps from a bounded set of Apple Search queries.
- [List emerging iOS competitors](https://peekpanda.com/docs/list-emerging-ios-competitors.md): Read previously admitted emerging iOS intake listings.
- [Get competitor media](https://peekpanda.com/docs/get-competitor-media.md): Read stored organic matches and paid-ad observations for one listing.
- [Get competitor estimate history](https://peekpanda.com/docs/get-competitor-estimate-history.md): Read bounded, dated download and revenue estimates for one iOS app.
- [Refresh competitor estimates](https://peekpanda.com/docs/refresh-competitor-estimates.md): Request one bounded estimate refresh for an accessible iOS app.
- [Get competitor technology](https://peekpanda.com/docs/get-competitor-technology.md): Read stored technology evidence and best chart positions for an iOS app.
- [Refresh competitor technology](https://peekpanda.com/docs/refresh-competitor-technology.md): Explicitly request technology evidence for an accessible iOS app.

## ASO API

- [List ASO apps](https://peekpanda.com/docs/list-aso-apps.md): List the tracked iOS apps of the credential's space, with the plan's tracked-app allowance.
- [Create an ASO keyword tag](https://peekpanda.com/docs/create-aso-keyword-tag.md): Create a named, coloured label for grouping tracked keywords.
- [Update an ASO keyword tag](https://peekpanda.com/docs/update-aso-keyword-tag.md): Rename or recolour a keyword tag everywhere it is applied.
- [Remove an ASO keyword tag](https://peekpanda.com/docs/remove-aso-keyword-tag.md): Delete a tag and lift it from every keyword carrying it.
- [Tag ASO keywords](https://peekpanda.com/docs/assign-aso-keyword-tag.md): Put one tag on a set of tracked keywords, or lift it from them.
- [Track an ASO app](https://peekpanda.com/docs/track-aso-app.md): Start tracking an iOS app as mine or a competitor, or swap it in for a tracked app.
- [Add a temporary ASO app](https://peekpanda.com/docs/add-temporary-aso-app.md): Add an app idea before it has an App Store listing.
- [Get ASO workstation](https://peekpanda.com/docs/get-aso-workstation.md): Read the stored ASO workstation for one tracked app.
- [Update an ASO app role](https://peekpanda.com/docs/update-aso-app-role.md): Mark a tracked iOS app as your app or a competitor.
- [Remove an ASO app](https://peekpanda.com/docs/remove-aso-app.md): Stop tracking an iOS app.
- [Add ASO keywords](https://peekpanda.com/docs/add-aso-keywords.md): Track keywords on an ASO app and return the updated workstation.
- [Update an ASO keyword](https://peekpanda.com/docs/update-aso-keyword.md): Save a private note on one tracked keyword.
- [Remove an ASO keyword](https://peekpanda.com/docs/remove-aso-keyword.md): Remove one tracked keyword from an ASO app.
- [Refresh an ASO app](https://peekpanda.com/docs/refresh-aso-app.md): Queue stale queries for one tracked app.
- [Get ASO keyword gap](https://peekpanda.com/docs/get-aso-keyword-gap.md): Compare stored keyword positions between two apps.
- [Search iOS apps](https://peekpanda.com/docs/search-ios-apps.md): Search the live App Store by name.
- [Explore an ASO keyword](https://peekpanda.com/docs/explore-aso-keyword.md): Read the stored explore view for one keyword.
- [Refresh an ASO keyword](https://peekpanda.com/docs/refresh-aso-keyword.md): Queue a refresh for one keyword snapshot.
- [Get ASO case evidence](https://peekpanda.com/docs/get-aso-case-evidence.md): Read the compact ASO profile and keyword evidence shown on Home for one to six tracked apps.
- [Browse ASO keyword discovery](https://peekpanda.com/docs/get-aso-keyword-discovery.md): Page unsaved observed rankings or derived keyword ideas for one tracked app.

## Boards API

- [List boards](https://peekpanda.com/docs/list-boards.md): List the boards in the credential tenancy with their app and saved-ad counts and the tracked-app allowance.
- [Find board memberships](https://peekpanda.com/docs/board-memberships.md): Find which boards hold an app, up to 100 apps, or one paid ad, with each item id and note.
- [Create a board](https://peekpanda.com/docs/create-board.md): Create a named, coloured board in the credential tenancy.
- [Get a board](https://peekpanda.com/docs/get-board.md): Read one board: tracked apps with stored evidence, saved ads, the weekly and monthly pulse, activity and similar advertisers.
- [Update a board](https://peekpanda.com/docs/update-board.md): Rename or recolour a board.
- [Delete a board](https://peekpanda.com/docs/delete-board.md): Delete a board and its items.
- [Add a board item](https://peekpanda.com/docs/add-board-item.md): Put an App Store app on a board, which tracks it, or save one paid ad.
- [Update a board item](https://peekpanda.com/docs/update-board-item.md): Set or clear an item's note.
- [Remove a board item](https://peekpanda.com/docs/remove-board-item.md): Take one app or ad off a board.

## Creative API

- [Search organic content](https://peekpanda.com/docs/search-organic-content.md): Search the copied public organic corpus with bounded filters.
- [Get organic content](https://peekpanda.com/docs/get-organic-content.md): Read one stored organic corpus post by its original source id.
- [List saved organic content](https://peekpanda.com/docs/list-saved-organic-content.md): List saved organic corpus ids for the authenticated caller.
- [Save organic content](https://peekpanda.com/docs/save-organic-content.md): Save one organic corpus post to the authenticated caller account bookmarks.
- [Remove saved organic content](https://peekpanda.com/docs/remove-saved-organic-content.md): Remove one organic corpus post from the authenticated caller account bookmarks.
- [Analyze organic post](https://peekpanda.com/docs/analyze-organic-post.md): Ask for creative analysis of one stored organic post; it runs in the background.
- [Get organic post analysis](https://peekpanda.com/docs/get-organic-post-analysis.md): Read where one post’s creative analysis stands, and the analysis once it is ready.
- [Search paid ads](https://peekpanda.com/docs/search-paid-ads.md): Search stored Meta and TikTok ad-library observations.
- [Get paid ad](https://peekpanda.com/docs/get-paid-ad.md): Read one stored paid-ad observation with its matched listing and the ads around it.
- [Generate paid-ad transcript](https://peekpanda.com/docs/generate-paid-ad-transcript.md): Generate and persist a transcript from one stored ad’s mirrored video.
- [Analyze paid-ad creative](https://peekpanda.com/docs/analyze-paid-ad-creative.md): Ask for creative analysis of one stored ad’s owned media; it runs in the background.
- [Get paid-ad analysis](https://peekpanda.com/docs/get-paid-ad-analysis.md): Read where one ad’s creative analysis stands, and the analysis once it is ready.
- [Save paid ad](https://peekpanda.com/docs/save-paid-ad.md): Quick save: put one paid ad on the Saved ads board of the credential tenancy.
- [Remove saved paid ad](https://peekpanda.com/docs/remove-saved-paid-ad.md): Unsave: take one paid ad off every board in the credential tenancy.
- [Read paid-ad rankings](https://peekpanda.com/docs/paid-ad-intelligence.md): Rank advertisers by how many creatives they ship and how long those creatives stay live.
- [Chart one app's paid ads](https://peekpanda.com/docs/competitor-paid-ad-intelligence.md): Chart one competitor app's paid ads: launches, run lengths and creative mixes, for all of its advertisers or one.
- [Browse paid-ad shelves](https://peekpanda.com/docs/paid-ad-rails.md): Read paid ads as per-advertiser shelves, plus shelves for newly launched and long-running creatives.

## Charts API

- [Get Apple charts](https://peekpanda.com/docs/apple-charts.md): Read the latest stored Apple free, paid or grossing chart for one storefront and category.
- [Get Apple chart history](https://peekpanda.com/docs/apple-chart-history.md): Read dated rank points for one numeric store ID on a stored Apple chart series.

## Market API

- [Get market overview](https://peekpanda.com/docs/market-overview.md): Read who is winning one App Store storefront: the market pulse, the advertiser, viral and search-owner boards, the hottest and widest-open searches, and typed findings.
- [Get market leaderboard](https://peekpanda.com/docs/market-leaderboard.md): Read the complete bounded market page in one request: three overall charts, the selected chart, market overview, and signals for the apps shown.
- [Get market signals](https://peekpanda.com/docs/market-signals.md): Read chart, paid-ad, organic and keyword signals for up to 600 iOS apps in one batch.

## Starter boards API

- [List starter boards](https://peekpanda.com/docs/starter-boards-list.md): Browse the curated starter-board niches and their app summaries.
- [Search apps for onboarding](https://peekpanda.com/docs/starter-boards-search.md): Find stored iOS catalogue apps by name or App Store identity.
- [Preview a starter board](https://peekpanda.com/docs/starter-boards-preview.md): Preview a curated niche or find potential competitors for a selected app.
- [Adopt a starter board](https://peekpanda.com/docs/starter-boards-adopt.md): Track selected apps from a starter preview in a real board for the credential tenancy.
- [List public starter preview niches](https://peekpanda.com/docs/public-preview-niches.md): The curated niches the public starter preview covers, without an API key.
- [Read a public starter preview](https://peekpanda.com/docs/public-preview.md): The longest-running live ads of a curated niche, and how long they have run, without an API key.

- [Complete documentation](https://peekpanda.com/llms-full.txt)