App Store Search API

/search?engine=app_store API endpoint allows you to scrape the results from 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 anything that you would use in a regular App Store search.

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 attribute of an app. For example, it allows searching the developer title of an app with developer

Serpapi Parameters

engine

Required

Set parameter to 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 (default) to use a Mac App Store, tablet to use a iPad App Store, or mobile 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.

API Examples

App Store search results for q: Coffee, and count: 2

App Store search results for q: Coffee, and count: 2

JSON Example

{
  "search_metadata": {
    "id": "612e7906e7d08a2d1ae1f124",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/f1a5eedceac68e62/612e7906e7d08a2d1ae1f124.json",
    "created_at": "2021-08-31 18:46:30 UTC",
    "processed_at": "2021-08-31 18:46:30 UTC",
    "app_store_url": "https://itunes.apple.com/search?media=software&term=Coffee&country=us&lang=en-us&entity=macSoftware&limit=3",
    "raw_html_file": "https://serpapi.com/searches/f1a5eedceac68e62/612e7906e7d08a2d1ae1f124.html",
    "prettify_html_file": "https://serpapi.com/searches/f1a5eedceac68e62/612e7906e7d08a2d1ae1f124.prettify",
    "total_time_taken": 0.52
  },
  "search_parameters": {
    "engine": "app_store",
    "term": "Coffee",
    "country": "us",
    "lang": "en-us",
    "device": "desktop",
    "count": "2"
  },
  "search_information": {
    "organic_results_state": "Results for exact spelling",
    "results_count": 2
  },
  "organic_results": [
    {
      "position": 1,
      "title": "Coffee Buzz",
      "id": 1099454186,
      "link": "https://apps.apple.com/us/app/id1099454186",
      "bundle_id": "com.aaronpantling.CoffeeBuzz",
      "version": "2.0",
      "vpp_license": true,
      "age_rating": "4+",
      "release_note": "Say hello to the biggest update of Coffee Buzz ever!  Version 2.0 features tons of small quality-of-life upgrades and several new major features, including: • Configuring Coffee Buzz to open at login is now as simple as a click. • The window can transform into an all-new Mini Window that floats above other windows on your desktop. • You can now watch the timer right in the status bar icon.  (requires macOS Mojave or higher) • The last three timers you started are now saved for quick access. • The Rules feature has been completely reworked:      ◦ Create as many rules of a kind as you like, and remove ones you don't need.      ◦ You can now set rules to start a timer if you don't want an immediate response.      ◦ All existing categories are still available, and a new category has been added: Other App.      ◦ Don't worry, your existing settings will be seamlessly migrated.",
      "seller_link": "https://coffeebuzz.aaronpantling.com/appstore-redirect/",
      "minimum_os_version": "10.13.6",
      "description": "Ever wanted to temporarily keep your Mac from starting its screen saver or going to sleep? Sure, you could change your Energy Saver settings, but isn't there a more convenient way? Well, now there is! Coffee Buzz is the easiest and safest display-sleep preventer available. With simple operation and exclusive Safety Auto-Shutoff feature, keeping your Mac awake (and letting it sleep again) is now as simple as a click! Features include: • Three easy-to-use settings: ◦ Buzz mode: blocks all system and display sleep, and prevents the display from dimming ◦ Doze mode: allows the display to sleep, but macOS stays responsive and active in the background ◦ Off: provides a convenient way to disable sleep effects without having to quit and reopen Coffee Buzz • Control from the status bar, two convenient sizes of app window, or the Dock icon • Timer with multiple convenient presets and custom settings • Set rules to automatically control Coffee Buzz: ◦ At startup ◦ When you connect or disconnect the power adapter (on a portable Mac) ◦ When the low-battery warning appears (on a portable Mac) ◦ Based on the other apps you use • Exclusive Safety Auto-Shutoff rule designed to reduce the chance of accidental display damage or burn-in. While not intended to be a substitute for responsibility and careful use, Safety Auto-Shutoff can keep a mistake from turning into an expensive headache. Note: This app cannot prevent your Mac from sleeping if you use the Sleep menu command or close the screen on a portable Mac. This used to be possible years ago, but macOS no longer allows applications of any type to block the user's direct commands to enter sleep. Comments, questions, and feedback are always welcome. Please visit Coffee Buzz Support using the links on this page for more information.",
      "release_date": {
        "date": "2016-04-14",
        "time": "22:17:38",
        "zone": "UTC+0"
      },
      "price": {
        "type": "Free"
      },
      "rating": [
        {
          "type": "All Times",
          "rating": 0,
          "count": 0
        }
      ],
      "genres": [
        {
          "name": "Utilities",
          "id": 6002,
          "primary": true
        },
        {
          "name": "Productivity",
          "id": 6007,
          "primary": false
        }
      ],
      "developer": {
        "name": "Aaron Pantling",
        "id": 1020889000,
        "link": "https://apps.apple.com/us/developer/id1020889000"
      },
      "size": {
        "bytes": 4339221,
        "kilobytes": 4237.5205078125,
        "megabytes": 4.1382036209106445,
        "gigabytes": 0.004041214473545551
      },
      "supported_languages": [
        "EN",
        "ES"
      ],
      "screenshots": {
        "general": [
          {
            "link": "https://is4-ssl.mzstatic.com/image/thumb/Purple123/v4/da/51/9b/da519beb-77c4-67fc-5806-11733f634ac1/mzl.lzdudsbm.png/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is5-ssl.mzstatic.com/image/thumb/PurpleSource113/v4/f7/d4/ed/f7d4edc2-070b-c319-a940-800b1b06d959/0459bbc1-c8ba-42df-b58b-9fa93dbdc263_2.jpeg/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource113/v4/c6/c5/59/c6c5599c-dfaf-de3d-9e04-38f380f0aac2/8f6ac697-c466-4e4a-854d-0dc2e3a288d4_3.jpeg/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is3-ssl.mzstatic.com/image/thumb/PurpleSource123/v4/81/f8/05/81f805c7-b9db-7fd4-ab82-03798c593573/c7675a3c-9403-4a2d-99f8-9c4db2d0a029_4.jpeg/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource113/v4/3f/be/96/3fbe96b2-feec-f93d-4fa9-cb52024547cb/361e4346-81fe-4228-8ae5-6f4affa852ba_6.jpeg/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource113/v4/ae/d6/90/aed690e0-2149-2ab8-3d37-2053bc908197/8f623dfd-bcbd-46e3-baa3-143ac56632ca_5.jpeg/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is3-ssl.mzstatic.com/image/thumb/PurpleSource123/v4/f3/fc/e2/f3fce2f3-bf4e-e829-0de3-f5884f1167db/f3205fd3-327f-4b07-b0b4-7c4b1db1fe54_7.jpeg/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is2-ssl.mzstatic.com/image/thumb/PurpleSource113/v4/6a/63/5b/6a635b11-379a-d14c-4eab-bbc6488bfee4/42577a9c-6ceb-4a51-8a76-d90fed482d01_8.jpg/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is2-ssl.mzstatic.com/image/thumb/PurpleSource123/v4/8c/ac/c0/8cacc031-f72f-de99-6a2f-e144dc14a2f7/eb18519e-b981-4f9e-b0c3-722696ab8f2c_Logo.jpg/800x500bb.jpg",
            "size": "800x500"
          }
        ]
      },
      "logos": [
        {
          "size": "60x60",
          "link": "https://is4-ssl.mzstatic.com/image/thumb/Purple123/v4/e2/12/ae/e212ae6a-71b1-5e79-429e-3e0de888f3cb/source/60x60bb.png"
        },
        {
          "size": "512x512",
          "link": "https://is4-ssl.mzstatic.com/image/thumb/Purple123/v4/e2/12/ae/e212ae6a-71b1-5e79-429e-3e0de888f3cb/source/512x512bb.png"
        },
        {
          "size": "100x100",
          "link": "https://is4-ssl.mzstatic.com/image/thumb/Purple123/v4/e2/12/ae/e212ae6a-71b1-5e79-429e-3e0de888f3cb/source/100x100bb.png"
        }
      ]
    },
    {
      "position": 2,
      "title": "Sleep Control Centre",
      "id": 946798523,
      "link": "https://apps.apple.com/us/app/id946798523",
      "bundle_id": "com.3bitlab.AntiSleep",
      "version": "2.19",
      "vpp_license": true,
      "age_rating": "4+",
      "release_note": "minor bug fixes and improvements",
      "seller_link": "https://prevent-mac-from-sleeping.3bitlab.com",
      "minimum_os_version": "10.11",
      "description": "Keep Awake : ● System ● Display and External Displays ● Wi-Fi Network ● Audio In - Out ● Disks and External Storages ● Other External Media ● Bluetooth Timers: ● Deactivate ● System Sleep ● Display Sleep ● Display Fade ● Deactivate ● Emulation of Mouse Movements Triggers: ● Connect/Disconnect AC Power ● Connect/Disconnect WiFi ● Connect/Disconnect External Display ● Connect/Disconnect External Storage ● Critical Battery Charge ● Close Lid Manual Actions: ● System Sleep ● Display Sleep ● Screensaver ● Fade ● Lock Screen Other: ● Silent Mode ● Apple Script Support ● Emulation of Mouse Movements ● One Click Activation",
      "release_date": {
        "date": "2014-12-05",
        "time": "17:35:44",
        "zone": "UTC+0"
      },
      "price": {
        "type": "Free"
      },
      "rating": [
        {
          "type": "All Times",
          "rating": 0,
          "count": 0
        }
      ],
      "genres": [
        {
          "name": "Utilities",
          "id": 6002,
          "primary": true
        },
        {
          "name": "Productivity",
          "id": 6007,
          "primary": false
        }
      ],
      "developer": {
        "name": "Pavlo Liashenko",
        "id": 929960913,
        "link": "https://apps.apple.com/us/developer/id929960913"
      },
      "size": {
        "bytes": 1390879,
        "kilobytes": 1358.2802734375,
        "megabytes": 1.3264455795288086,
        "gigabytes": 0.0012953570112586021
      },
      "supported_languages": [
        "EN"
      ],
      "screenshots": {
        "general": [
          {
            "link": "https://is4-ssl.mzstatic.com/image/thumb/Purple113/v4/f4/70/f1/f470f1ad-f728-5687-e069-d9839f0fd77b/pr_source.png/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is5-ssl.mzstatic.com/image/thumb/Purple123/v4/f3/09/d6/f309d66e-118f-0613-9211-efadecf51cf6/pr_source.png/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/Purple123/v4/78/80/7e/78807e9f-37eb-c461-a69d-48651c8c4f0a/pr_source.png/800x500bb.jpg",
            "size": "800x500"
          }
        ]
      },
      "logos": [
        {
          "size": "60x60",
          "link": "https://is2-ssl.mzstatic.com/image/thumb/Purple115/v4/5e/23/1b/5e231b8c-573d-e22a-b54a-457d44517581/source/60x60bb.png"
        },
        {
          "size": "512x512",
          "link": "https://is2-ssl.mzstatic.com/image/thumb/Purple115/v4/5e/23/1b/5e231b8c-573d-e22a-b54a-457d44517581/source/512x512bb.png"
        },
        {
          "size": "100x100",
          "link": "https://is2-ssl.mzstatic.com/image/thumb/Purple115/v4/5e/23/1b/5e231b8c-573d-e22a-b54a-457d44517581/source/100x100bb.png"
        }
      ]
    },
  }
}

