# App Store API
> Search and look up apps on the Apple App Store as an API. Pass a search term and get matching iOS apps with their developer, average star rating and rating count, price, category and icon; or look up a single app by its App Store id (or bundle id) for the full record — description, current version, release and update dates, content rating, minimum iOS version, app size, supported languages, screenshots and the store link. Ratings and price are returned per country (default US). Live from the public iTunes Search API. Ideal for app-store optimisation (ASO), competitor and market research, app directories, review dashboards and mobile-developer tools. Public Apple data.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/appstore-api/..."
```

## Pricing
- **Free** (Free) — 3,780 calls/Mo, 2 req/s
- **Starter** ($5/Mo) — 50,500 calls/Mo, 8 req/s
- **Pro** ($13/Mo) — 246,000 calls/Mo, 20 req/s
- **Mega** ($35/Mo) — 1,209,000 calls/Mo, 50 req/s

## Endpoints

### App Store

#### `GET /v1/app` — One app by id or bundle id

**Parameters:**
- `id` (query, required, string) — App Store numeric id, e.g. 324684580 (Spotify) Example: `324684580`
- `bundle_id` (query, optional, string) — Bundle id (alternative to id), e.g. com.spotify.client
- `country` (query, optional, string) — 2-letter country (default US)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/appstore-api/v1/app?id=324684580"
```

**Response:**
```json
{
    "data": {
        "app": {
            "id": 324684580,
            "url": "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580?uo=4",
            "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/26/53/7b/26537b47-88c8-845a-fb1b-a65702602a10/AppIcon-0-0-1x_U007epad-0-1-0-0-sRGB-85-220.png/512x512bb.jpg",
            "name": "Spotify: Music and Podcasts",
            "genre": "Music",
            "price": "Free",
            "genres": [
                "Music",
                "Entertainment"
            ],
            "rating": 4.78,
            "size_mb": 258.8,
            "updated": "2026-05-15T08:29:09Z",
            "version": "9.1.48",
            "currency": "USD",
            "released": "2011-07-14T11:22:37Z",
            "bundle_id": "com.spotify.client",
            "developer": "Spotify",
            "languages": [
                "AF",
                "AM",
                "AR",
                "AZ",
                "EU",
                "BN",
                "BS",
                "BG",
                "CA",
                "HR",
                "CS",
                "DA",
                "NL",
                "EN",
                "ET",
                "FI",
                "FR",
                "GL",
                "DE",
                "EL",
                "GU",
                "HE",
                "HI",
                "HU",
                "IS",
                "ID",
                "IT",
                "JA",
        
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search the App Store

**Parameters:**
- `term` (query, required, string) — Search term, e.g. spotify Example: `spotify`
- `country` (query, optional, string) — 2-letter country, e.g. US, GB, DE (default US)
- `genre` (query, optional, string) — Genre id to filter by
- `limit` (query, optional, string) — Results (1-100, default 20) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/appstore-api/v1/search?term=spotify&limit=20"
```

**Response:**
```json
{
    "data": {
        "term": "spotify",
        "count": 15,
        "country": "US",
        "results": [
            {
                "id": 324684580,
                "url": "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580?uo=4",
                "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/26/53/7b/26537b47-88c8-845a-fb1b-a65702602a10/AppIcon-0-0-1x_U007epad-0-1-0-0-sRGB-85-220.png/512x512bb.jpg",
                "name": "Spotify: Music and Podcasts",
                "genre": "Music",
                "price": "Free",
                "genres": [
                    "Music",
                    "Entertainment"
                ],
                "rating": 4.78,
                "size_mb": 258.8,
                "version": "9.1.48",
                "currency": "USD",
                "bundle_id": "com.spotify.client",
                "developer": "Spotify",
                "price_value": 0,
                "developer_id": 324684583,
                "rating_count": 40129084,
                "content_rating": "12+"
            },
            {
                "id": 1108187390,
                "url": "https://apps.apple.com/us/app/apple-music/id1108187390?uo=4",
                "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/31/6c/c3/316cc33a-5e7d-8902-58eb-f4e16c5d9440/music-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/512x512bb.jpg",
                "name": "Apple Music",
                "genre": "Music",
                "price": 
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Source & notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/appstore-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Search and look up iOS apps on the Apple App Store. /v1/search?term= returns matching apps with developer, rating, price, genre and icon; /v1/app?id= (or bundle_id=) returns one app's full details incl. description, screenshots, version history and supported languages. Ratings and price are country-specific (default country=US).",
        "source": "Apple App Store (iTunes Search API)",
        "endpoints": [
            "/v1/search",
            "/v1/app",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-05-31T11:29:28.298Z",
        "request_id": "eafb4662-0574-4f8b-869d-416df1264eb7"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/appstore-api
OpenAPI spec: https://www.oanor.com/api/appstore-api/openapi.json