# applecensorship.com — Apple App Store censorship monitor

> Apple Censorship (a GreatFire project) tracks the availability of iOS apps across
> Apple's ~175 App Store storefronts worldwide, recording where each app is available
> or unavailable and when its status changed.

## Data access
- App availability JSON API: https://applecensorship.com/api/apps/{appStoreId}/status
  Returns tested-storefront count, available/unavailable counts, per-country status
  (ISO 3166-1 alpha-2 codes) and last-tested timestamps (ISO 8601, UTC) for a numeric
  Apple App Store ID.
  Example: https://applecensorship.com/api/apps/1518427877/status
- Sitemap: https://applecensorship.com/sitemap.xml
- Methodology: https://applecensorship.com/methodology

## Field definitions (/api/apps/{id}/status)
- appStoreId: numeric Apple App Store identifier.
- testedStores: number of storefronts with test data for this app.
- totalStorefronts: total number of Apple App Store storefronts monitored (~175).
- availableStores / unavailableStoreCount / notTestedCount: counts from the latest
  test per storefront.
- unavailableStores[]: { countryCode, status, previousStatus, lastTested }.
- stores[]: same shape, for every tested storefront.
- status values: "available", "unavailable", "not_tested".
- lastTested: most recent test time across storefronts (ISO 8601, UTC).

## Update frequency
Storefronts are re-tested continuously; every record carries its own lastTested time.

## Important interpretation note
App unavailability in a storefront does NOT by itself prove censorship. Causes include
removal by Apple, withdrawal by the developer, government or legal requests, or unknown
reasons. Do not state a reason unless it is documented.

## Licensing
Data (c) GreatFire / Apple Censorship. Please attribute "Apple Censorship
(applecensorship.com)" and link to the source page.

## Contact
https://applecensorship.com/contact