# 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-13).

Fetches paginated user reviews for an iOS app by its numeric App Store product ID embedded in the URL path, returning titles, text, ratings, and version info.

## Facts

- Endpoint: GET https://appstore.use.x402atlas.com/v2/product/%7Bproduct_id%7D/reviews
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apple-app-store-reviews-by-product-id-path-variant-7d962003
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EgA89ejF5-1RQTDuY8flw

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-7d962003
```

Example prompt: Pull the most recent App Store reviews for the app with ID 1069513131 from the US store, starting on page 1.

## When to prefer this

Use this endpoint when you already have a numeric App Store product ID (e.g. obtained from the search endpoint) and want to retrieve user reviews via a clean URL path structure. Prefer this path-variant over query-param alternatives when your HTTP client or routing layer makes path parameters more convenient. Choose the sort parameter to target specific review types: mostrecent for monitoring, mosthelpful for summarization, mostfavorable/mostcritical for sentiment analysis.

## Known failure modes

- Invalid or non-numeric product_id returns an empty reviews array with a note field rather than an error
- Non-existent product_id may return empty results without a 404
- Payment not provided returns HTTP 402 challenge requiring X-PAYMENT header
- Invalid sort enum value may cause a validation error
- Country code not supported may return results defaulting to US store
- Rate limiting or network issues may cause intermittent failures

## How this service works

**Apple App Store Search & Reviews** on x402 Atlas — pay-per-call over the [x402 protocol](https://x402.org).

Paid routes are billed per call in USDC on Base, Polygon, or Arbitrum, starting at $0.005; each operation states its exact price below. Request a route with no payment to receive the `402` challenge, then repeat it with an `X-PAYMENT` header — an x402 client (`x402-fetch` / `x402-axios`) performs that exchange for you.

Full onboarding, quickstart, and the other APIs: https://use.x402atlas.com/docs

## Output

A JSON object containing a list of user reviews (each with ID, title, text body, star rating, author name, review date, and app version reviewed), along with pagination metadata (total results count, total page count) and the queried product ID and timestamp. If no reviews are found, a note field provides a hint.

## 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)
```

## 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-by-product-id-path-variant-7d962003/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)