# Apple App Store Product Details (Path Variant)

> Apple App Store Product Details (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 a full profile for a single iOS app by its numeric product_id supplied in the URL path, returning rating, price, description, developer info, screenshots, version history, and more.

## Facts

- Endpoint: GET https://appstore.use.x402atlas.com/v2/product/%7Bproduct_id%7D
- 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-product-details-path-variant-b24941b4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aEq2vU6E3djHcXYiTUqGj

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-product-details-path-variant-b24941b4
```

Example prompt: Can you pull up the full App Store details for CARROT Weather — its rating, price, developer, and latest version history? The app ID is 1069513131.

## When to prefer this

Use this endpoint when you already have a numeric App Store product_id (e.g. from a prior search call) and need the complete app metadata — rating, description, version history, screenshots, developer details — for a single app. Prefer this path-variant form when your HTTP client or routing logic naturally places the product_id in the URL path rather than a query parameter. Choose over the sibling query-param variant based on your client's URL construction preference; both return equivalent data.

## Known failure modes

- Invalid product_id format (non-numeric) — schema validation error before call
- product_id not found in App Store — response includes a 'note' field indicating no match, but the paid call still ran and is billed
- Missing payment header — server returns HTTP 402 challenge with payment details
- Invalid country code — may return no result or default to US store
- Network or upstream Apple data unavailability — may return empty or partial product fields

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

Returns a JSON object with the app's full profile including: numeric ID, title, price, star rating, rating count, developer name and link, age rating, full description, category, file size, seller, copyright, version history (date, notes, version per release), iPhone and iPad screenshots URLs, and a queried_at timestamp. If no app matches the ID, a note field explains the error.

## 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": {
      "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": [
      "queried_at",
      "product"
     ],
     "properties": {
      "note": {
       "type": "string",
       "description": "Present only when no app matched: a hint that product_id must be a numeric App Store id. The paid lookup still ran."
      },
      "product": {
       "type": "object",
       "properties": {
        "id": {
         "type": "string"
        },
        "logo": {
         "type": "string"
        },
        "price": {
         "type": "string"
        },
        "title": {
         "type": "string"
        },
        "rating": {
         "type": "number"
        },
        "snippet": {
         "type": "string"
        },
        "developer": {
         "type": "object",
         "properties": {
          "id": {
           "type": "integer"
          },
          "link": {
           "type": "string"
          },
          "name": {
           "type": "string"
          }
         }
        },
        "age_rating": {
         "type": "string"
        },
        "description": {
         "type": "string"
        },
        "information": {
         "type": "object",
         "properties": {
          "size": {
           "type": "string"
          },
          "seller": {
           "type": "string"
          },
          "category": {
           "type": "string"
          },
          "copyright
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "product": {
   "id": "1069513131",
   "price": "Free",
   "title": "CARROT Weather: Alerts & Radar",
   "rating": 4.8,
   "developer": {
    "name": "Grailr LLC"
   },
   "age_rating": "12+",
   "rating_count": "51K Ratings"
  },
  "queried_at": "2026-07-11T12:00:00Z"
 }
}
```

## More

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