Apple App Store Search Scraper API

/search?engine=apple_app_store API endpoint allows you to scrape the results from the Apple App Store search engine via our SerpApi service. Head to the playground for a live and interactive demo.

Search Query

term

Required

Parameter defines the query you want to search. You can use any search term that you would use in a regular App Store search. (e.g. Coffee (default) search term)

Localization

country

Optional

Parameter defines the country to use for the search. It's a two-letter country code. (e.g., us (default) for the United States, uk for United Kingdom, or fr for France). Head to the Apple Regions for a full list of supported Apple Regions

lang

Optional

Parameter defines the language to use for the search. It's a four-letter country code. (e.g., en-us (default) for the English, fr-fr for French, or uk-ua for Ukranian). Head to the Apple Languages for a full list of supported Apple Languages

Pagination

num

Optional

Parameter defines the number of results you want to get per each page. It defaults to 10. Maximum number of results you can get per page is 200. Any number greater than maximum number will default to 200.

page

Optional

Parameter is used to get the items on a specific page. (e.g., 0 (default) is the first page of results, 1 is the 2nd page of results, 2 is the 3rd page of results, etc.).

Advanced Parameters

disallow_explicit

Optional

Parameter defines the filter for disallowing explicit apps. It defaults to false.

property

Optional

Parameter allows to search the property of an app.
developer allows searching the developer title of an app ( e.g.,  property=developer and  term=Coffee gives apps with "Coffee" in their developer's name within desktop (default) apps. )

Serpapi Parameters

engine

Required

Set parameter to apple_app_store to use the App Store API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the App Store Search results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

device

Optional

Parameter defines the device to use to get the results. It can be set to desktop to use a Mac App Store, tablet to use a iPad App Store, or mobile (default) to use a iPhone App Store

API Results

JSON Results

JSON output includes structured data for reviews results.

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, the error will contain an error message. search_metadata.id is the search ID inside SerpApi.

HTML Results

This API does not have the HTML response, just a text. search_metadata.prettify_html_file contains prettified version of the result. It is displayed in the playground.

JSON structure overview

{
  ...
  "organic_results": [
    {
      "position": "Integer, Position of the App in App Store. (Ex. 1)",
      "id": "Integer, Unique identifying number for the app. (Ex. 1339438881)",
      "title": "String, Title of the app. (Ex. COFE)",
      "bundle_id": "String, Unique identifier string of the app. Usually reversed version of their website. (Ex. com.mawaqaa.cofe)",
      "version": "String, Version Number of the app. (Ex. 6.4.6)",
      "vpp_license": "Boolean, Apple VPP (Volume Purchase Program) License. It allows bussinesses to buy large sums of the same app. (Ex. true)",
      "age_rating": "String, Age Rating. (Ex. 7+)",
      "release_note": "String, Latest release note from developer/(s). (Ex. We have fixed latest bugs.)",
      "minimum_os_version": "String, Minimum OS version. (Ex. 12.0)",
      "description": "String, description of the app. (Ex. This app brings coffee lovers together.)",
      "game_center_enabled": "Boolean, Apple Game Center availability. It lets users play with other friends on the platform with their identity. (Ex. false)",
      "link": "String, Product page of the app. (Ex. https://apps.apple.com/us/app/id61889819e7d08a1d5c5ea6d4)",
      "release_date": "String, Release Date of the app (Ex. 2018-02-06 04:02:02 UTC)",
      "price": {
        "type": "String, Price Type of the Product. Could be 'Free', 'Paid', or 'Free Trial'.",
        "amount": "Integer or Float, Price amount of the app. Only exists if it is a paid app. (Ex. 4.99)",
        "currency": "String, Three letter abbreviation of the currency. (Ex. USD)",
        "symbol": "String, Symbol of the currency (Ex. $)"
      },
      "rating": [
        {
          "type": "String, Type of the rating. It could be for all times, or from the latest update etc. (Ex. All Times)",
          "rating": "Float, Average rating of the app. (Ex. 4.6)",
          "count": "Integer, Total rating count. (Ex. 5016)"
        }
      ],
      "genres": [
        {
          "name": "String, Genre of the app. (Ex. Food and Drink)",
          "id": "Integer, Unique identifying number of the genre. (Ex. 6023)",
          "primary": "Boolean, If the genre is primary genre of the app or not. (Ex. true)"
        },
        ...
      ],
      "developer": {
        "name": "String, Developer Name. (Ex. Cofe District)",
        "id": "Integer, Unique identifying number of the developer. (Ex. 1291620790)",
        "link": "String, Developer page. (Ex. https://apps.apple.com/us/developer/id1291620790)"
      },
      "size_in_bytes": "Integer, Size of the app in bytes. (Ex. 80698368)",
      "supported_languages": [
        "String, Two letter abbreviation of the supported language. (Ex. EN)",
        ...
      ],
      "screenshots": {
        "screenshot type, 'general' stands for default set of screenshots, 'iphone_screenshots' stands for iPhone screenshots etc.": [
          {
            "link": "String, Link of the image. (Ex. https://is5-ssl.mzstatic.com/image/thumb/PurpleSource125/v4/be/90/c5/be90c518-44d1-bb50-38a2-6ff68d61f7f1/fe82090c-7953-483b-9d69-89a7e13c14a2_5.5-Inch_1st.jpg/392x696bb.jpg)",
            "size": "String, Size of the image. (Ex. 392x696)"
          },
          ...
        ]
      },
      "logos": [
        {
          "size": "String, Size of the logo. (Ex. 60x60)",
          "link": "String, Link of the logo. (Ex. https://is5-ssl.mzstatic.com/image/thumb/Purple116/v4/39/4a/a4/394aa4f8-fd68-2bfb-6619-2a38abfebf4b/source/60x60bb.jpg)"
        },
        ...
      ],
      "features": [
        "String, Supported feature. (Ex. iosUniversal)"
      ],
      "advisories": [
        "String, Advisory text. (Ex. Infrequent/Mild Cartoon or Fantasy Violence)"
      ],
      "supported_devices": [
        "String, Supported device. (Ex. iPhone5s)",
        ...
      ]
    },
  ],
  ...
}

API Examples

Apple App Store search results for term: Coffee

Apple App Store search results for term: Coffee

JSON Example

{
  "search_metadata": {
    "id": "61889819e7d08a1d5c5ea6d4",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/6506881f8e671fb0/61889819e7d08a1d5c5ea6d4.json",
    "created_at": "2021-11-08 03:23:05 UTC",
    "processed_at": "2021-11-08 03:23:05 UTC",
    "app_store_url": "https://itunes.apple.com/search?media=software&term=Coffee&country=us&lang=en-us&explicit=yes&offset=0",
    "raw_html_file": "https://serpapi.com/searches/6506881f8e671fb0/61889819e7d08a1d5c5ea6d4.html",
    "prettify_html_file": "https://serpapi.com/searches/6506881f8e671fb0/61889819e7d08a1d5c5ea6d4.prettify",
    "total_time_taken": 4.72
  },
  "search_parameters": {
    "engine": "apple_app_store",
    "term": "Coffee",
    "country": "us",
    "lang": "en-us",
    "device": "mobile",
    "num": "10",
    "page": "0"
  },
  "search_information": {
    "organic_results_state": "Results for exact spelling",
    "results_count": 50
  },
  "organic_results": [
    {
      "position": 1,
      "id": 1339438881,
      "title": "COFE",
      "bundle_id": "com.mawaqaa.cofe",
      "version": "6.4.6",
      "vpp_license": true,
      "age_rating": "4+",
      "release_note": "We have brewed some performance updates and ground away bugs to make your ordering experience that much better with us!",
      "minimum_os_version": "12.0",
      "description": "COFE From international franchises to local artisanal brands, find all your favorite coffee brands in one app. COFE offers you smart ordering options from delivery and pick up to catering for larger groups. In addition to ready-to-consume beverages, COFE also offers various other coffee related products, in selected locations, like coffee beans, machines and accessories. COFE currently serves coffee lovers across Kuwait, the Kingdom of Saudi Arabia, the United Arab Emirates and Turkey. The app uses your location to show you closest coffee shops, offers in-app credit options, and exciting multi-brand promotions. The COFE app is as much a convenience tool as it is a lifestyle app. It doesn't just make your daily coffee easier to access, it completely changes the way you consume your favourite beverage. - COFE On-the-Go: Our COFE delivery option (available only in Kuwait) allows you to pick your preferred beverage from any of your favourite coffee shops. Your order is delivered to you at the perfect temperature, and you can add multiple addresses to your account. - Get COFE: Skip the line with our COFE concierge service. Place your order using the app and get the coffee shop closest to you - to get you your coffee of choice. - COFE Gathering: Be it office meetings, a family get-together, an evening in with your friends or any other event, COFE and delicious bites go a long way. Use the COFE Gathering option in the app, and choose from the multitude of brands, especially customised to suit your needs. From the number of guests to the kind of Barista, we can match your request. - COFE Credit: For convenient contactless payment, upload COFE Credit into your account and use it to pay for your orders. - COFE Sweeteners: Look out for regular promotions, contests, cash prizes and freebies and make the most from of your COFE App experience. Multiple Payment Options: Use your pre-loaded COFE Credit (recommended), use your credit/debit card or opt for cash-on-delivery. We offer our users multiple payment options to make getting COFE as convenient as possible. - Map View: COFE app understands that sometimes you need your coffee and you need it now! This is why the app shows you your closest coffee shops first, so that you can pick your closest neighbourhood Barista for a quick caffeine fix. Alternatively, you can also view and choose from the extensive list of brands present on the app.",
      "game_center_enabled": false,
      "link": "https://apps.apple.com/us/app/id61889819e7d08a1d5c5ea6d4",
      "release_date": "2018-02-06 04:02:02 UTC",
      "price": {
        "type": "Free"
      },
      "rating": [
        {
          "type": "All Times",
          "rating": 4.6,
          "count": 5016
        }
      ],
      "genres": [
        {
          "name": "Food & Drink",
          "id": 6023,
          "primary": true
        },
        ...
      ],
      "developer": {
        "name": "Cofe District",
        "id": 1291620790,
        "link": "https://apps.apple.com/us/developer/id1291620790"
      },
      "size_in_bytes": 80698368,
      "supported_languages": [
        "AR",
        ...
      ],
      "screenshots": {
        "general": [
          {
            "link": "https://is5-ssl.mzstatic.com/image/thumb/PurpleSource125/v4/be/90/c5/be90c518-44d1-bb50-38a2-6ff68d61f7f1/fe82090c-7953-483b-9d69-89a7e13c14a2_5.5-Inch_1st.jpg/392x696bb.jpg",
            "size": "392x696"
          },
          ...
        ]
      },
      "logos": [
        {
          "size": "60x60",
          "link": "https://is5-ssl.mzstatic.com/image/thumb/Purple116/v4/39/4a/a4/394aa4f8-fd68-2bfb-6619-2a38abfebf4b/source/60x60bb.jpg"
        },
        ...
      ],
      "supported_devices": [
        "iPhone5s",
        "iPadAir",
        ...
      ]
    },
    ...
  ],
  "serpapi_pagination": {
    "current": "https://serpapi.com/search.json?country=us&device=mobile&engine=apple_app_store&lang=en-us&num=10&page=0&term=Coffee",
    "next": "https://serpapi.com/search.json?country=us&device=mobile&engine=apple_app_store&lang=en-us&num=10&page=1&term=Coffee"
  }
}

API Examples with an Advanced Parameter

Apple App Store search results for term: Nianticand property: developer

Apple App Store search results for term: Nianticand property: developer

JSON Example

{
  "search_metadata": {
    "id": "61889d8ee7d08a1d5c5ea6da",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/7821af3278a5c59a/61889d8ee7d08a1d5c5ea6da.json",
    "created_at": "2021-11-08 03:46:22 UTC",
    "processed_at": "2021-11-08 03:46:22 UTC",
    "app_store_url": "https://itunes.apple.com/search?media=software&term=Niantic&country=us&lang=en-us&explicit=yes&offset=0",
    "raw_html_file": "https://serpapi.com/searches/7821af3278a5c59a/61889d8ee7d08a1d5c5ea6da.html",
    "prettify_html_file": "https://serpapi.com/searches/7821af3278a5c59a/61889d8ee7d08a1d5c5ea6da.prettify",
    "total_time_taken": 10.69
  },
  "search_parameters": {
    "engine": "apple_app_store",
    "term": "Niantic",
    "country": "us",
    "lang": "en-us",
    "device": "mobile",
    "num": "10",
    "page": "0"
  },
  "search_information": {
    "organic_results_state": "Results for exact spelling",
    "results_count": 48
  },
  "organic_results": [
    ...
    {
      "position": 4,
      "id": 1094591345,
      "title": "Pokémon GO",
      "bundle_id": "com.nianticlabs.pokemongo",
      "version": "1.189.0",
      "vpp_license": true,
      "age_rating": "9+",
      "release_note": "Trainers, there’s always something new in Pokémon GO! -  From ​​November 5, 2021, to November 14, 2021, celebrate light overcoming darkness with an all-new event, Festival of Lights!-  Visual changes have been added to indicate when either your Pokémon storage or Item Bag is full. The center of the Poké Ball menu icon will turn orange when your Pokémon storage is full and revert to gray when storage space is made available. Also, when you view your Pokémon storage or Item Bag, the total number will appear in red when either is at capacity.",
      "seller_link": "http://pokemongo.nianticlabs.com",
      "minimum_os_version": "12.0",
      "description": "NEW! Now you can battle other Pokémon GO trainers online! Try the GO Battle League today. Join Trainers across the globe who are discovering Pokémon as they explore the world around them. Pokémon GO is the global gaming sensation that has been downloaded over 1 billion times and named “Best Mobile Game” by the Game Developers Choice Awards and “Best App of the Year” by TechCrunch. _______________ UNCOVER THE WORLD OF POKÉMON: Explore and discover Pokémon wherever you are! CATCH more Pokémon to complete your Pokédex! JOURNEY alongside your Buddy Pokémon to help make your Pokémon stronger and earn rewards! COMPETE in epic Gym battles and... TEAM UP and UNITE with other Trainers to catch powerful Pokémon during Raid Battles! It’s time to get moving—your real-life adventures await! Let’s GO! _______________ With the player’s permission, Adventure Sync uses the Health app to enable the player to earn walking distance when the app is closed. Notes: - This app is free-to-play and offers in-game purchases. It is optimized for smartphones, not tablets. - It is recommended to play while connected to a network in order to obtain accurate location information. - Compatibility is not guaranteed for devices without GPS capabilities or devices that are connected only to Wi-Fi networks. - Compatibility information may be changed at any time. - Information current as of July 11, 2019. - Compatible with iPhone® 5s / SE / 6 / 6s / 6 Plus / 6s Plus / 7 / 7 Plus / 8 / 8 Plus / X devices with iOS Version 9 or later installed. - Not compatible with 5th generation iPod Touch devices or iPhone 5c or earlier iPhone devices. - Please visit PokemonGO.com for additional compatibility information. - Compatibility is not guaranteed for all devices. - Continued use of GPS running in the background can dramatically reduce battery life.",
      "game_center_enabled": false,
      "link": "https://apps.apple.com/us/app/id61889d8ee7d08a1d5c5ea6da",
      "release_date": "2016-07-07 00:39:49 UTC",
      "price": {
        "type": "Free"
      },
      "rating": [
        {
          "type": "All Times",
          "rating": 4.02,
          "count": 384615
        }
      ],
      "genres": [
        {
          "name": "Games",
          "id": 6014,
          "primary": true
        },
        ...
      ],
      "developer": {
        "name": "Niantic, Inc.",
        "id": 1037205060,
        "link": "https://apps.apple.com/us/developer/id1037205060"
      },
      "size_in_bytes": 361969664,
      "supported_languages": [
        "CS",
        ...
      ],
      "screenshots": {
        "general": [
          {
            "link": "https://is3-ssl.mzstatic.com/image/thumb/PurpleSource125/v4/98/c5/18/98c518d7-974b-3b9f-ca57-3977b967afe9/0f2e8a67-9127-4efd-88a2-7a3dae0c7d35_EN_S1_iOS_5.5.png/392x696bb.png",
            "size": "392x696"
          },
          ...
        ],
        "ipad": [
          {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/Purple115/v4/b7/79/d6/b779d6f3-981a-07d5-2620-e0b9d10dcd73/pr_source.png/576x768bb.png",
            "size": "576x768"
          },
          ...
        ]
      },
      "logos": [
        {
          "size": "512x512",
          "link": "https://is4-ssl.mzstatic.com/image/thumb/Purple116/v4/a9/f0/fc/a9f0fcb9-9ae6-ad91-d112-833a99903c6a/source/512x512bb.jpg"
        },
        ...
      ],
      "features": [
        "iosUniversal"
      ],
      "advisories": [
        "Infrequent/Mild Cartoon or Fantasy Violence"
      ],
      "supported_devices": [
        "iPhone5s",
        ...
      ]
    },
    ...
  ],
  "serpapi_pagination": {
    "next": "https://serpapi.com/search.json?count=1&country=us&device=desktop&engine=apple_app_store&lang=en-us&page=0&property=developer&term=Coffee",
    "next": "https://serpapi.com/search.json?count=1&country=us&device=desktop&engine=apple_app_store&lang=en-us&page=1&property=developer&term=Coffee"
  }
}