# Apple API: List top App Store charts

> Lists ranked iPhone or iPad apps from the public App Store charts for a chart, category, and country. App bundles and apps that are no longer available are left out.

Unofficial. Not affiliated with or endorsed by Apple.

- Page: https://fous.com/methods/apps.apple.com/list-top-charts
- Method: `apps.apple.com/list_top_charts`, version 1
- Website: apps.apple.com
- Returns: rank, app name, developer, price, currency, category, link, app id
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `chart` | string | no | `"top_free"` | Chart to list, for example top_free. One of "top_free", "top_paid". Default "top_free". |
| `device` | string | no | `"iphone"` | Device chart, for example iphone. One of "iphone", "ipad". Default "iphone". |
| `country` | string | no | `"United States"` | Country name or two-letter country code, for example United States or gb. Default "United States". |
| `category` | string | no | `"all apps"` | Chart category in words, for example games, business, or health and fitness. Default "all apps". |
| `max_results` | integer | no | `50` | Maximum number of ranked positions to read (up to 200). Default 50. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "chart": "top_free",
  "device": "iphone",
  "country": "United States",
  "category": "all apps",
  "max_results": 50
}
```

Its output:

```json
{
  "apps": [
    {
      "rank": 1,
      "price": 0,
      "app_id": "407558537",
      "app_name": "Capital One Mobile",
      "category": "Finance",
      "currency": "USD",
      "developer": "Capital One",
      "app_store_link": "https://apps.apple.com/us/app/capital-one-mobile/id407558537"
    },
    {
      "rank": 2,
      "price": 0,
      "app_id": "632064380",
      "app_name": "Vinted: Pre-loved marketplace",
      "category": "Shopping",
      "currency": "USD",
      "developer": "Vinted Limited",
      "app_store_link": "https://apps.apple.com/us/app/vinted-pre-loved-marketplace/id632064380"
    },
    {
      "rank": 3,
      "price": 0,
      "app_id": "6760173601",
      "app_name": "Muse from Meta",
      "category": "Productivity",
      "currency": "USD",
      "developer": "Meta Platforms, Inc.",
      "app_store_link": "https://apps.apple.com/us/app/muse-from-meta/id6760173601"
    }
  ],
  "chart": "top_free",
  "country": "United States",
  "category": "all apps"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"apps.apple.com/list_top_charts","input":{"chart":"top_free","device":"iphone","country":"United States","category":"all apps","max_results":50}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What are the top 20 free iPhone apps in the United States right now?
- Show me the top paid iPad games in the UK chart with developer and price.
- Which business apps rank highest on the free iPhone chart in Germany?
- Can you list the top 50 health and fitness apps on Apple's App Store for Canada, with app IDs?
- Give me the current top grossing paid apps for iPad in Japan, ranked, limited to 10 results.

## Input schema

```json
{
  "type": "object",
  "properties": {
    "chart": {
      "enum": [
        "top_free",
        "top_paid"
      ],
      "type": "string",
      "default": "top_free",
      "description": "Chart to list, for example top_free."
    },
    "device": {
      "enum": [
        "iphone",
        "ipad"
      ],
      "type": "string",
      "default": "iphone",
      "description": "Device chart, for example iphone."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter country code, for example United States or gb."
    },
    "category": {
      "type": "string",
      "default": "all apps",
      "description": "Chart category in words, for example games, business, or health and fitness."
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of ranked positions to read (up to 200)."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "chart",
    "category",
    "country",
    "apps"
  ],
  "properties": {
    "apps": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "app_name",
          "app_store_link",
          "app_id"
        ],
        "properties": {
          "rank": {
            "type": "integer"
          },
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "app_id": {
            "type": "string"
          },
          "app_name": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "developer": {
            "type": [
              "string",
              "null"
            ]
          },
          "app_store_link": {
            "type": "string"
          }
        }
      }
    },
    "chart": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "category": {
      "type": "string"
    }
  }
}
```

## See more

- [Apple API: List top charts](https://fous.com/methods/music.apple.com/list-top-charts.md): Lists the current top songs, albums, or music videos on Apple Music for a country, in chart order. Countries without an Apple Music chart return no results.
- [Apple API: List top podcasts](https://fous.com/methods/podcasts.apple.com/list-top-podcasts.md): Lists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes.
- [Apple API: Search apps](https://fous.com/methods/apps.apple.com/search-apps.md): Finds iPhone and iPad apps by keyword in a chosen country's App Store, with ratings, prices, categories and App Store links.
- [Apple API: Get app reviews](https://fous.com/methods/apps.apple.com/get-app-reviews.md): Gets customer reviews for an iPhone or iPad app, found by name or App Store link, from the selected country's App Store.
- [Apple API: Get App Store app](https://fous.com/methods/apps.apple.com/get-app.md): Gets an iPhone or iPad app's public App Store listing by name or link. You can narrow it by developer and country. In-app purchases are included when the page lists them.
- [Apple API: Search podcasts](https://fous.com/methods/podcasts.apple.com/search-podcasts.md): Finds Apple Podcasts shows by name or topic in a country, ordered by search relevance, with ratings when the show page provides them.
- [Apple API: Get podcast reviews](https://fous.com/methods/podcasts.apple.com/get-podcast-reviews.md): Gets a podcast's country-specific rating total and average, plus up to 500 listener reviews sorted by newest or most helpful.
- [Apple API: Get Apple Store product prices](https://fous.com/methods/apple.com/get-product-prices.md): Gets current Apple Store prices and the configurations on sale for a product in one country. It includes only models sold on that country's public store.
- [All Apple methods](https://fous.com/methods/apple.com.md)