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

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

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"
    },
    ...
  ]
}