Logo SearchApi

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

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