Apple App Store Reviews Scraper API

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

Search Query

product_id

Required

Parameter defines the ID of a product you want to get the reviews for.
You can find the ID of a product from App Store API json results,
You can also get it from the URL of the app. For example
product_id of "https://apps.apple.com/us/app/the-great-coffee-app/id534220544", is the long numerical value that comes after "id", 534220544 (default).

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.

Pagination

page

Optional

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

Advanced Apple Reviews Parameters

sort

Optional

Parameter is used for sorting reviews.

It can be set to:
mostrecent: Most recent (default),
mosthelpful: Most helpful

Serpapi Parameters

engine

Required

Set parameter to apple_reviews to use the Apple Reviews engine.

no_cache

Optional

Parameter will force SerpApi to fetch the Apple Reviews 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.

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

{
  ...
  "reviews": [
    {
      "position": "Integer, Position of the review (Ex: 1)",
      "id": "String, Unique identifying number of the review (Ex: 7417861364)",
      "title": "String, Title of the review, (Ex: Lacks ratios)",
      "text": "String, Body text of the review, (Ex: Beautiful app with images and videos but doesn’t tell you how much of what goes in making the drink. Needs ratios!)",
      "rating": "Integer, Rating of the review, (Ex: 3)",
      "review_date": "String, Date of the review (Ex: 2021-06-02 06:50:56 UTC)",
      "author": {
        "name": "String, Username of the reviewer",
        "link": "String, Unique iTunes link to reviewer's all comments. This link natively opens only on Apple Devices."
      }
    }
    ...
  ],
  ...
}

API Examples

Example results for product_id:534220544

Example results for product_id:534220544

JSON Example

{
  "search_metadata": {
    "id": "617865dfe7d08a8a9c8d616b",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/7d87da7dfc278333/617865dfe7d08a8a9c8d616b.json",
    "created_at": "2021-10-26 20:32:31 UTC",
    "processed_at": "2021-10-26 20:32:32 UTC",
    "apple_reviews_url": "https://itunes.apple.com/us/rss/customerreviews/page=1/id=534220544/xml",
    "raw_html_file": "https://serpapi.com/searches/7d87da7dfc278333/617865dfe7d08a8a9c8d616b.html",
    "prettify_html_file": "https://serpapi.com/searches/7d87da7dfc278333/617865dfe7d08a8a9c8d616b.prettify",
    "total_time_taken": 2.14
  },
  "search_parameters": {
    "engine": "apple_reviews",
    "product_id": "534220544",
    "page": "1"
  },
  "search_information": {
    "total_page_count": 4,
    "reviews_results_state": "Results for exact ID number.",
    "results_count": 50
  },
  "reviews": [
    {
      "position": 1,
      "id": "7417861364",
      "title": "Lacks ratios",
      "text": "Beautiful app with images and videos but doesn’t tell you how much of what goes in making the drink. Needs ratios!",
      "rating": 3,
      "review_date": "2021-06-02 06:50:56 UTC",
      "author": {
        "name": "<username>",
        "link": "https://itunes.apple.com/us/reviews/id000000000"
      }
    },
    ...
  ],
  "serpapi_pagination": {
    "current": "https://serpapi.com/search.json?country=us&engine=apple_reviews&page=1&product_id=534220544",
    "next": "https://serpapi.com/search.json?country=us&engine=apple_reviews&page=2&product_id=534220544"
  }
}

Example results for product_id: 534220544, and sort: mosthelpful

Example results for product_id: 534220544, and sort: mosthelpful

JSON Example

