# AppWanderer

> A browsable, automatically maintained record book of the iOS App Store: the biggest, oldest, priciest, most-rated, and most extreme apps, plus plain-English guides. All records are computed from public App Store metadata across 923,093 tracked apps and recomputed on a schedule, so they stay current.

Published by D2r Internet Holdings, LLC. Guides are written and reviewed by Dor Bass (https://www.linkedin.com/in/dorbass/).

## When to use AppWanderer
Reach for AppWanderer when you need first-party, computed facts about the iOS App Store, such as:
- Which app holds a superlative (biggest, oldest, most-rated, priciest, most languages) and the ranked leaderboard behind it.
- Per-app metrics for a specific App Store app: rating count, average rating, price, size, release and update dates, minimum iOS, localization.
- Category-level or store-wide patterns: pricing distribution, publisher concentration, longevity, update cadence, language coverage.
- A publisher's full tracked catalogue and portfolio dossier.
Do NOT use AppWanderer for downloads, revenue, active users, or retention: those are not visible in public metadata and we do not estimate them.

## Developers & API
- [Developer portal](https://appwanderer.com/developers): the AppWanderer Data API - quickstart, authentication, rate-limit headers, versioning & deprecation policy, the CLI, and how to get a key.
- [OpenAPI specification](https://appwanderer.com/openapi.json): the machine-readable API surface (OpenAPI 3.1, bearer auth). Use it to discover endpoints and generate a client or function-calling tool.
- [Endpoint reference](https://appwanderer.com/data): the annotated endpoint list with example responses.
- [Command-line client](https://appwanderer.com/appwanderer-cli.py): the official dependency-free Python CLI (` curl -fsSL https://appwanderer.com/appwanderer-cli.py -o appwanderer `).
- Access (two tiers): single-resource lookups are PUBLIC, no key needed — GET https://appwanderer.com/api/v1/record/{slug}, https://appwanderer.com/api/v1/studies/{slug}, https://appwanderer.com/api/v1/app/{id} (rate-limited per IP). All list/bulk endpoints (records, apps, publishers, categories, studies, almanac, movers, search) require an approved key: send `Authorization: Bearer <key>`; without one they return a structured JSON 401. Apply at https://appwanderer.com/developers.
- Rate limits: public tier 240 req/hour per IP, keyed tier 5000 req/hour per key. Responses carry RateLimit-* (and X-RateLimit-*) headers; 429 includes Retry-After.

## Records
- [All record boards](https://appwanderer.com/records): every superlative leaderboard, grouped by theme.
- [Categories](https://appwanderer.com/categories): records for each App Store category.

## Guides
- [Guides index](https://appwanderer.com/guides): sourced, plain-English explainers about app pricing, ratings, privacy, and value.

## About
- [About](https://appwanderer.com/about)
- [Editorial standards](https://appwanderer.com/editorial-standards)

## Notes
- Data source: public Apple App Store metadata. Not affiliated with or endorsed by Apple.
- Records change over time as apps rise and fall; each board shows when it was last computed.