Home › Actors › Apple App Store reviews and ratings by country › Data and schema
This is the machine-readable side of Apple App Store reviews and ratings by country: the columns its dataset contains, taken from a real sample run of 9 rows and 36 columns. Fill rate counts how many of the 9 sample rows have a value. Contact fields are withheld here.
| column | type | filled | example |
|---|---|---|---|
| type | text | 9/9 | app |
| appId | integer | 9/9 | 324684580 |
| appName | text | 9/9 | Spotify: Music and Podcasts |
| country | text | 9/9 | us |
| bundleId | text | 1/9 | com.spotify.client |
| developer | text | 1/9 | Spotify |
| developerId | integer | 1/9 | 324684583 |
| genre | text | 1/9 | Music |
| genres | list (JSON array) | 1/9 | ["Music", "Entertainment"] |
| price | integer | 1/9 | 0 |
| currency | text | 1/9 | USD |
| formattedPrice | text | 1/9 | Free |
| ratingAverage | number | 1/9 | 4.77 |
| ratingCount | integer | 1/9 | 42505656 |
| ratingAverageCurrentVersion | number | 1/9 | 4.77 |
| ratingCountCurrentVersion | integer | 1/9 | 42505656 |
| version | text | 1/9 | 9.1.90 |
| currentVersionReleaseDate | date/time (ISO) | 1/9 | 2026-10-08T07:37:17Z |
| releaseDate | date/time (ISO) | 1/9 | 2011-07-14T11:22:37Z |
| releaseNotes | text | 1/9 | We’re always making changes and improvements to ... |
| sizeBytes | integer | 1/9 | 308086784 |
| sizeMB | number | 1/9 | 293.8 |
| contentRating | text | 1/9 | 12+ |
| minimumOsVersion | number | 1/9 | 16.1 |
| languages | list (JSON array) | 1/9 | ["AF", "AM", "AR", "AZ", "EU", "BN", "BS", "BG",... |
| description | text | 1/9 | With the Spotify app, you can explore an extensi... |
| iconUrl | text | 1/9 | https://is1-ssl.mzstatic.com/image/thumb/Purple2... |
| sellerUrl | text | 1/9 | https://www.spotify.com/ |
| url | text | 9/9 | https://apps.apple.com/us/app/spotify-music-and-... |
| reviewId | integer | 8/9 | 11994640656 |
| title | text | 8/9 | Favorite app ever |
| text | text | 8/9 | I personally love this app. I have had it for ov... |
| rating | integer | 8/9 | 5 |
| date | date/time (ISO) | 8/9 | 2024-11-26T17:10:59.000Z |
| voteSum | integer | 8/9 | 0 |
| voteCount | integer | 8/9 | 0 |
| type | appId | appName | country | bundleId | developer | developerId | genre |
|---|---|---|---|---|---|---|---|
| app | 324684580 | Spotify: Music and Podcasts | us | com.spotify.client | Spotify | 324684583 | Music |
| review | 324684580 | Spotify: Music and Podcasts | us | ||||
| review | 324684580 | Spotify: Music and Podcasts | us | ||||
| review | 324684580 | Spotify: Music and Podcasts | us | ||||
| review | 324684580 | Spotify: Music and Podcasts | us |
Download the full sample CSV (raw file on GitHub). Long values are shortened above.
From the actor's current input schema on Apify.
| field | type | label | default |
|---|---|---|---|
| appIds | array | App IDs or App Store URLs | |
| startUrls | array | Start URLs (App Store links) | |
| searchTerms | array | Search terms (optional) | |
| countries | array | Countries (App Store storefronts) | ["us"] |
| country | string | Single country (shortcut) | |
| maxReviewsPerApp | integer | Max reviews per app and country | 100 |
| maxItems | integer | Max items in total | |
| sortBy | string | Sort order | "mostrecent" |
| searchResultsPerTerm | integer | Apps per search term | 1 |
| sinceDate | string | Only reviews since | |
| minRating | integer | Minimum star rating | 1 |
| maxRating | integer | Maximum star rating | 5 |
| includeAppDetails | boolean | Include app details row | true |
| deltaMode | boolean | Delta mode (only new reviews) | false |
| stateKey | string | Delta state name | |
| maxApps | integer | Max apps | 50 |
$0.0005 per review returned (pay per event). Read from the Apify actor record on 2026-10-14; the live price on the actor page always wins.
Successful builds of the published actor, newest first (27 builds in total). Apify records build numbers and dates, not release notes, so this lists what shipped and when.
Run it on Apify About this actor
Disclosure: we build and maintain this actor.
This actor
Comparison
Guides with real sample rows from this actor
Some links are affiliate links.