Apple App Store Top Charts API
The Apple App Store Top Charts API returns a JSON format response containing detailed real-time information about top-ranked apps across various categories and countries.
API Parameters
Filters
-
- Name
-
category - Required
- Optional
- Description
-
Filters the top charts by category in the App Store. Default is
all. Check the full list of supported Apple App Store categories.
-
- Name
-
store_device - Required
- Optional
- Description
-
Shows the chart for the specified device in the App Store. Available options are:
-
iphoneDefault ipad
-
-
- Name
-
chart - Required
- Optional
- Description
-
Shows the chart for the specified device in the App Store. Available options are:
-
top_freeDefault top_paid
-
Localization
-
- Name
-
country - Required
- Optional
- Description
-
Two-letter country code (ISO 3166-1 alpha-2), defines the country of the store. The default parameter is
us. Check the full list of supported Apple App Store countries.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. Current engine -
apple_app_store_top_charts.
API Key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Apple App Store Top Charts - Full Response
https://www.searchapi.org/api/v1/search?category=all&chart=top_free&country=us&engine=apple_app_store_top_charts&store_device=iphone
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.org/api/v1/search"
params = {
"engine": "apple_app_store_top_charts",
"country": "us",
"category": "all",
"chart": "top_free",
"store_device": "iphone"
}
response = requests.get(url, params=params)
print(response.text)
{
"top_charts": [
{
"position": 1,
"id": "6448311069",
"title": "ChatGPT",
"description": "The official app by OpenAI",
"link": "https://apps.apple.com/us/app/chatgpt/id6448311069",
"thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/cd/c1/e9/cdc1e9b6-6192-617b-5c05-f7fde17d6978/AppIcon-0-0-1x_U007epad-0-0-0-1-0-85-220.png/100x100ia-75.webp 100w,https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/cd/c1/e9/cdc1e9b6-6192-617b-5c05-f7fde17d6978/AppIcon-0-0-1x_U007epad-0-0-0-1-0-85-220.png/200x200ia-75.webp 200w"
},
{
"position": 2,
"id": "1605170923",
"title": "GoWish - Your Digital Wishlist",
"description": "Create Wishes & Get Inspired",
"link": "https://apps.apple.com/us/app/gowish-your-digital-wishlist/id1605170923",
"thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/b4/25/93/b425932b-bc26-50d3-f3e9-26058248195c/AppIcon-0-0-1x_U007epad-0-1-85-220.png/100x100ia-75.webp 100w,https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/b4/25/93/b425932b-bc26-50d3-f3e9-26058248195c/AppIcon-0-0-1x_U007epad-0-1-85-220.png/200x200ia-75.webp 200w"
},
...
]
}