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
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

{
  "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
• App ranking tracker: top paid games, UK App Store
• Top grossing apps in Japan: App Store chart

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.

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
• Guide with the Python and JavaScript code: https://voidd0.github.io/app-store-top-charts/