NAVNavbar
Logo
cURL php NodeJS Python cSharp

Get Apple App Reviews Results by id

 
This endpoint will provide you with feedback data on applications listed on the App Store platform, including review ratings, review content, user profile info of each reviewer, review publication dates, and more. The results are specific to the app_id as well as the location and language parameters specified in the POST request.

We emulate set parameters with the highest accuracy so that the results you receive will match the actual search results for the specified parameters at the time of task setting. You can always check the returned results accessing the check_url in the Incognito mode to make sure the received data is entirely relevant. Note that user preferences, search history, and other personalized search factors are ignored by our system and thus would not be reflected in the returned results.

Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access

<?php
// You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip
require('RestClient.php');
$api_url = 'https://api.dataforseo.com/';
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
$client = new RestClient($api_url, null, 'login', 'password');

try {
	$result = array();
	// #1 - using this method you can get a list of completed tasks
	// GET /v3/app_data/apple/app_reviews/tasks_ready
	$tasks_ready = $client->get('/v3/app_data/apple/app_reviews/tasks_ready');
	// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
	if (isset($tasks_ready['status_code']) AND $tasks_ready['status_code'] === 20000) {
		foreach ($tasks_ready['tasks'] as $task) {
			if (isset($task['result'])) {
				foreach ($task['result'] as $task_ready) {
					// #2 - using this method you can get results of each completed task
					// GET /v3/app_data/apple/app_reviews/task_get/advanced/$id
					if (isset($task_ready['endpoint_advanced'])) {
						$result[] = $client->get($task_ready['endpoint_advanced']);
					}
					// #3 - another way to get the task results by id
					// GET /v3/app_data/apple/app_reviews/task_get/advanced/$id
					/*
					if (isset($task_ready['id'])) {
						$result[] = $client->get('/v3/app_data/apple/app_reviews/task_get/advanced/' . $task_ready['id']);
					}
					*/
				}
			}
		}
	}
	print_r($result);
	// do something with result
} catch (RestClientException $e) {
	echo "n";
	print "HTTP code: {$e->getHttpCode()}n";
	print "Error code: {$e->getCode()}n";
	print "Message: {$e->getMessage()}n";
	print  $e->getTraceAsString();
	echo "n";
}
$client = null;
?>

The above command returns JSON structured like this:

