# Apple App Store Search API

> Apple App Store Search API 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-15).

Search the Apple App Store by keyword and retrieve app metadata including id, developer, price, rating, genres, description, size, icon, and screenshots as JSON.

## Facts

- Endpoint: GET https://appstore.use.x402atlas.com/search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apple-app-store-search-api-347b0254
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tpvMPELn-TYq9IVa88Rsh

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-search-api-347b0254
```

Example prompt: Search the Apple App Store for 'meditation' apps and give me the top 5 results from the US store — include their ratings, prices, and developer names.

## When to prefer this

Use this endpoint when you need to search the Apple App Store by keyword and receive structured JSON metadata for multiple apps — ideal for app discovery, competitive research, or populating a UI with app listings. Prefer this over the sibling product-detail endpoint when you don't yet know the specific app ID and need to search by name, category, or keyword. Supports pagination and multi-country/language queries.

## Known failure modes

- Missing required 'term' parameter returns a 400 error
- Invalid country code may return empty results or default to a fallback store
- Requesting more than 200 results per page is rejected
- App Store may return fewer results than requested for niche queries
- Payment failure (insufficient USDC balance) blocks the request
- Rate limiting or network issues from the upstream App Store API

## How this service works

Apple App Store search — find iOS apps by term and get id, developer, price, rating, genres, description, size, icon & screenshots as clean JSON.

## Output

A JSON object containing the echoed search term, query timestamp, and an array of app results each with app id, title, bundle id, developer info, price (amount, currency, type), rating(s) with count, genres (with primary flag), version, app store link, icon/logo URLs, screenshots, and result position.

## 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": [
      "term"
     ],
     "properties": {
      "num": {
       "type": "integer",
       "default": 10,
       "maximum": 200,
       "minimum": 1,
       "description": "Optional results per page, 1–200 (default 10)"
      },
      "lang": {
       "type": "string",
       "maxLength": 12,
       "description": "Optional language code (e.g. en-us)"
      },
      "page": {
       "type": "integer",
       "minimum": 1,
       "description": "Optional page number"
      },
      "term": {
       "type": "string",
       "maxLength": 200,
       "description": "App Store search query (app name, category, or keyword)"
      },
      "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": [
      "term",
      "queried_at",
      "results"
     ],
     "properties": {
      "term": {
       "type": "string",
       "description": "Echoed search term"
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "title"
        ],
        "properties": {
         "id": {
          "type": "integer",
          "description": "App Store app id"
         },
         "link": {
          "type": "string"
         },
         "logos": {
          "type": "array",
          "items": {
           "type": "object",
           "properties": {
            "link": {
             "type": "string"
            },
            "size": {
             "type": "string"
            }
           }
          }
         },
         "price": {
          "type": "object",
          "properties": {
           "type": {
            "type": "string"
           },
           "amount": {
            "type": "number"
           },
           "symbol": {
            "type": "s
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "term": "weather",
  "results": [
   {
    "id": 1069513131,
    "price": {
     "type": "Free"
    },
    "title": "CARROT Weather: Alerts & Radar",
    "rating": [
     {
      "type": "App Store",
      "count": 51000,
      "rating": 4.8
     }
    ],
    "position": 1,
    "bundle_id": "com.grailr.CARROTWeather",
    "developer": {
     "name": "Grailr LLC"
    }
   }
  ],
  "queried_at": "2026-07-11T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apple-app-store-search-api-347b0254/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)