# PeekPanda documentation

> PeekPanda is an iOS competitor catalogue and stored creative intelligence service. Public API and MCP setup remain a preview until the public hosts and customer authorization are deployment verified.

## Get started

- [Plans and refreshes](https://peekpanda.com/docs/plans-and-refreshes.md): Peak and Panda, what a requested refresh is, and how the shared daily refresh budget works.
- [How to read the evidence](https://peekpanda.com/docs/reading-the-evidence.md): Every stored fact carries a source date, estimates are labelled as estimates, and unknowns stay unknown.
- [Start peeking in 4 steps](https://peekpanda.com/docs/start-peeking.md): Find an app, open its case file, read the evidence, and track it 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 the Apple charts](https://peekpanda.com/docs/rank-history-and-charts.md): Read the daily Apple charts across six storefronts, then follow one app's observed rank over time.
- [Revenue and download estimates](https://peekpanda.com/docs/revenue-and-download-estimates.md): How the download and revenue figures are modelled, what they are worth, and what they are not.
- [Finding similar apps](https://peekpanda.com/docs/similar-apps.md): Four 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 an app by name in the iOS catalogue, then read the filtered catalogue table.
- [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): Admit recently launched iOS apps with early traction, and read the board that tracks whether they are growing.
- [Leaderboards](https://peekpanda.com/docs/leaderboards.md): Read the daily Apple charts by country, shelf and chart type, and understand what a rank movement means.
- [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

- [Organic content library](https://peekpanda.com/docs/organic-content-library.md): Search the copied corpus of TikTok, Instagram and Threads posts, and read one post's hook, engagement and monetization signals.
- [Paid ads library](https://peekpanda.com/docs/paid-ads-library.md): Search stored Meta and TikTok ad-library observations, matched to the app they advertise, and read how long each ad has run.
- [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 ads and posts to your account, 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): Four numbers and a ranking for any App Store phrase, with the exact formula behind the derived opportunity score.
- [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 the refresh pill does, what a refresh spends against the shared daily budget, and how to read the receipt it returns.
- [Track your app](https://peekpanda.com/docs/track-your-app.md): Add an iOS app by name, choose whether it is yours or a rival's, and watch the keywords you care about on every refresh.

## Your account

- [API keys](https://peekpanda.com/docs/api-keys.md): Create a named API key on the account desk, copy the secret once, and delete keys you no longer trust.
- [Billing](https://peekpanda.com/docs/billing.md): Peak and Panda launch pricing, how access is granted today while checkout is still being prepared, and what the billing portal does.
- [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 four usage tiles on the account desk count, which limits are actually enforced, and what happens when you reach one.

## How the data works

- [Freshness and source dates](https://peekpanda.com/docs/freshness-and-source-dates.md): What "observed at" means, what a tape day is, how a stored fact ages, when it counts as stale, and what a requested refresh actually changes.
- [Honest unknowns](https://peekpanda.com/docs/honest-unknowns.md): What PeekPanda does not know about an app, why the limit exists, and why a null is more useful to you than a confident guess.
- [How estimates are computed](https://peekpanda.com/docs/how-estimates-are-computed.md): The full derivation of the install and revenue models, every constant, every calibration anchor, and the exact conditions under which each returns nothing.
- [Keyword metrics explained](https://peekpanda.com/docs/keyword-metrics-explained.md): The full derivation of Demand, Difficulty, Ranking apps and the derived Opportunity score, with every constant and every failure mode.
- [Where the data comes from](https://peekpanda.com/docs/where-the-data-comes-from.md): Every collection lane behind PeekPanda: which public surfaces are read, how often, what each one contributes, and the three different ways an app enters the catalogue.

## Start here

- [Quickstart](https://peekpanda.com/docs/quickstart.md): Make your first authenticated discovery request in a few minutes.

## Guides

- [Authentication](https://peekpanda.com/docs/authentication.md): Use a PeekPanda API credential or the shared OAuth issuer without exposing internal secrets.
- [Scopes & tenancy](https://peekpanda.com/docs/scopes-and-tenancy.md): Understand permissions and the owner scope attached to each request.

## Reference

- [API reference](https://peekpanda.com/docs/api-reference.md): The initial versioned HTTP surface, generated from the shared endpoint contract.
- [MCP](https://peekpanda.com/docs/mcp.md): Connect an agent to the PeekPanda tool profile. MCP is the same owner-scoped contract as HTTP, not a second data source and not Astro's local MCP.
- [Errors & 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, with the list page envelope.
- [Get competitor organic content](https://peekpanda.com/docs/get-competitor-organic.md): Read stored organic-corpus name-match suggestions for one listing.
- [Get competitor ASO intelligence](https://peekpanda.com/docs/get-competitor-aso.md): Read the invert of stored iTunes Search snapshots for one iOS listing.
- [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): Admit one explicitly requested iOS app without the established 100-rating floor.
- [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 PeekPanda rating-tape and grossing-rank 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.

## ASO API

- [List ASO apps](https://peekpanda.com/docs/list-aso-apps.md): List the owner's tracked iOS ASO apps from storage.
- [Track an ASO app](https://peekpanda.com/docs/track-aso-app.md): Start tracking an iOS app as mine or a competitor.
- [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.
- [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.

## 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.
- [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): Generate and persist Gemini creative analysis from one stored ad’s owned media.
- [Save paid ad](https://peekpanda.com/docs/save-paid-ad.md): Save one stored paid-ad observation to the authenticated caller account bookmarks.
- [Remove saved paid ad](https://peekpanda.com/docs/remove-saved-paid-ad.md): Remove one stored paid-ad observation from the authenticated caller account bookmarks.

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

## Paid-ad Admin API

- [Search paid-ad advertisers](https://peekpanda.com/docs/search-paid-ad-advertisers.md): Find advertisers before candidate discovery.
- [Preview paid ads](https://peekpanda.com/docs/preview-paid-ads.md): Preview bounded candidates before selecting an import.
- [Import selected paid ads](https://peekpanda.com/docs/import-paid-ads.md): Create an idempotent import linked to one exact iOS app.
- [Get paid-ad import status](https://peekpanda.com/docs/get-paid-ad-import.md): Read the canonical ingestion-run status.
- [Retry paid-ad import](https://peekpanda.com/docs/retry-paid-ad-import.md): Retry a failed or incomplete run with a fresh idempotency key.
- [Link imported paid ads](https://peekpanda.com/docs/link-paid-ads.md): Link already imported ads to one exact iOS app.

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