{{
  "version": "0.1.20230705",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1315 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "07071414-1535-0425-0000-2cee12cf9b5b",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0681 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "app_data",
        "apple",
        "app_reviews",
        "task_get",
        "advanced",
        "07071414-1535-0425-0000-2cee12cf9b5b"
      ],
      "data": {
        "se_type": "reviews",
        "se": "apple",
        "api": "app_data",
        "function": "app_reviews",
        "app_id": "835599320",
        "location_code": 2840,
        "language_code": "en",
        "depth": 200,
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "app_id": "835599320",
          "type": "reviews",
          "se_domain": "itunes.apple.com",
          "location_code": 2840,
          "language_code": "en",
          "check_url": "https://apps.apple.com/us/app/id835599320?see-all=reviews",
          "datetime": "2023-07-07 11:14:49 +00:00",
          "title": "TikTok",
          "rating": {
            "rating_type": "Max5",
            "value": 4.8,
            "votes_count": 15160324,
            "rating_max": 5
          },
          "reviews_count": 15160324,
          "items_count": 200,
          "items": [
            {
              "type": "app_store_reviews_search",
              "rank_group": 1,
              "rank_absolute": 1,
              "position": "left",
              "version": "29.0.0",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "timestamp": "2023-04-17 18:09:43 +00:00",
              "id": "9832393822",
              "title": "TikTok, The Last Frontier",
              "review_text": "Upsides: The app allows ppl to find community with likeminded people from all over the world. Allows you to earn your audience, and build your reputation through producing good content frequently. Over all, there is a very positive vibe on TikTok compared to other social media platforms, and the users seem to keep each other in check when it comes to being negative and bullying. It’s more entertaining and many times more informative than tv. It gives you a window into real peoples worlds as well, as opposed to Hollywood scripted scenes and scenarios. There are so many creative people out there freely sharing their art forms, and helping each other out, it’s beautiful to see. \n\nDownside: TikTok needs to build in a better reporting and appeal system. The current system has been weaponized to attack people simply because of opposing views. (I’ve seen people organize mass reporting parties for TikTok on Twitter.) Which isn’t fair to people who are working hard to make good clean content that happens to rub another group the wrong way. It can cause their videos to be removed their accounts to be limited or banned unjustly. Meanwhile very problematic content and malicious predatory behavior seems hard to get under control. I suggest more human discernment, deeper investigations into reports, and possibly repercussions for users who abuse the reporting system.",
              "user_profile": {
                "profile_name": "doublepenny",
                "profile_image_url": null
              }
            },
            {
              "type": "app_store_reviews_search",
              "rank_group": 2,
              "rank_absolute": 2,
              "position": "left",
              "version": "30.0.0",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "timestamp": "2023-07-01 18:39:23 +00:00",
              "id": "10093293959",
              "title": "Best app ever",
              "review_text": "Tiktok is literally one of the best + most used apps. I love how you can create a tiktok and get many likes on it but there are just a few problems that need to be fixed. First, people being unfit. They need to fix these inappropriate videos just because everyone wants to scroll through tiktoks to see normal videos and then come out to one like this. Second, shadowbanning. I've been banned in the shadows ever since I posted one of my most liked videos. I only get likes from my followers and I'm on fyp but I only get views. Third, tiktok glitches. My friend made a video and almost the entire video continued to have these gray things that made the video unbearable. I got likes but the video was full of glitches on tiktok. I just want you to fix this stuff not trying to be rude but just wanting to have a better experience without having these problems. I also have a good side in tiktok which is amazing. Tiktok is absolutely amazing and you can literally record anything without having a problem. You can search for anything you want, even things you don't know, and it will appear for you. I love the music that people make and I love the way you can watch your favorite videos, songs, etc. Thank you TikTok for being such a great app. Only problems are kind of annoying but it's not the songs and videos that I'm seeing. Thank you ",
              "user_profile": {
                "profile_name": "balsam7777",
                "profile_image_url": null
              }
            },
            {
              "type": "app_store_reviews_search",
              "rank_group": 3,
              "rank_absolute": 3,
              "position": "left",
              "version": "29.8.0",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "timestamp": "2023-06-17 01:20:48 +00:00",
              "id": "10041539974",
              "title": "Amazing app",
              "review_text": "TikTok, a social media platform that allows users to create and share short-form videos, has become increasingly popular in recent years, and with good reason. One of the best things about TikTok is that it provides a platform for creative expression. Users can showcase their talents, share their opinions, and connect with others who share their interests. From dance routines to comedy skits to cooking tutorials, TikTok offers a diverse range of content that is both entertaining and informative.\n\nAnother positive aspect of TikTok is its ability to bring people together. The platform has become a hub for communities of all kinds, from fitness enthusiasts to book lovers to animal lovers. Users can connect with others who share their passions and form meaningful relationships online. Additionally, TikTok has been used to raise awareness about important issues, such as mental health and social justice, creating a sense of unity and solidarity among users.\n\nFinally, TikTok has become a source of inspiration for many people. The platform is filled with uplifting and motivational content that encourages users to pursue their dreams and be their best selves. From inspiring quotes to personal stories of triumph over adversity, TikTok has become a platform for positivity and self-improvement. Overall, TikTok has brought a lot of good into the world, and its impact is likely to continue to grow in the years to come.",
              "user_profile": {
                "profile_name": "fyp.zenify",
                "profile_image_url": null
              }
            },
            {
              "type": "app_store_reviews_search",
              "rank_group": 4,
              "rank_absolute": 4,
              "position": "left",
              "version": "29.8.0",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "timestamp": "2023-06-14 23:02:58 +00:00",
              "id": "10034361624",
              "title": "Good platform",
              "review_text": "This is a very good platform that could create something for everyones participation, prerogative actions or likes on what they cud or wud do for this platform for both parties TikTok n followers that is creating positivity vibes and could give a person a chance to join regardless of race and sex ,good form to express motivational  acts that everyone could understand and make something big out of the sources of each individual to whatever endeavors they get in life in the coming future ❤️.spreading kindness love ,awareness to each n everyone that is humanand inviting everyone to be of what ,when ,where and how-they wanted to be in pursuing the actions in their future goodwill to life they are having at the present time in this world ….thank you TikTok for these experience that u gave me to achieve  and access this platform to exceed the capability of doing a positive manner for myself n others lives . That I would say it’s awesome to be a member of this community that encourages the goodness of each other with the help of another other lol  did I say it right ? In short I’m aware that I’m satisfied and enjoying TikTok everyday,everytime  every seconds and everywhere in my own lifebut I just don’t know yet on  how to get compensated doing this here .but most honestly of all I’m just happy on expressing my inner feelings with TikTok .again I shall say thank you TikTok …",
              "user_profile": {
                "profile_name": "Jeyrey24",
                "profile_image_url": null
              }
            },
            {
              "type": "app_store_reviews_search",
              "rank_group": 5,
              "rank_absolute": 5,
              "position": "left",
              "version": "29.1.1",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "timestamp": "2023-05-02 21:05:14 +00:00",
              "id": "9886050394",
              "title": "Fun but could use improvements",
              "review_text": "I enjoy this app on my free time, I don’t like how it gets switched in the live and then it’s on a continuing cycle of watching live videos. I can’t stand that if I wanted to watch live, I can click on live and watch live but I don’t enjoy watching the live, so I don’t appreciate it jumping to live in getting stuck on it. Also, I don’t like how when I click I’m not interested on a video it keeps showing the same content, Creator, or the same content. I don’t appreciate how many ads have been popping up lately. I understand the ads here and there to keep the Apple live. I totally get that I’m for that but there has been so many. More than there ever was. And when I click, I’m not interested yet they still show up. I find that frustrating. I dislike how many children are on this app yet they’re strippers basically half naked, showing their dance routines.. there’s still so much inappropriate content for a child to watch and when you report a video where it contact creator, I wish they would look into it more and see what is best for the people viewing it not there guidelines because I feel the guidelines are quite as accurate as a contact that’s being put out there so if it’s inappropriate it’s inappropriate and I wish they would take that into consideration, instead of finding no violation in it.",
              "user_profile": {
                "profile_name": "Skinnbonessss",
                "profile_image_url": null
              }
            }
          ]
        }
      ]
    }
  ]
}

