API Documentation

We offer a simple API for users through which meta information of all free Android apps and games can be obtained that exist on Google Play Store. Make a simple GET request by passing in an app's package ID and you will get the information as a JSON response from our servers.

Accessing Information

Here is an example API call where WhatsApp (package ID com.whatsapp) has been taken as an example app. Remember that you can alternatively use our PHP class also if its feasible with your project.

https://apkbucket.net/core/api.php?package=com.whatsapp

Output of above request will look like this:

                {
  "success":true,
  "apkLabel":"WhatsApp",
  "apkPackage":"com.whatsapp",
  "apkVersion":"2.16.133",
  "apkMinOS":"Android 2.1.x",
  "apkTargetOS":"Android 6.0",
  "apkMinAPI":7,
  "apkTargetAPI":23,
  "apkInappPurchases":0,
  "apkRootAccess":0,
  "apkFileLink":"http:\/\/apkbucket.net\/get.php?package=com.whatsapp&token=abc8c23904413c5827ed748333031f82"
}

This (JSON) information can be processed easily using any programming language. For example, in PHP, you can do this:

                $request = file_get_contents('https://apkbucket.net/core/api.php?package=com.whatsapp');
$data = json_decode($request);

Now $data contains all available information about the app and you can print / use it according to the need of your project. For example to check either the app offers in-app purchases or not, you can do this:

                if($data->apkInappPurchases) {

  echo 'Offers in-app purchases';

} else {

    echo 'Does not offer in-app purchases';

}

Here is the explanation of all available information provided by our API as of now:

#	Request	Sample Output	Explanation
1	`$data->apkLabel`	`WhatsApp`	Holds the app's label or name
2	`$data->apkPackage`	`com.whatsapp`	Holds the app's package ID
3	`$data->apkVersion`	`2.16.133`	Holds the app's current version
4	`$data->apkMinOS`	`Android 2.1.x`	Tells the minimum Android version required
5	`$data->apkTargetOS`	`Android 6.0`	Tells the Android version the app is targeted for
6	`$data->apkMinAPI`	`7`	Tells the minimum Android API level supported by the app
7	`$data->apkTargetAPI`	`23`	Tells the Android API level the app is targeted for
8	`$data->apkInappPurchases`	`0`	Returns either 0 or 1 telling if the app offers in-app purchases or not
9	`$data->apkRootAccess`	`0`	Returns either 0 or 1 telling if the app requires root accesss or not
10	`$data->apkLink`	`APK download link`	The download link for the requested app / game's APK file

Our PHP Class

We have written a very simple PHP class which simplifies your job if you are using PHP as your server-side programming language. Download the APKBucket class here and include it to your project's pages like this:

require_once('APKBucket.php');

And then create an instance of the class by passing in any app or game's package ID like this:

$request = new APKBucket('com.whatsapp'); // we are using WhatsApp as our example app

Then we can check either our request was successful or not:

              if($request->isValid()) {

  echo $request->apkLabel(); // will print WhatsApp

} else {

  echo 'Bad request'; // Package ID is invalid or our tool doesn't support it

}

Available Information

All available information (in form of objects) is provided in below table. You can use any or all of them based on your needs. Remember that we are taking WhatsApp (com.whatsapp) as our example app throughout this page.

#	Request	Sample Output	Explanation
1	`$request->apkLabel()`	`WhatsApp`	Holds the app's label or name
2	`$request->apkPackage()`	`com.whatsapp`	Holds the app's package ID
3	`$request->apkVersion()`	`2.16.133`	Holds the app's current version
4	`$request->apkMinOS()`	`Android 2.1.x`	Tells the minimum Android version required
5	`$request->apkTargetOS()`	`Android 6.0`	Tells the Android version the app is targeted for
6	`$request->apkMinAPI()`	`7`	Tells the minimum Android API level supported by the app
7	`$request->apkTargetAPI()`	`23`	Tells the Android API level the app is targeted for
8	`$request->apkInapp()`	`false`	Returns either true or false telling if the app offers in-app purchases or not
9	`$request->apkRoot()`	`false`	Returns either true or false telling if the app requires root accesss or not
10	`$request->apkLink()`	`Download link`	The download link for the requested app / game's APK file

We generate expiring APK download links for each API request and the links expire within a day. We do this to avoid bandwidth abuse. Simply copy the file with the generated download link and you will be having the APK file of the requested app downloaded directly to your server. Here is a possible and clean way to do this in PHP:

copy($request->apkLink(), 'path/' . $request->apkPackage() . '.apk');

Above operation will save the APK file to 'path' directory and we assume that 'path' directory is present in the same directory from where you are making this API call. Also remember that the APK file will be saved with the package ID of the requested app. You should adjust the file path according to the need of your project as well as you can save the copied APK file with a name other than the app's package ID. Remember to add .apk extension to the end of the custom name to ensure that the copied file isn't broken.

API Releases

The history and brief information about different releases of our API. We will be adding more operations in newer versions of our API so you should consider staying up-to-date with disclosed information in this section to ensure that your project's stability is guaranteed.

Version 1.0

Version 1.0 July 15, 2016

Our first API released with a set of basic operations - PHP class