{
  "search_metadata": {
    "id": "61441e55e7d08a265ddcd968",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/4813ebee38f4fee5/61441e55e7d08a265ddcd968.json",
    "created_at": "2021-09-17 04:49:25 UTC",
    "processed_at": "2021-09-17 04:49:25 UTC",
    "apple_reviews_url": "https://itunes.apple.com/us/rss/customerreviews/page=1/id=534220544/sortBy=mosthelpful/xml",
    "raw_html_file": "https://serpapi.com/searches/4813ebee38f4fee5/61441e55e7d08a265ddcd968.html",
    "prettify_html_file": "https://serpapi.com/searches/4813ebee38f4fee5/61441e55e7d08a265ddcd968.prettify",
    "total_time_taken": 1.81
  },
  "search_parameters": {
    "engine": "apple_reviews",
    "product_id": "534220544",
    "country": "us",
    "sort": "mosthelpful",
    "page": "1"
  },
  "search_information": {
    "total_page_count": 4,
    "reviews_results_state": "Results for exact ID number.",
    "results_count": 50
  },
  "reviews": [
    {
      "position": 1,
      "id": "3430818860",
      "title": "Great app for great coffee!",
      "text": "What more could one ask for in a coffee app? One can see the variety of drinks to choose from, visual ratios* for the ingredients in each drink, instructions on how to prepare each drink, plus there’s even a video that demonstrates how each drink is made. There’s even a bonus section on the different styles of coffee which can be made and how to make them. *Note: I did say that the app gives visual ratios for the ingredients not measurements for the ingredients. For some folks this might be a problem, but for me, personally, visual ratios allow the user some flexibility. All in all, a great app for coffee lovers!",
      "rating": 5,
      "review_date": "2018-11-17 20:56:22 UTC",
      "author": {
        "name": "<username>",
        "link": "https://itunes.apple.com/us/reviews/id000000000"
      }
    },
    ...
  ],
  "serpapi_pagination": {
    "current": "https://serpapi.com/search.json?country=us&engine=apple_reviews&page=1&product_id=534220544&sort=mosthelpful",
    "next": "https://serpapi.com/search.json?country=us&engine=apple_reviews&page=2&product_id=534220544&sort=mosthelpful"
  }
}

More complex examples with multiple optional parameters

The URL below fetches:
  • • Third page of result,
  • • Product with the ID: 1499149941,
  • • sorted by mosthelpful,
  • • in country gb
More complex examples with multiple optional parameters

JSON Example

{
  "search_metadata": {
    "id": "61441fbfe7d08a265972d2f6",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/88bc7f4e923cf03d/61441fbfe7d08a265972d2f6.json",
    "created_at": "2021-09-17 04:55:27 UTC",
    "processed_at": "2021-09-17 04:55:27 UTC",
    "apple_reviews_url": "https://itunes.apple.com/gb/rss/customerreviews/page=3/id=1499149941/sortBy=mosthelpful/xml",
    "raw_html_file": "https://serpapi.com/searches/88bc7f4e923cf03d/61441fbfe7d08a265972d2f6.html",
    "prettify_html_file": "https://serpapi.com/searches/88bc7f4e923cf03d/61441fbfe7d08a265972d2f6.prettify",
    "total_time_taken": 1.73
  },
  "search_parameters": {
    "engine": "apple_reviews",
    "product_id": "1499149941",
    "country": "gb",
    "sort": "mosthelpful",
    "page": "3"
  },
  "search_information": {
    "total_page_count": 3,
    "reviews_results_state": "Results for exact ID number.",
    "results_count": 50
  },
  "reviews": [
    {
      "position": 101,
      "id": "6744868002",
      "title": "App does not work. Login abs credit gone",
      "text": "Not sure what has happened. Used to use the old app all the time with no problem. Now I can’t log in as it is telling me it’s the wrong account and password combination (which I know it’s not) and the password reset option doesn’t work either, so you endlessly go around in circles trying to log in and being unable to I would not bother but I have over £30 in credit that I put on before the ‘update’ and am loathe to give even more money to Starbucks for nothing Stick to Costa or better still the independent coffee shops",
      "rating": 1,
      "review_date": "2020-12-12 04:32:59 UTC"
      "author": {
        "name": "<username>",
        "link": "https://itunes.apple.com/gb/reviews/id0000000"
      }
    },
    ...
  ],
  "serpapi_pagination": {
    "next": "https://serpapi.com/search.json?country=gb&engine=apple_reviews&page=4&product_id=1499149941&sort=mosthelpful",
    "current": "https://serpapi.com/search.json?country=us&engine=apple_reviews&page=3&product_id=534220544&sort=mosthelpful",
    "previous": "https://serpapi.com/search.json?country=gb&engine=apple_reviews&page=2&product_id=1499149941&sort=mosthelpful"
  }
}