Apple App Store Top Charts API

Apple App Store Top Charts API uses /api/v1/search?engine=apple_app_store_top_charts API endpoint to scrape real-time results

The Apple App Store Top Charts API returns a JSON format containing detailed 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:
- iphone Default
- ipad
Name

chart

Required

Optional

Description
Shows the chart for the specified device in the App Store. Available options are:
- top_free Default
- 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_key authenticates 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 true to 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

GET

https://www.searchapi.io/api/v1/search?category=all&chart=top_free&country=us&engine=apple_app_store_top_charts&store_device=iphone

Request

import requests

url = "https://www.searchapi.io/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)

Response

{
  "top_charts": [
    {
      "position": 3,
      "id": 6448311069,
      "title": "ChatGPT",
      "subtitle": "The official app by OpenAI",
      "bundle_id": "com.openai.chat",
      "link": "https://apps.apple.com/us/app/chatgpt/id6448311069",
      "searchapi_link": "https://www.searchapi.io/api/v1/search?country=us&engine=apple_product&product_id=6448311069",
      "release_date": "2023-05-18",
      "price": {
        "is_free": true,
        "formatted_price": "$0.00",
        "extracted_price": 0.0,
        "currency": "USD",
        "currency_symbol": "$"
      },
      "rating": 4.9,
      "reviews": 1108383,
      "reviews_histogram": {
        "1": 14516,
        "2": 4526,
        "3": 12685,
        "4": 47685,
        "5": 1028971
      },
      "genres": [
        {
          "id": 6007,
          "name": "Productivity",
          "link": "https://itunes.apple.com/us/genre/id6007"
        },
        ...
      ],
      "developer": {
        "id": 1684349733,
        "name": "OpenAI"
      },
      "size_in_bytes": 76658688,
      "logo": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/96/42/47/964247c0-917a-ebf2-e5d2-0efae5740e3c/AppIcon-0-0-1x_U007emarketing-0-7-0-85-220.png/1024x0w.png",
      "advisory": {
        "age_rating": "12+",
        "categories": [
          "Infrequent/Mild Alcohol, Tobacco, or Drug Use or References"
        ]
      },
      "device_families": ["iphone", "ipad"],
      "has_in_app_purchases": true,
      "capabilities_for_reality_device": "arm64"
    },
    ...
  ]
}