{"id":13671,"date":"2022-04-26T12:22:39","date_gmt":"2022-04-26T12:22:39","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=13671"},"modified":"2023-10-20T15:37:16","modified_gmt":"2023-10-20T15:37:16","slug":"app_data-apple-app_searches-task_get-advanced","status":"publish","type":"page","link":"https:\/\/docs.dataforapps.com\/v3\/app_data-apple-app_searches-task_get-advanced\/","title":{"rendered":"app_data\/apple\/app_searches\/task_get\/advanced"},"content":{"rendered":"<p>[vc_row][vc_column][vc_column_text]<\/p>\n<h2 id=\"get-apple-app-searches-results-by-task_id\">Get Apple App Searches Results by id<\/h2>\n<p>&nbsp;<br \/>\nThis endpoint will provide you with a list of apps ranking on the App Store for the <code>keyword<\/code> specified in a POST request. You will also receive additional information about each application: its ID, icon, reviews count, rating, price, and other data. The results are specific to the <code>keyword<\/code> as well as location and language parameters specified in the POST request.<br \/>\n[\/vc_column_text]\n        <blockquote>\n            <p>Instead of \u2018login\u2019 and \u2018password\u2019 use your credentials from https:\/\/app.dataforapps.com\/api-dashboard<\/p>\n        <\/blockquote>\n        <pre class=\"highlight bash tab-bash\" style=\"display: none;\">\n            <\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"bash\" data-enlighter-theme=\"mocha\">\r\n# Instead of 'login' and 'password' use your credentials from https:\/\/app.dataforapps.com\/api-dashboard \r\nlogin=\"login\" \r\npassword=\"password\" \r\ncred=\"$(printf ${login}:${password} | base64)\" \r\nid=\"04011058-0696-0199-0000-2196151a15cb\" \r\ncurl --location --request GET \"https:\/\/api.dataforapps.com\/v3\/app_data\/apple\/app_searches\/task_get\/advanced\/${id}\" \r\n--header \"Authorization: Basic ${cred}\"  \r\n--header \"Content-Type: application\/json\" \r\n<\/pre>\n<p>\n        <\/pre>\n        <pre class=\"highlight php tab-php\" style=\"display: block;\"><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\" data-enlighter-theme=\"mocha\">&lt;?php\r\n\/\/ You can download this file from here https:\/\/cdn.dataforapps.com\/v3\/examples\/php\/php_RestClient.zip\r\nrequire('RestClient.php');\r\n$api_url = 'https:\/\/api.dataforapps.com\/';\r\n\/\/ Instead of 'login' and 'password' use your credentials from https:\/\/app.dataforapps.com\/api-dashboard\r\n$client = new RestClient($api_url, null, 'login', 'password');\r\n\r\ntry {\r\n\t$result = array();\r\n\t\/\/ #1 - using this method you can get a list of completed tasks\r\n\t\/\/ GET \/v3\/app_data\/apple\/app_searches\/tasks_ready\r\n\t$tasks_ready = $client-&gt;get('\/v3\/app_data\/apple\/app_searches\/tasks_ready');\r\n\t\/\/ you can find the full list of the response codes here https:\/\/docs.dataforapps.com\/v3\/appendix\/errors\r\n\tif (isset($tasks_ready['status_code']) AND $tasks_ready['status_code'] === 20000) {\r\n\t\tforeach ($tasks_ready['tasks'] as $task) {\r\n\t\t\tif (isset($task['result'])) {\r\n\t\t\t\tforeach ($task['result'] as $task_ready) {\r\n\t\t\t\t\t\/\/ #2 - using this method you can get results of each completed task\r\n\t\t\t\t\t\/\/ GET \/v3\/app_data\/apple\/app_searches\/task_get\/advanced\/$id\r\n\t\t\t\t\tif (isset($task_ready['endpoint_advanced'])) {\r\n\t\t\t\t\t\t$result[] = $client-&gt;get($task_ready['endpoint_advanced']);\r\n\t\t\t\t\t}\r\n\t\t\t\t\t\/\/ #3 - another way to get the task results by id\r\n\t\t\t\t\t\/\/ GET \/v3\/app_data\/apple\/app_searches\/task_get\/advanced\/$id\r\n\t\t\t\t\t\/*\r\n\t\t\t\t\tif (isset($task_ready['id'])) {\r\n\t\t\t\t\t\t$result[] = $client-&gt;get('\/v3\/app_data\/apple\/app_searches\/task_get\/advanced\/' . $task_ready['id']);\r\n\t\t\t\t\t}\r\n\t\t\t\t\t*\/\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\tprint_r($result);\r\n\t\/\/ do something with result\r\n} catch (RestClientException $e) {\r\n\techo \"n\";\r\n\tprint \"HTTP code: {$e-&gt;getHttpCode()}n\";\r\n\tprint \"Error code: {$e-&gt;getCode()}n\";\r\n\tprint \"Message: {$e-&gt;getMessage()}n\";\r\n\tprint  $e-&gt;getTraceAsString();\r\n\techo \"n\";\r\n}\r\n$client = null;\r\n?&gt;<\/pre>\n<p><\/pre>\n        <pre class=\"highlight python tab-python\" style=\"display: none;\">\n            <\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"python\" data-enlighter-theme=\"mocha\">from client import from client import RestClient\r\n# You can download this file from here https:\/\/cdn.dataforapps.com\/v3\/examples\/python\/python_Client.zip\r\nclient = RestClient(\"login\", \"password\")\r\n# get the task results by id\r\n# GET \/v3\/app_data\/apple\/app_searches\/task_get\/advanced\/$id\r\nid = \"06141103-2692-0309-1000-980b778b6d25\"\r\nresponse = client.get(\"\/v3\/app_data\/apple\/app_searches\/task_get\/advanced\/\" + id)\r\n# you can find the full list of the response codes here https:\/\/docs.dataforapps.com\/v3\/appendix\/errors\r\nif response[\"status_code\"] == 20000:\r\n    print(response)\r\n    # do something with result\r\nelse:\r\n    print(\"error. Code: %d Message: %s\" % (response[\"status_code\"], response[\"status_message\"])) \r\n<\/pre>\n<p>\n        <\/pre>\n        <pre class=\"highlight javascript tab-javascript\" style=\"display: none;\">\n            <\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"bash\" data-enlighter-theme=\"mocha\">\r\n\r\nconst task_id = '02231934-2604-0066-2000-570459f04879';\r\n\r\nconst axios = require('axios');\r\n\r\naxios({\r\n    method: 'get',\r\n    url: 'https:\/\/api.dataforapps.com\/v3\/app_data\/apple\/app_searches\/task_get\/advanced' + task_id,\r\n    auth: {\r\n        username: 'login',\r\n        password: 'password'\r\n    },\r\n    headers: {\r\n        'content-type': 'application\/json'\r\n    }\r\n}).then(function (response) {\r\n    var result = response['data']['tasks'];\r\n    \/\/ Result data\r\n    console.log(result);\r\n}).catch(function (error) {\r\n    console.log(error);\r\n});\r\n<\/pre>\n<p>\n        <\/pre>\n        <pre class=\"highlight csharp tab-csharp\" style=\"display: none;\">\n            <\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"csharp\" data-enlighter-theme=\"mocha\">using Newtonsoft.Json;\r\nusing Newtonsoft.Json;\r\nusing System;\r\nusing System.Net.Http;\r\nusing System.Net.Http.Headers;\r\nusing System.Text;\r\nusing System.Threading.Tasks;\r\n\r\nnamespace DataForSeoDemos\r\n{\r\n    public static partial class Demos\r\n    {\r\n        public static async Task app_data_apple_app_searches_task_get_by_id()\r\n        {\r\n            var httpClient = new HttpClient\r\n            {\r\n                BaseAddress = new Uri(\"https:\/\/api.dataforapps.com\/\"),\r\n                \/\/ Instead of 'login' and 'password' use your credentials from https:\/\/app.dataforapps.com\/api-dashboard\r\n                DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue(\"Basic\", Convert.ToBase64String(Encoding.ASCII.GetBytes(\"login:password\"))) }\r\n            };\r\n            \/\/ get the task results by id\r\n            \/\/ GET \/v3\/app_data\/apple\/app_searches\/task_get\/advanced\/$id\r\n            \/\/ use the task identifier that you recieved upon setting a task\r\n            string id = \"06141103-2692-0309-1000-980b778b6d25\";\r\n            var taskGetResponse = await httpClient.GetAsync(\"\/v3\/app_data\/apple\/app_searches\/task_get\/advanced\/\" + id);\r\n            var result = JsonConvert.DeserializeObject&lt;dynamic&gt;(await taskGetResponse.Content.ReadAsStringAsync());\r\n            if (result.tasks != null)\r\n            {\r\n                var fst = result.tasks.First;\r\n                \/\/ you can find the full list of the response codes here https:\/\/docs.dataforapps.com\/v3\/appendix\/errors\r\n                if (fst.status_code >= 40000 || fst.result == null)\r\n                    Console.WriteLine($\"error. Code: {fst.status_code} Message: {fst.status_message}\");\r\n                else\r\n                    \/\/ do something with result\r\n                    Console.WriteLine(String.Join(Environment.NewLine, fst));\r\n            }\r\n            else\r\n                Console.WriteLine($\"error. Code: {result.status_code} Message: {result.status_message}\");\r\n        }\r\n    }\r\n}\r\n<\/pre>\n<p>\n        <\/pre>\n        <blockquote>\n            <p>The above command returns JSON structured like this:<\/p>\n        <\/blockquote>\n        <pre class=\"json tab-json\"><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"mocha\">{\r\n    \"version\": \"0.1.20220422\",\r\n    \"status_code\": 20000,\r\n    \"status_message\": \"Ok.\",\r\n    \"time\": \"0.1347 sec.\",\r\n    \"cost\": 0,\r\n    \"tasks_count\": 1,\r\n    \"tasks_error\": 0,\r\n    \"tasks\": [\r\n        {\r\n            \"id\": \"04272056-1535-0428-0000-6099c37f7d21\",\r\n            \"status_code\": 20000,\r\n            \"status_message\": \"Ok.\",\r\n            \"time\": \"0.0369 sec.\",\r\n            \"cost\": 0,\r\n            \"result_count\": 1,\r\n            \"path\": [\r\n                \"v3\",\r\n                \"app_data\",\r\n                \"apple\",\r\n                \"app_searches\",\r\n                \"task_get\",\r\n                \"advanced\",\r\n                \"04272056-1535-0428-0000-6099c37f7d21\"\r\n            ],\r\n            \"data\": {\r\n                \"se_type\": \"organic\",\r\n                \"se\": \"apple\",\r\n                \"api\": \"app_data\",\r\n                \"function\": \"app_searches\",\r\n                \"keyword\": \"vpn\",\r\n                \"location_code\": 2840,\r\n                \"language_code\": \"en\",\r\n                \"depth\": 200,\r\n                \"device\": \"desktop\",\r\n                \"os\": \"windows\"\r\n            },\r\n            \"result\": [\r\n                {\r\n                    \"keyword\": \"vpn\",\r\n                    \"se_domain\": \"itunes.apple.com\",\r\n                    \"location_code\": 2840,\r\n                    \"language_code\": \"en\",\r\n                    \"check_url\": null,\r\n                    \"datetime\": \"2022-04-27 17:56:22 +00:00\",\r\n                    \"se_results_count\": 274,\r\n                    \"items_count\": 198,\r\n                    \"items\": [\r\n                        {\r\n                            \"type\": \"app_store_search_organic\",\r\n                            \"rank_group\": 1,\r\n                            \"rank_absolute\": 1,\r\n                            \"position\": \"left\",\r\n                            \"app_id\": \"1370293473\",\r\n                            \"title\": \"VPN - Super Unlimited Proxy\",\r\n                            \"url\": \"https:\/\/apps.apple.com\/us\/app\/vpn-super-unlimited-proxy\/id1370293473\",\r\n                            \"icon\": \"https:\/\/is2-ssl.mzstatic.com\/image\/thumb\/Purple112\/v4\/ca\/c3\/67\/cac367c8-6298-8044-e9f3-5b617098fff8\/source\/512x512bb.jpg\",\r\n                            \"reviews_count\": 1347479,\r\n                            \"rating\": {\r\n                                \"rating_type\": \"Max5\",\r\n                                \"value\": 4.63253,\r\n                                \"votes_count\": 1347479,\r\n                                \"rating_max\": 5\r\n                            },\r\n                            \"is_free\": true,\r\n                            \"price\": {\r\n                                \"current\": 0,\r\n                                \"regular\": null,\r\n                                \"max_value\": null,\r\n                                \"currency\": \"USD\",\r\n                                \"is_price_range\": false,\r\n                                \"displayed_price\": null\r\n                            }\r\n                        },\r\n                        {\r\n                            \"type\": \"app_store_search_organic\",\r\n                            \"rank_group\": 2,\r\n                            \"rank_absolute\": 2,\r\n                            \"position\": \"left\",\r\n                            \"app_id\": \"443369807\",\r\n                            \"title\": \"HotspotShield VPN & Wifi Proxy\",\r\n                            \"url\": \"https:\/\/apps.apple.com\/us\/app\/hotspotshield-vpn-wifi-proxy\/id443369807\",\r\n                            \"icon\": \"https:\/\/is2-ssl.mzstatic.com\/image\/thumb\/Purple122\/v4\/3b\/2c\/01\/3b2c01b4-bfa4-bbd8-ef44-484221f07d1b\/source\/512x512bb.jpg\",\r\n                            \"reviews_count\": 147890,\r\n                            \"rating\": {\r\n                                \"rating_type\": \"Max5\",\r\n                                \"value\": 4.46584,\r\n                                \"votes_count\": 147890,\r\n                                \"rating_max\": 5\r\n                            },\r\n                            \"is_free\": true,\r\n                            \"price\": {\r\n                                \"current\": 0,\r\n                                \"regular\": null,\r\n                                \"max_value\": null,\r\n                                \"currency\": \"USD\",\r\n                                \"is_price_range\": false,\r\n                                \"displayed_price\": null\r\n                            }\r\n                        },\r\n                        {\r\n                            \"type\": \"app_store_search_organic\",\r\n                            \"rank_group\": 3,\r\n                            \"rank_absolute\": 3,\r\n                            \"position\": \"left\",\r\n                            \"app_id\": \"946659216\",\r\n                            \"title\": \"Best VPN Proxy Betternet\",\r\n                            \"url\": \"https:\/\/apps.apple.com\/us\/app\/best-vpn-proxy-betternet\/id946659216\",\r\n                            \"icon\": \"https:\/\/is4-ssl.mzstatic.com\/image\/thumb\/Purple116\/v4\/37\/eb\/bb\/37ebbb1a-75ce-7ef4-1933-3342611680a5\/source\/512x512bb.jpg\",\r\n                            \"reviews_count\": 189700,\r\n                            \"rating\": {\r\n                                \"rating_type\": \"Max5\",\r\n                                \"value\": 4.52062,\r\n                                \"votes_count\": 189700,\r\n                                \"rating_max\": 5\r\n                            },\r\n                            \"is_free\": true,\r\n                            \"price\": {\r\n                                \"current\": 0,\r\n                                \"regular\": null,\r\n                                \"max_value\": null,\r\n                                \"currency\": \"USD\",\r\n                                \"is_price_range\": false,\r\n                                \"displayed_price\": null\r\n                            }\r\n                        },\r\n                        {\r\n                            \"type\": \"app_store_search_organic\",\r\n                            \"rank_group\": 4,\r\n                            \"rank_absolute\": 4,\r\n                            \"position\": \"left\",\r\n                            \"app_id\": \"1193154948\",\r\n                            \"title\": \"VPN 360 - Unlimited VPN Proxy\",\r\n                            \"url\": \"https:\/\/apps.apple.com\/us\/app\/vpn-360-unlimited-vpn-proxy\/id1193154948\",\r\n                            \"icon\": \"https:\/\/is3-ssl.mzstatic.com\/image\/thumb\/Purple122\/v4\/15\/87\/86\/15878628-7fed-a10a-1ab6-818817bc076f\/source\/512x512bb.jpg\",\r\n                            \"reviews_count\": 296293,\r\n                            \"rating\": {\r\n                                \"rating_type\": \"Max5\",\r\n                                \"value\": 4.67716,\r\n                                \"votes_count\": 296293,\r\n                                \"rating_max\": 5\r\n                            },\r\n                            \"is_free\": true,\r\n                            \"price\": {\r\n                                \"current\": 0,\r\n                                \"regular\": null,\r\n                                \"max_value\": null,\r\n                                \"currency\": \"USD\",\r\n                                \"is_price_range\": false,\r\n                                \"displayed_price\": null\r\n                            }\r\n                        },\r\n                        {\r\n                            \"type\": \"app_store_search_organic\",\r\n                            \"rank_group\": 5,\r\n                            \"rank_absolute\": 5,\r\n                            \"position\": \"left\",\r\n                            \"app_id\": \"1282216562\",\r\n                            \"title\": \"VPN - Unlimited Best VPN Proxy\",\r\n                            \"url\": \"https:\/\/apps.apple.com\/us\/app\/vpn-unlimited-best-vpn-proxy\/id1282216562\",\r\n                            \"icon\": \"https:\/\/is3-ssl.mzstatic.com\/image\/thumb\/Purple122\/v4\/d3\/0e\/fa\/d30efa72-07f6-943e-1b88-50ffd6bd4b0f\/source\/512x512bb.jpg\",\r\n                            \"reviews_count\": 135164,\r\n                            \"rating\": {\r\n                                \"rating_type\": \"Max5\",\r\n                                \"value\": 4.66001,\r\n                                \"votes_count\": 135164,\r\n                                \"rating_max\": 5\r\n                            },\r\n                            \"is_free\": true,\r\n                            \"price\": {\r\n                                \"current\": 0,\r\n                                \"regular\": null,\r\n                                \"max_value\": null,\r\n                                \"currency\": \"USD\",\r\n                                \"is_price_range\": false,\r\n                                \"displayed_price\": null\r\n                            }\r\n                        }\r\n                    ]\r\n                }\r\n            ]\r\n        }\r\n    ]\r\n}<\/pre>\n<p><\/pre><aside class=\"success\"><b><code>GET https:\/\/api.dataforapps.com\/v3\/app_data\/apple\/app_searches\/task_get\/advanced\/$id<\/code><\/b><\/aside><aside class=\"notice\"> Your account will be charged only for setting a task. You can get the results of the task within the next 30 days for free.<br \/>\nThe cost can be calculated on the <a title=\"Pricing\" href=\"https:\/\/dataforapps.com\/pricing\/\" target=\"_blank\" rel=\"noopener noreferrer\">Pricing<\/a> page.<\/aside>[vc_column_text]<\/p>\n<p><strong>Description of the fields for sending a request:<\/strong><\/p>\n<table style=\"width: 86.0726%; height: 34px;\">\n<thead>\n<tr style=\"height: 24px;\">\n<th style=\"width: 12.4003%; height: 24px;\">Field name<\/th>\n<th style=\"width: 3.91588%; height: 24px;\">Type<\/th>\n<th style=\"width: 82.9587%; height: 24px;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr style=\"height: 192px;\">\n<td style=\"width: 12.4003%; height: 10px;\"><code>id<\/code><\/td>\n<td style=\"width: 3.91588%; height: 10px;\">string<\/td>\n<td style=\"width: 82.9587%; height: 10px;\"><em>task identifier<\/em><br \/>\n<strong>unique task identifier in our system in the <a href=\"https:\/\/en.wikipedia.org\/wiki\/Universally_unique_identifier\">UUID<\/a> format<\/strong><br \/>\nyou will be able to use it within <strong>30 days<\/strong> to request the results of the task at any time<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>\u200c\u200c\u200c\u200c<br \/>\n\u200c\u200cAs a response of the API server, you will receive <a href=\"https:\/\/en.wikipedia.org\/wiki\/JSON\">JSON<\/a>-encoded data containing a <code>tasks<\/code> array with the information specific to the set tasks.<\/p>\n<p><strong>Description of the fields in the results array:<\/strong><\/p>\n<table style=\"width: 86.001%; height: 1369px;\">\n<thead>\n<tr style=\"height: 24px;\">\n<th style=\"width: 24.3517%; height: 24px;\">Field name<\/th>\n<th style=\"width: 6.19209%; height: 24px;\">Type<\/th>\n<th style=\"width: 79.8065%; height: 24px;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr style=\"height: 48px;\">\n<td style=\"width: 24.3517%; height: 48px;\"><code>version<\/code><\/td>\n<td style=\"width: 6.19209%; height: 48px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 48px;\"><em>the current version of the API<\/em><\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"width: 38.423%; height: 48px;\"><code>status_code<\/code><\/td>\n<td style=\"width: 1.75219%; height: 48px;\">integer<\/td>\n<td style=\"width: 61.2015%; height: 48px;\"><i>general status code<\/i><br \/>\nyou can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><br \/>\n<strong>Note:<\/strong> we strongly recommend designing a necessary system for handling related exceptional or error conditions<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>status_message<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>general informational message<\/em><br \/>\nyou can find the full list of general informational messages <a href=\"\/v3\/appendix\/errors\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>time<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>execution time, seconds<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>cost<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">float<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>total <i>tasks<\/i> cost, USD<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>tasks_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>tasks_error<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array that were returned an error<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><strong><code>tasks<\/code><\/strong><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>array of tasks<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>id<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>task identifier<\/em><br \/>\n<strong>unique task identifier in our system in the <a href=\"https:\/\/en.wikipedia.org\/wiki\/Universally_unique_identifier\">UUID<\/a> format<\/strong><\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"width: 24.3517%; height: 48px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>status_code<\/code><\/td>\n<td style=\"width: 6.19209%; height: 48px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 48px;\"><em>status code of the task<\/em><br \/>\ngenerated by DataForApps; can be within the following range: 10000-60000<br \/>\nyou can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>status_message<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>informational message of the task<\/em><br \/>\nyou can find the full list of general informational messages <a href=\"\/v3\/appendix\/errors\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>time<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>execution time, seconds<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>cost<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">float<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>cost of the task, USD<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>result_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>number of elements in the <code>result<\/code> array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>path<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>URL path<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>data<\/code><\/td>\n<td style=\"width: 1.25156%; height: 24px;\">object<\/td>\n<td style=\"width: 61.7021%; height: 24px;\"><em>contains the same parameters that you specified in the POST request<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 <strong>\u00a0 \u00a0 <code>result<\/code><\/strong><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>array of results<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>keyword<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>keyword received in a POST request<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>se_domain<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>search engine domain in a POST array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>location_code<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>location code in a POST array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>language_code<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>language code in a POST array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 25px;\">\n<td style=\"width: 24.3517%; height: 25px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>check_url<\/code><\/td>\n<td style=\"width: 6.19209%; height: 25px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 25px;\"><em>direct URL to search engine results<\/em><br \/>\nin this case, the value will be <code>null<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>datetime<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>date and time when the result was received<\/em><br \/>\nin the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<br \/>\nexample:<br \/>\n<code class=\"long-string\">2019-11-15 12:57:46 +00:00<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>se_results_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the total number of results<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>items_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the number of items in the results array<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <strong><code>items<\/code><\/strong><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>found apps<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>type<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the item&#8217;s type<\/em><br \/>\npossible item types: <code>\"app_store_search_organic\"<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>rank_group<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>position within a group of elements with identical <code>type<\/code> values<\/em><br \/>\npositions of elements with different <code>type<\/code> values are omitted from <code>rank_group<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>rank_absolute<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>absolute rank among all the listed apps<\/em><br \/>\nabsolute position among all apps on the list<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>position<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the alignment of the element in SERP<\/em><br \/>\ncan take the following values: <code>left<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>app_id<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>ID of the returned app<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>title<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>title of the returned app<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>url<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>URL to the app page on App Store<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>icon<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>URL to the app icon<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>reviews_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the total number of reviews the app has<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>rating<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">object<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>average rating of the app<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"> \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>rating_type<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the type of the rating<\/em><br \/>\ncan take the following values: <code>Max5<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"> \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>value<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">float<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the value of the rating<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"> \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>votes_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the amount of feedback<\/em><br \/>\nin this case, the value will be <code>null<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"> \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>rating_max<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the maximum value for a <code>rating_type<\/code><\/em><br \/>\nthe maximum value for <code>Max5<\/code> is 5<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>is_free<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">boolean<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>indicates whether the app is free<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>price<\/code><\/td>\n<td style=\"width: 5.77015%; height: 24px;\">object<\/td>\n<td style=\"width: 80.2284%; height: 24px;\"><em>price of the app<\/em><\/td>\n<\/tr>\n<tr style=\"height: 25px;\">\n<td style=\"width: 24.3517%; height: 25px;\"> \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>current<\/code><\/td>\n<td style=\"width: 5.77015%; height: 25px;\">float<\/td>\n<td style=\"width: 80.2284%; height: 25px;\"><em>current price<\/em><br \/>\nrefers to the current price indicated in the element<\/td>\n<\/tr>\n<tr style=\"height: 25px;\">\n<td style=\"width: 24.3517%; height: 25px;\"> \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>regular<\/code><\/td>\n<td style=\"width: 5.77015%; height: 25px;\">float<\/td>\n<td style=\"width: 80.2284%; height: 25px;\"><i>regular price<\/i><br \/>\nrefers to the regular price indicated in the element<\/td>\n<\/tr>\n<tr style=\"height: 25px;\">\n<td style=\"width: 24.3517%; height: 25px;\"> \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>max_value<\/code><\/td>\n<td style=\"width: 5.77015%; height: 25px;\">float<\/td>\n<td style=\"width: 80.2284%; height: 25px;\"><i>the maximum price<\/i><br \/>\nrefers to the maximum price indicated in the element<\/td>\n<\/tr>\n<tr style=\"height: 25px;\">\n<td style=\"width: 24.3517%; height: 25px;\"> \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>currency<\/code><\/td>\n<td style=\"width: 5.77015%; height: 25px;\">string<\/td>\n<td style=\"width: 80.2284%; height: 25px;\"><i>currency of the listed price<\/i><br \/>\nISO code of the currency applied to the price<\/td>\n<\/tr>\n<tr style=\"height: 25px;\">\n<td style=\"width: 24.3517%; height: 25px;\"> \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>is_price_range<\/code><\/td>\n<td style=\"width: 5.77015%; height: 25px;\">boolean<\/td>\n<td style=\"width: 80.2284%; height: 25px;\"><i>price is provided as a range<\/i><br \/>\nindicates whether a price is provided in a range<\/td>\n<\/tr>\n<tr style=\"height: 25px;\">\n<td style=\"width: 24.3517%; height: 25px;\"> \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>displayed_price<\/code><\/td>\n<td style=\"width: 5.77015%; height: 25px;\">string<\/td>\n<td style=\"width: 80.2284%; height: 25px;\"><i>price string in the result<\/i><br \/>\nraw price string as provided in the result<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>\u200c\u200c[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n","protected":false},"excerpt":{"rendered":"<p>[vc_row][vc_column][vc_column_text] Get Apple App Searches Results by id &nbsp; This endpoint will provide you with a list of apps ranking on the App Store for the keyword specified in a POST request. You will also receive additional information about each application: its ID, icon, reviews count, rating, price, and other data. The results are specific [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"footnotes":""},"_links":{"self":[{"href":"https:\/\/docs.dataforapps.com\/v3\/wp-json\/wp\/v2\/pages\/13671"}],"collection":[{"href":"https:\/\/docs.dataforapps.com\/v3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.dataforapps.com\/v3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.dataforapps.com\/v3\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforapps.com\/v3\/wp-json\/wp\/v2\/comments?post=13671"}],"version-history":[{"count":6,"href":"https:\/\/docs.dataforapps.com\/v3\/wp-json\/wp\/v2\/pages\/13671\/revisions"}],"predecessor-version":[{"id":17559,"href":"https:\/\/docs.dataforapps.com\/v3\/wp-json\/wp\/v2\/pages\/13671\/revisions\/17559"}],"wp:attachment":[{"href":"https:\/\/docs.dataforapps.com\/v3\/wp-json\/wp\/v2\/media?parent=13671"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}