# App Store App Details (`appstore.app`)

Full App Store listing for one app: rating, version, size, description, screenshots.

- **Route:** `POST /v1/run/appstore.app`
- **Price:** $0.00085 per request ($0.85 per 1,000) · `cost_usd` on every response
- **Source:** Apple iTunes Search API + App Store RSS (`apple`) · failover: no
- **Measured latency:** not enough calls measured yet
- **Heavy response:** no

## Input

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `app_id` | integer, null | no | null | Numeric App Store id |
| `bundle_id` | string, null | no | null | e.g. com.spotify.client |
| `country` | string | no | "us" |  |

## Output (`output` in the run envelope)

| Field | Meaning |
|---|---|
| `rating` | Average rating. |
| `rating_count` | Ratings. |
| `version` | Current version. |

## Example

```bash
curl -s -X POST https://getallapis.com/v1/run/appstore.app \
  -H "Authorization: Bearer $GETALLAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app_id":284882215}'
```

```python
from getallapis_client import Client
client = Client()  # reads GETALLAPIS_API_KEY
result = client.run('appstore.app', {'app_id': 284882215})
print(result['cost_usd'], result['output'])
```

```bash
getallapis run appstore.app '{"app_id":284882215}'
```

Quote first (free, validates input): `POST /v1/quote/appstore.app` with the same body.