API Examples with an Advanced Parameter

App Store search results for q: Coffeecount: 1, and attribute: developer

App Store search results for q: Coffee, count: 1, and attribute: developer

JSON Example

{
  "search_metadata": {
    "id": "612ed737e7d08a76bcad21eb",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/8fe8885940433be5/612ed737e7d08a76bcad21eb.json",
    "created_at": "2021-09-01 01:28:23 UTC",
    "processed_at": "2021-09-01 01:28:23 UTC",
    "app_store_url": "https://itunes.apple.com/search?media=software&term=Coffee&country=us&lang=en-us&entity=macSoftware&attribute=softwareDeveloper&limit=1",
    "raw_html_file": "https://serpapi.com/searches/8fe8885940433be5/612ed737e7d08a76bcad21eb.html",
    "prettify_html_file": "https://serpapi.com/searches/8fe8885940433be5/612ed737e7d08a76bcad21eb.prettify",
    "total_time_taken": 0.44
  },
  "search_parameters": {
    "engine": "app_store",
    "term": "Coffee",
    "country": "us",
    "lang": "en-us",
    "device": "desktop",
    "property": "developer",
    "count": "1"
  },
  "search_information": {
    "organic_results_state": "Results for exact spelling",
    "results_count": 1
  },
  "organic_results": [
    {
      "position": 1,
      "title": "VideoCollage",
      "id": 960693998,
      "link": "https://apps.apple.com/us/app/id960693998",
      "bundle_id": "com.bitscoffee.PhotoVideoCollage-Mac",
      "version": "2.2",
      "vpp_license": true,
      "age_rating": "4+",
      "release_note": "• New beautiful templates with up to 9 cells! • Native support for the new Apple Silicone Macs • Updated for macOS Big Sur • Border no longer covers the image • Additional improvements & bug-fixes",
      "seller_link": "http://photovideocollage.com/",
      "minimum_os_version": "10.13",
      "description": "Create beautiful and engaging video collages with your memories and favorite music. Impress your friends and family with your awesome collages that contain not only photos but also video clips, and music! VideoCollage is not your classic photo collage, it's a video collage app that can add photos and music into the mix. "VideoCollage brings the classic photo collage to the next level. Not only can users add photos but also videos, and mix the soundtracks with their favorite music." — CreativeBloq Here's what you get for free: • Create collages from your photos, videos, and music; • Choose from multiple layouts for your collage design (38 layouts are free); • [New] Dark theme mode, that switches automatically with your macOS theme! • 4K resolution for video & photo collages; • 7 aspect ratios for all collage layouts (including 16:9, 16:10, 4:3) • Edit videos by choosing which segment of the video to play; • Simply drag & drop to rearrange the photos & videos inside the layout; • Drag & drop photos & videos directly from the Photos app or from Finder; • Add Text to your collages, with customizable font, size, color and placement; • You can have no frame around the videos, or a frame of specified size and with curved edges; • Set a color or texture for your frame, from a collection of handpicked designs (all colors and 18 textures are free); • Add background music and select the starting position for your song; • Mix the soundtracks (like a DJ) with individual volume controls for each video and for the selected song; • The option to play the videos from inside the video college simultaneously or sequentially; • Fade-in/out audio effect for the resulting video collage. Additionally, you can upgrade to Pro (for just $9.99) and get: • Remove the "Bits&Coffee VideoCollage" watermark from the resulting video collage; • All layout templates (70+) for your video collage; • All textures from the handpicked collection; • The option to select a custom texture for your layout. Now what're you waiting for? This is a Free app so go get it!",
      "release_date": {
        "date": "2015-02-12",
        "time": "21:31:26",
        "zone": "UTC+0"
      },
      "price": {
        "type": "Free"
      },
      "rating": [
        {
          "type": "All Times",
          "rating": 0,
          "count": 0
        }
      ],
      "genres": [
        {
          "name": "Photo & Video",
          "id": 6008,
          "primary": true
        }
      ],
      "developer": {
        "name": "Bits&Coffee",
        "id": 584369640,
        "link": "https://apps.apple.com/us/developer/id584369640"
      },
      "size": {
        "bytes": 9239271,
        "kilobytes": 9022.7255859375,
        "megabytes": 8.81125545501709,
        "gigabytes": 0.008604741655290127
      },
      "supported_languages": [
        "EN"
      ],
      "screenshots": {
        "general": [
          {
            "link": "https://is3-ssl.mzstatic.com/image/thumb/Purple118/v4/95/66/53/95665356-446c-a53c-842b-adc314b5a8d1/pr_source.png/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is4-ssl.mzstatic.com/image/thumb/Purple118/v4/6f/b5/0d/6fb50de6-5d42-6ff3-8536-a0539b5eed73/pr_source.png/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is4-ssl.mzstatic.com/image/thumb/Purple118/v4/57/9d/41/579d41f9-3446-86d6-e293-60ba579f8edc/pr_source.png/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is3-ssl.mzstatic.com/image/thumb/Purple128/v4/f2/d8/b4/f2d8b479-caa2-ecaf-87a7-fb9805a6f38f/pr_source.png/800x500bb.jpg",
            "size": "800x500"
          },
          {
            "link": "https://is2-ssl.mzstatic.com/image/thumb/Purple128/v4/f4/1a/66/f41a66a4-60b8-e52d-8d6e-fc48f16cf39b/pr_source.png/800x500bb.jpg",
            "size": "800x500"
          }
        ]
      },
      "logos": [
        {
          "size": "60x60",
          "link": "https://is4-ssl.mzstatic.com/image/thumb/Purple125/v4/8d/cc/ab/8dccaba8-d43c-4000-2fa8-d39b1b79709c/source/60x60bb.png"
        },
        {
          "size": "512x512",
          "link": "https://is4-ssl.mzstatic.com/image/thumb/Purple125/v4/8d/cc/ab/8dccaba8-d43c-4000-2fa8-d39b1b79709c/source/512x512bb.png"
        },
        {
          "size": "100x100",
          "link": "https://is4-ssl.mzstatic.com/image/thumb/Purple125/v4/8d/cc/ab/8dccaba8-d43c-4000-2fa8-d39b1b79709c/source/100x100bb.png"
        }
      ]
    }
  ],
  "serpapi_pagination": {
    "next": "https://serpapi.com/search.json?count=1&country=us&device=desktop&engine=app_store&lang=en-us&page=1&property=developer&term=Coffee"
  }
}