Description of the fields for sending a request:

Field name Type Description
id string task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time

‌‌‌‌
‌‌As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.

You can also get all available SERP features by making a request to the following Sandbox URL:
https://sandbox.dataforseo.com/v3/app_data/apple/app_reviews/task_get/advanced/00000000-0000-0000-0000-000000000000
The response will include all available items in the Apple App Reviews Advanced endpoint with the fields containing dummy data.
You won’t be charged for using Sandbox endpoints.

Description of the fields in the results array:

Field name Type Description
version string the current version of the API
status_code integer general status code
you can find the full list of the response codes here
Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions
status_message string general informational message
you can find the full list of general informational messages here
time string execution time, seconds
cost float total tasks cost, USD
tasks_count integer the number of tasks in the tasks array
tasks_error integer the number of tasks in the tasks array that were returned an error
tasks array array of tasks
        id string task identifier
unique task identifier in our system in the UUID format
        status_code integer status code of the task
generated by DataForSEO; can be within the following range: 10000-60000
you can find the full list of the response codes here
        status_message string informational message of the task
you can find the full list of general informational messages here
        time string execution time, seconds
        cost float cost of the task, USD
        result_count integer number of elements in the result array
        path array URL path
        data object contains the same parameters that you specified in the POST request
        result array array of results
            app_id string application id received in a POST array
            type string search engine type in a POST array
            se_domain string search engine domain in a POST array
            location_code integer location code in a POST array
            language_code string language code in a POST array
            check_url string direct URL to search engine results
you can use it to make sure that we provided accurate results
            datetime string date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
            title string title of the app
title of the application for which the reviews are collected
            rating object rating of the app
rating of the application for which the reviews are collected
                rating_type string type of rating
here you can find the following elements: Max5, Percents, CustomMax
                value float the average rating based on all reviews
                votes_count integer the number of votes
                rating_max integer the maximum value for a rating_type
            reviews_count integer the total number of reviews
in this case, the value will be null as App Store does not indicate the total number of app reviews
            items_count integer the number of reviews items in the results array
you can get more results by using the depth parameter when setting a task
            items array found reviews
                type string the review’s type
possible review types: "app_store_reviews_search"
                rank_group integer position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank among all the listed reviews
absolute position among all reviews on the list
                position string the alignment of the review in SERP
can take the following values: left
                version string version of the app
version of the app for which the review is submitted
                rating object the rating score submitted by the reviewer
                    rating_type string the type of the rating
can take the following values: Max5
                    value float the value of the rating
                    votes_count integer the amount of feedback
in this case, the value will be null
                    rating_max integer the maximum value for a rating_type
the maximum value for Max5 is 5
                timestamp string date and time when the review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:
2019-11-15 12:57:46 +00:00
                id string id of the review
                title string title of the review
                review_text string content of the review
                user_profile object user profile of the reviewer
                    profile_name string profile name of the reviewer
                    profile_image_url string URL to the reviewer’s profile image

‌‌