{"id":13655,"date":"2022-04-29T15:58:38","date_gmt":"2022-04-29T15:58:38","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=13655"},"modified":"2023-10-20T13:44:10","modified_gmt":"2023-10-20T13:44:10","slug":"app_data-tasks_ready","status":"publish","type":"page","link":"https:\/\/docs.dataforapps.com\/v3\/app_data-tasks_ready\/","title":{"rendered":"app_data\/tasks_ready"},"content":{"rendered":"

[vc_row][vc_column][vc_column_text]<\/p>\n

Get {{up_se_name}} {{normal_se_type}} Completed Tasks<\/h2>\n

\u200c
\nThe ‘Tasks Ready’<\/strong> endpoint is designed to provide you with a list of completed tasks that haven’t been collected yet. If you use the Standard method without specifying the postback_url<\/code>, you can receive the list of id<\/code> for all completed tasks using this endpoint. Then, you can collect the results using the \u2018Task GET\u2019<\/strong> endpoints.<\/p>\n

Note:<\/strong> due to the peculiarities of our architecture the queue of completed tasks is updated with a small delay, which can be an issue for high-volume users. If your system requires collecting over 1000 tasks a minute, we recommend using pingbacks and postbacks instead, and applying the Tasks Ready endpoint only to obtain the IDs of failed postback tasks.
\n[\/vc_column_text]\n

\n

Instead of \u2018login\u2019 and \u2018password\u2019 use your credentials from https:\/\/app.dataforapps.com\/api-dashboard<\/p>\n <\/blockquote>\n 

\n            <\/p>\n
\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\ncurl --location --request GET \"https:\/\/api.dataforapps.com\/v3\/app_data\/{{low_se_name_under}}\/{{low_se_type_under}}\/tasks_ready\" \r\n--header \"Authorization: Basic ${cred}\"  \r\n--header \"Content-Type: application\/json\" \r\n--data-raw \"\"\r\n<\/pre>\n
\n        <\/pre>\n        
<\/p>\n
<?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   \/\/ using this method you can get a list of completed tasks\r\n   \/\/ GET \/v3\/app_data\/{{low_se_name_under}}\/{{low_se_type_under}}\/tasks_ready\r\n   $result = $client->get('\/v3\/app_data\/{{low_se_name_under}}\/{{low_se_type_under}}\/tasks_ready');\r\n   print_r($result);\r\n   \/\/ do something with result\r\n} catch (RestClientException $e) {\r\n   echo \"n\";\r\n   print \"HTTP code: {$e->getHttpCode()}n\";\r\n   print \"Error code: {$e->getCode()}n\";\r\n   print \"Message: {$e->getMessage()}n\";\r\n   print  $e->getTraceAsString();\r\n   echo \"n\";\r\n}\r\n$client = null;\r\n?><\/pre>\n
<\/pre>\n        
\n            <\/p>\n
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# using this method you can get a list of completed tasks\r\n# GET \/v3\/app_data\/{{low_se_name_under}}\/{{low_se_type_under}}\/tasks_ready\r\nresponse = client.get(\"\/v3\/app_data\/{{low_se_name_under}}\/{{low_se_type_under}}\/tasks_ready\")\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
\n        <\/pre>\n        
\n            <\/p>\n
\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\/{{low_se_name_under}}\/{{low_se_type_under}}\/tasks_ready',\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'][0]['result'];\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
\n        <\/pre>\n        
\n            <\/p>\n
using 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_{{low_se_name_under}}_{{low_se_type_under}}_tasks_ready()\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            \/\/ using this method you can get a list of completed tasks\r\n            \/\/ GET \/v3\/app_data\/{{low_se_name_under}}\/{{low_se_type_under}}\/tasks_ready\r\n            var response = await httpClient.GetAsync(\"\/v3\/app_data\/{{low_se_name_under}}\/{{low_se_type_under}}\/tasks_ready\");\r\n            var result = JsonConvert.DeserializeObject<dynamic>(await response.Content.ReadAsStringAsync());\r\n            \/\/ you can find the full list of the response codes here https:\/\/docs.dataforapps.com\/v3\/appendix\/errors\r\n            if (result.status_code == 20000)\r\n            {\r\n                \/\/ do something with result\r\n                Console.WriteLine(result);\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
\n        <\/pre>\n        
\n            
The above command returns JSON structured like this:<\/p>\n        <\/blockquote>\n        
<\/p>\n
{\r\n    \"version\": \"0.1.20220422\",\r\n    \"status_code\": 20000,\r\n    \"status_message\": \"Ok.\",\r\n    \"time\": \"0.1098 sec.\",\r\n    \"cost\": 0,\r\n    \"tasks_count\": 1,\r\n    \"tasks_error\": 0,\r\n    \"tasks\": [\r\n        {\r\n            \"id\": \"04221432-2806-0429-0000-bc2a174bad1b\",\r\n            \"status_code\": 20000,\r\n            \"status_message\": \"Ok.\",\r\n            \"time\": \"0.0612 sec.\",\r\n            \"cost\": 0,\r\n            \"result_count\": 1,\r\n            \"path\": [\r\n                \"v3\",\r\n                \"{{low_se_type_under}}\",\r\n                \"{{low_se_name_under}}\",\r\n                \"app_searches\",\r\n                \"tasks_ready\"\r\n            ],\r\n            \"data\": {\r\n                \"se_type\": \"organic\",\r\n                \"se\": \"{{low_se_name_under}}\",\r\n                \"api\": \"app_data\",\r\n                \"function\": \"{{low_se_type_under}}\"\r\n            },\r\n            \"result\": [\r\n                {\r\n                    \"id\": \"04221432-2806-0428-0000-0f41c4d141bf\",\r\n                    \"se\": \"{{low_se_name_under}}\",\r\n                    \"date_posted\": \"2022-04-22 11:32:38 +00:00\",\r\n                    \"tag\": \"\",\r\n                    \"endpoint_advanced\": \"\/v3\/app_data\/{{low_se_name_under}}\/{{low_se_type_under}}\/task_get\/advanced\/04221432-2806-0428-0000-0f41c4d141bf\",\r\n                    \"endpoint_html\": \"\/v3\/app_data\/{{low_se_name_under}}\/{{low_se_type_under}}\/task_get\/html\/04221432-2806-0428-0000-0f41c4d141bf\"\r\n                }\r\n            ]\r\n        }\r\n    ]\r\n}<\/pre>\n
<\/pre>