# App Store Listing and Ratings

> App Store Listing and Ratings is a paid API for AI agents from x402-filings.datalayer.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Retrieves App Store metadata for any app including star ratings, review counts, version, price, size, genres, and a version-sentiment comparison between current and all-time ratings.

## Facts

- Endpoint: GET https://x402-filings.datalayer.workers.dev/v1/apps/lookup?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/app-store-listing-and-ratings-671d1e58
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0dm2EzicItpGWqzTYQ1bi

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 app-store-listing-and-ratings-671d1e58
```

Example prompt: Can you look up the App Store listing for Duolingo on the US storefront and tell me its current star rating, all-time rating, latest version, and whether the new version hurt or improved its reception?

## When to prefer this

Use this endpoint when you need rich App Store metadata beyond what a simple search returns — especially when you want the version-sentiment delta to detect whether a recent release damaged an app's reputation. Prefer this over scraping the App Store or using iTunes Search API directly when you need structured, normalized output with the current-vs-all-time rating comparison built in. Ideal for competitive intelligence, app monitoring, and release quality assessment workflows.

## Known failure modes

- App ID not found: returns empty or error if numeric ID doesn't match any app
- Search returns no results: if the app name search yields nothing, the result set will be empty
- Country code invalid: unrecognized storefront code may default to US or return an error
- Limit out of range: limit values outside 1-25 may be rejected or clamped
- Rate limiting or payment failure: x402 payment not processed results in 402 response

## How this service works

App Store listing data for any app on any storefront: current and all-time star ratings with review counts, version, release notes, size, price, content rating, genres and release dates. Includes a version-sentiment read comparing the current version's rating against its all-time average, which is how you spot a release that damaged an app. Look up by numeric App Store id or search by name.

## Output

Returns structured App Store data including current star rating, all-time star rating, review count, app version, release notes, file size, price, content rating, genre tags, and release dates. Also includes a version-sentiment indicator comparing the current version's rating to the all-time average so you can tell whether a recent update helped or hurt the app's reputation.

## 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",
     "properties": {
      "appId": {
       "type": "string",
       "examples": [
        "284882215"
       ],
       "description": "Numeric App Store id. Either appId or search is required."
      },
      "limit": {
       "type": "integer",
       "examples": [
        10
       ],
       "description": "Max apps when searching, 1-25. Default 10."
      },
      "search": {
       "type": "string",
       "examples": [
        "duolingo"
       ],
       "description": "App name to search for instead of an id."
      },
      "country": {
       "type": "string",
       "examples": [
        "us"
       ],
       "description": "Two-letter storefront. Default us."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/app-store-listing-and-ratings-671d1e58/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-filings.datalayer.workers.dev](https://www.zero.xyz/host/x402-filings.datalayer.workers.dev/llms.txt)