# App Store Top Charts Scraper data API: fields, sample output and cost per 1,000 rows

Pull all three Apple App Store top charts (paid, grossing, and apps at no cost) for any country and genre.

This is the reference for the Actor `v0iddo/app-store-top-charts`: what is in every output row, what the input takes, and what a run costs. Values below come from a real run of the Actor.

## At a glance

| | |
| --- | --- |
| Actor | `v0iddo/app-store-top-charts` |
| Store page | [App Store Top Charts Scraper](https://apify.com/v0iddo/app-store-top-charts) |
| Output | one row per result, as JSON, CSV, Excel or HTML |
| Fields per row | 21 (17 text, 2 date, 1 URL, 1 number) |
| Cap on results | `limit` in the input |
| Price | $0.10 per 1,000 results |

## Output fields

Each result is one row with these fields (fields that name people are left out):

| Field | Type | Meaning | Sample value |
| --- | --- | --- | --- |
| `snapshotAt` | date | Snapshot At | 2026-10-26T04:24:43+00:00 |
| `chart` | text | Chart | topfreeapplications |
| `country` | text | Country | us |
| `genreId` | text | Genre Id | 0 |
| `rank` | number | Rank | 1 |
| `appId` | text | App Id | 632064380 |
| `trackName` | text | Track Name | Vinted: Pre-loved marketplace |
| `artistName` | text | Artist Name |  |
| `artistUrl` | URL | Artist Url |  |
| `category` | text | Category | Shopping |
| `categoryId` | text | Category Id | 6024 |
| `releaseDate` | date | Release Date | 2013-04-11T10:12:20-07:00 |
| `price` | text |  | 0.00 |
| `currency` | text |  | USD |
| `priceLabel` | text |  | Get |
| `contentType` | text |  | Application |
| `rights` | text |  | © 2024 Vinted |
| `summary` | text |  | The idea is simple: you sell your pre-loved stuff to other members ... |
| `title` | text |  | Vinted: Pre-loved marketplace - Vinted Limited |
| `appUrl` | text |  | https://apps.apple.com/us/app/vinted-pre-loved-marketplace/id632064... |
| `artworkUrl` | text |  | https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/d3/cd/83/d3cd... |

## One record

```json
{
  "snapshotAt": "2026-10-26T04:24:43+00:00",
  "chart": "topfreeapplications",
  "country": "us",
  "genreId": "0",
  "rank": 1,
  "appId": "632064380",
  "trackName": "Vinted: Pre-loved marketplace",
  "category": "Shopping",
  "categoryId": "6024",
  "releaseDate": "2013-04-11T10:12:20-07:00",
  "price": "0.00",
  "currency": "USD",
  "priceLabel": "Get",
  "contentType": "Application",
  "rights": "© 2024 Vinted",
  "summary": "The idea is simple: you sell your pre-loved stuff to other members who’ll love it again. They get the thrill of unboxing a great find, yo...",
  "title": "Vinted: Pre-loved marketplace - Vinted Limited",
  "appUrl": "https://apps.apple.com/us/app/vinted-pre-loved-marketplace/id632064380?uo=2",
  "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/d3/cd/83/d3cd83d1-4d21-6390-1c53-4e1557fdf70d/VintedAppIcon-0-0-1x_U007epad-0-1-85-..."
}
```

## Input parameters

| Parameter | Type | Required | Default | What it does |
| --- | --- | --- | --- | --- |
| `chartTypes` | array | no | ["topfreeapplications"] | Which charts to pull. Valid: topfreeapplications, toppaidapplications, topgrossingapplications. |
| `countries` | array | no | ["us"] | ISO 3166-1 alpha-2 storefront codes. |
| `genreIds` | array | no | ["0"] | Numeric Apple genre IDs. Examples: 0 (all), 6005 (Social Networking), 6014 (Games), 6017 (Education), 6020 (Medical), 6023 (Finance). |
| `limit` | integer | no | 100 | How many apps to pull per (chart × country × genre). |

## Ready-made examples

Saved inputs on Apify: run one as it is, or copy it and change the values.

- [App Store top grossing iPhone apps, US](https://apify.com/v0iddo/app-store-top-charts/examples/app-store-top-grossing-us)
- [App ranking tracker: top paid games, UK App Store](https://apify.com/v0iddo/app-store-top-charts/examples/app-ranking-tracker-top-paid-games-uk)
- [Top grossing apps in Japan: App Store chart](https://apify.com/v0iddo/app-store-top-charts/examples/top-grossing-apps-japan-app-store)

## Cost per 1,000 rows

$0.10 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $0.07 per 1,000.

| Results | Cost at the listed price | Cost at the lowest plan price |
| --- | --- | --- |
| 100 | $0.01 | $0.007 |
| 1,000 | $0.10 | $0.07 |
| 10,000 | $1.00 | $0.70 |
| 100,000 | $10.00 | $7.00 |

The figures are the listed price times the number of results. The `limit` limit and the maximum cost setting in the run options both stop a run before it spends more than you planned.

## Get the rows as CSV over HTTP

One request starts a run, waits for it and returns the dataset. The `format` parameter picks the file type and `fields` picks the columns. Replace the token with the one from Apify Console, Settings, Integrations.

```bash
curl -X POST "https://api.apify.com/v2/acts/v0iddo~app-store-top-charts/run-sync-get-dataset-items?format=csv&fields=snapshotAt,chart,country" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"chartTypes": ["topfreeapplications"], "countries": ["us"], "genreIds": ["0"], "limit": 100}'
```

## Links

- Actor on the Apify Store: [App Store Top Charts Scraper](https://apify.com/v0iddo/app-store-top-charts)
- Guide with the Python and JavaScript code: [https://voidd0.github.io/app-store-top-charts/](https://voidd0.github.io/app-store-top-charts/)