|Supported by OpenApps API:||Yes - With modifications|
|Supported by Internal/Reseller API:||Yes|
|Possibly queued processing:||No|
Purpose: this command returns information on specified download - it is useful to check status of the download backlinks request that was send through previously.
Required: must be set to: GetDownloadsList
Optional - defaults to historic
Optional: if not specified then complete list of downloads for customer account will be returned (this can be very long), if specified it should match the DownloadJobID returned by DownloadBackLinks function it will return data in the same format but only for that download.
Note: This field is mandatory for OpenApps API
Below you can see example of successful XML returned for this function:
This produces the following JSON:
The most interesting data column is numeric Status: it shows current processing status from the following possibilities:
4) ReadyForDownload - once domain has this or PendingNotification status it means that backlinks download is fully done
5) Error - if the error took place during FTP upload (say if FTP server is down) then it will be retried automatically 10 minutes later
6) PendingNotification - only used for downloads that had NotifyURL specified
7) NotificationFailed - only used for downloads that had NotifyURL specified, where the notification failed
In the example above the Status is 4 which means the download is ready.
For more information about access to the Majestic API suite, visit our Plans & Pricing page.