# Mac App Store Lookup by App ID

> Mac App Store Lookup by App ID is a paid API for AI agents from api.fadeandco.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Fetches Mac App Store metadata (name, seller, version, price, rating, genre, store link) for a given Mac app by its iTunes track ID.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/dev/mac-app-store?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mac-app-store-lookup-by-app-id-30b4b5b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2QHa-JENLGEKBgnPv2qDS

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 mac-app-store-lookup-by-app-id-30b4b5b9
```

Example prompt: What's the current version, price, and rating of Xcode (App Store ID 497799835) on the Mac App Store?

## When to prefer this

Use this endpoint when you need structured Mac App Store metadata for a specific app by its iTunes track ID, especially when you want version, pricing, seller, and rating data in a single call without scraping the App Store yourself. Prefer this over general web search when you need machine-readable, consistently structured output. Note this is Mac apps only — use the sibling Google Play endpoint for Android apps.

## Known failure modes

- Invalid or non-Mac App Store track ID returns no results or an error
- Non-numeric ID format causes a validation error
- App exists on iOS but not Mac App Store returns empty or mismatched data
- Rating count and average rating return 0 when Apple has not published ratings for the app
- Invalid country code may return no results or default to US store
- Network timeout if Apple's iTunes Lookup API is temporarily unavailable

## How this service works

Mac App Store app metadata from Apple's public iTunes Lookup API by App Store id: name, seller, version, price, average rating and rating count (0 when Apple shows none), genre and store link. Mac apps only.

## Output

A JSON object containing the app's numeric ID, name, genre, price, currency, seller name, version, release date, average rating, rating count, store URL, the iTunes source URL used, country code, and the timestamp when the data was checked.

## 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": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Mac App Store track id, digits only, e.g. 497799835 (Xcode)"
      },
      "country": {
       "type": "string",
       "description": "Two-letter store country code (default us)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": 497799835,
  "name": "Xcode",
  "genre": "Developer Tools",
  "price": 0,
  "seller": "Apple Inc.",
  "source": "https://itunes.apple.com/lookup?id=497799835&country=us&entity=macSoftware",
  "country": "us",
  "version": "27.1",
  "currency": "USD",
  "storeUrl": "https://apps.apple.com/us/app/xcode/id497799835?mt=12&uo=4",
  "checkedAt": "2026-10-23T09:35:51.302Z",
  "ratingCount": 0,
  "releaseDate": "2026-10-15T20:22:08Z",
  "averageRating": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mac-app-store-lookup-by-app-id-30b4b5b9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.fadeandco.workers.dev](https://www.zero.xyz/host/api.fadeandco.workers.dev/llms.txt)