# AppstoreSpy

> Mobile-app market-intelligence provider. One public REST API over App Store
> (iOS) and Google Play data: app metadata, developers, reviews, chart rankings,
> download/revenue estimates, daily installs, keyword suggestions and LiveOps
> events across roughly 13 million apps in 100 countries.

Generated by the API Evangelist enrichment pipeline on 2026-08-22 from the
provider's own published OpenAPI contract and public pages. AppstoreSpy does not
publish an llms.txt of its own (https://appstorespy.com/llms.txt and
https://api.appstorespy.com/llms.txt both returned 404 on 2026-08-22).

## What an agent needs to know first

- Base URL: https://api.appstorespy.com/v1
- Auth: send the `API-KEY` request header on every call. Keys are issued at
  https://appstorespy.com/account and require an active Business plan
  ($199/month). There is no free or trial API tier.
- Contract: OpenAPI 3.1.0, 33 operations, publicly retrievable and
  unauthenticated at https://api.appstorespy.com/openapi.json
- Metering: API credits, charged per call. The per-endpoint credit cost is not
  published. Monthly allowances by plan: Free 100, Premium 1,000, Pro 10,000,
  Business 100,000 (the API landing page states 12,000 for Business - the
  provider's two pages disagree).
- Failure modes: 401 when the API-KEY header is missing (edge envelope
  `{"message":...,"code":...}`), 403 for an invalid token, 422 for validation
  errors (FastAPI `detail[]` shape), 429 when over the rate limit. No
  Retry-After or RateLimit-* header is published or observed.
- 202 Accepted is a normal answer, not an error: the app or term was not in the
  database and has been queued for crawling. Retry the same request later.
- 204 No Content means there is no data for the requested country.
- A 200 list response can still carry per-item failures in its `errors[]` array
  alongside `data[]` and `total_count` - inspect it.

## API

- [OpenAPI 3.1.0 contract](https://api.appstorespy.com/openapi.json): 33
  operations over App Store and Google Play data.
- [Swagger UI](https://api.appstorespy.com/docs): interactive reference,
  including the conventions for `fields`, `sort`, country/language and the
  status-code reference.
- [ReDoc](https://api.appstorespy.com/redoc): the same contract, rendered.
- [API landing page](https://appstorespy.com/app-store-api): capabilities,
  credit packs, plan gating.

## Operations by area

- App Store apps: get app by ID, search, filter search, similar apps, summary,
  reviews, recrawl, estimates, rankings, available countries and languages.
- App Store developers: get developer, search developers, developer app
  estimates.
- Google Play apps: get app by package ID, search, filter search, similar apps,
  summary, reviews, recrawl, estimates, daily installs, rankings, available
  countries and languages.
- Google Play developers: get developer, search developers, developer app
  estimates.
- Google Play discovery: keyword suggestions, LiveOps events.
- Jobs: create an asynchronous store-search crawl job, retrieve it by search_id.

## Request conventions

- `fields=name,developer_name,ipd,downloads` selects which fields come back;
  omit it to get everything.
- `sort=ratingCount` ascending, `sort=-ratingCount` descending.
- `page` and `limit` give offset pagination on the operations that expose them;
  `total_count` is returned in the list envelope.
- `country` and `language` scope a request; query the per-app availability
  endpoints first (`/ios/info/countries`, `/play/info/languages`, ...).

## Commercial

- [Pricing](https://appstorespy.com/pricing): Free $0, Premium $19, Pro $99,
  Business $199 per month; 20% off annual. Extra credit packs: 25,000 for $60,
  50,000 for $120, 100,000 for $220.
- [Sign up](https://appstorespy.com/sign_up) / [sign in](https://appstorespy.com/sign_in)
- [Agreement](https://appstorespy.com/agreement)
- [Privacy](https://appstorespy.com/privacy)
- [Support](https://appstorespy.com/support): support@appstorespy.com
- [Blog](https://appstorespy.com/blog)

## What AppstoreSpy does NOT publish (checked 2026-08-22)

- No MCP server (remote or stdio), no A2A agent card, no published agent skills.
- No first-party SDK in any registry (npm, PyPI, RubyGems, crates.io) and no
  GitHub organization.
- No /.well-known/ documents on either host, including security.txt.
- No status page, no API changelog, no deprecation or sunset policy, no SLA.
- No sandbox or test-mode keys; no CLI.
- No published numeric rate limit and no rate-limit response headers.
- https://appstorespy.com/graphql answers introspection but exposes only a
  placeholder `Query { Hello: String }` - it is not a data API.