# Apple App Store Reviews by Product ID (Path Variant)

> Apple App Store Reviews by Product ID (Path Variant) 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 in the URL path, returning title, text, rating, version, author, and date as clean JSON.

## Facts

- Endpoint: GET https://appstore.use.x402atlas.com/v2/product/:product_id/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-by-product-id-path-variant-09be914f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PMvU2fcTxRiT_AsGGgwLZ

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-by-product-id-path-variant-09be914f
```

Example prompt: Pull the most recent App Store user reviews for the app with ID 284882215 — grab page 1 sorted by mostrecent from the US store and give me the title, rating, and review text for each.

## When to prefer this

Choose this endpoint when you need reviews for a specific iOS app by its numeric App Store ID and want clean, structured JSON with paging and sort control. The path-based product_id variant is useful when constructing URLs programmatically. Prefer it over scraping App Store pages directly, and use the companion search endpoint first if you need to resolve an app name to its numeric ID.

## Known failure modes

- Non-numeric or invalid product_id returns no reviews with a note hint rather than an error
- App ID that does not exist on the App Store returns an empty reviews array
- Requesting a page beyond total_page_count returns an empty or minimal response
- Invalid country code may fall back to a default store or return no results
- Rate limiting or payment failure may interrupt the x402 pay-per-call flow

## How this service works

Apple App Store reviews (path variant) — an app's user reviews by product_id in the URL: title, text, rating, version, author & date, with paging & sort, as clean JSON.

## Output

Returns a JSON object containing the product_id, query timestamp, and an array of reviews — each with id, title, text, rating (numeric), author name and ID, review date, reviewed app version, position, and helpfulness vote info. Also includes pagination metadata (total_page_count, results_count, reviews_for_current_version). A note field appears when no reviews matched.

## 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",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "product_id"
     ],
     "properties": {
      "product_id": {
       "type": "string",
       "pattern": "^[0-9]+$",
       "maxLength": 32,
       "description": "Numeric App Store app id (from /appstore/search)"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "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)"
      }
     }
    }
   },
   "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"
        }
       }
      },
      "note": {
       "type": "string",
       "description": "Present only when no reviews matched: a hint that product_id must be a numeric App Store id. The paid lookup still ran."
      },
      "reviews": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": "string"
         },
         "text": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "author": {
          "type": "object",
          "proper
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apple-app-store-reviews-by-product-id-path-variant-09be914f/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)