# Apple App Store Reviews Fetcher

> Apple App Store Reviews Fetcher is a paid API for AI agents from appstore.use.x402atlas.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Fetches paginated user reviews for an iOS app by numeric product ID, returning title, text, rating, version, author, and date as clean JSON.

## Facts

- Endpoint: GET https://appstore.use.x402atlas.com/reviews
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apple-app-store-reviews-fetcher-fdecce08
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2DMOmALoik6QDzlKwLR7T

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability apple-app-store-reviews-fetcher-fdecce08
```

Example prompt: Can you pull the most recent user reviews for the Spotify iOS app (product ID 324684580) from the US App Store, starting on page 1?

## When to prefer this

Use this endpoint when you need the actual text and metadata of user-submitted App Store reviews for a specific iOS app — especially for sentiment analysis, competitive research, or user feedback monitoring. Prefer this over the product details endpoint when you need the full body of individual reviews rather than aggregate rating summaries. Pair with the App Store search endpoint to resolve an app name to its numeric product_id first.

## Known failure modes

- Invalid or non-numeric product_id returns an error
- App not found for given product_id returns empty or error response
- Invalid country code may return no results or default to a fallback store
- Invalid sort enum value returns a validation error
- Page number beyond total page count returns empty reviews array
- Payment not processed results in 402 response

## How this service works

Apple App Store reviews — pull an app's user reviews by numeric product_id: title, text, rating, version, author & date, with paging & sort, as clean JSON.

## Output

A JSON object containing the product_id, query timestamp, pagination info (total pages, results count, reviews for current version), and an array of review objects each with id, title, text, numeric rating, author name and ID, review date, reviewed version, position, and helpfulness vote info.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "product_id"
     ],
     "properties": {
      "page": {
       "type": "integer",
       "minimum": 1,
       "description": "Optional page number"
      },
      "sort": {
       "enum": [
        "mostrecent",
        "mosthelpful",
        "mostfavorable",
        "mostcritical"
       ],
       "type": "string",
       "default": "mostrecent",
       "description": "Optional order: mostrecent (default), mosthelpful, mostfavorable, mostcritical"
      },
      "country": {
       "type": "string",
       "maxLength": 2,
       "description": "Optional two-letter store country (e.g. us, gb)"
      },
      "product_id": {
       "type": "string",
       "pattern": "^[0-9]+$",
       "maxLength": 32,
       "description": "Numeric App Store app id (from /appstore/search)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "product_id",
      "queried_at",
      "reviews"
     ],
     "properties": {
      "info": {
       "type": "object",
       "properties": {
        "results_count": {
         "type": "integer"
        },
        "total_page_count": {
         "type": "integer"
        },
        "reviews_for_current_version": {
         "type": "integer"
        }
       }
      },
      "reviews": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": "string"
         },
         "text": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "author": {
          "type": "object",
          "properties": {
           "name": {
            "type": "string"
           },
           "author_id": {
            "type": "string"
           }
          }
         },
         "rating": {
          "type": "number"
         },
         "position": {
          "type": "integer"
         },
 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "info": {
   "results_count": 500,
   "total_page_count": 10
  },
  "reviews": [
   {
    "id": "7417861364",
    "text": "Accurate and hilarious.",
    "title": "Best weather app",
    "author": {
     "name": "rainlover"
    },
    "rating": 5,
    "review_date": "2026-07-01",
    "reviewed_version": "5.9.0"
   }
  ],
  "product_id": "1069513131",
  "queried_at": "2026-07-11T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apple-app-store-reviews-fetcher-fdecce08/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from appstore.use.x402atlas.com](https://www.zero.xyz/host/appstore.use.x402atlas.com/llms.txt)