New user?

Returning user?

Forgot your password?

It's completely free!


Register here

Forgot your password?


You're one step closer to becoming a Aptoider!

We will send you a confirmation email to

In the meantime please continue to the final registration step.

Continue to final step Ups... wrong email...

Need to contact us?

Please insert an email address Password must:<br>- have 8 characters minimum<br>- have one letter<br>- have one number OR one special character (!@#$%*) This url is invalid, please enter a valid one. Use only letters, numbers and/or dashes. No spaces please! Please insert a name Business Name should be smaller than 40 characters. Please insert an address. Please insert a company name. Please insert a valid country. Please insert a valid phone number. Please insert a valid phone number. Please insert a city. Please insert a zip/postal code. Please insert a tax ID / VAT. You must agree with terms of use. You must select one option RETRY JOIN NOW
This website uses cookies to improve service quality. By browsing this website, you are consenting the use of cookies.
I understand Learn more

Web Services Documentation

Uploading an Application to a User Repository



Supported Formats:


Supported Methods:



Uploads an application to a user repository (owned by you).
Optional information will be filled with information from other markets, if no information is found an error will be returned.


access_token OAuth2 access token
repo User repository name
mode Return mode/format ('xml' or 'json')
apk Application file (must be '.apk' ): Content-Type: application/
description Application description (optional)
category Application category (integer value, optional):
3 - Comics
4 - Communication
5 - Entertainment
6 - Finance
7 - Lifestyle
8 - Multimedia
9 - News & Weather
10 - Productivity
11 - Reference
12 - Shopping
13 - Social
14 - Sports
15 - Themes
16 - Tools
17 - Travel
18 - Demo
19 - Software Libraries
20 - Arcade & Action (Games)
21 - Brain & Puzzle (Games)
22 - Cards & Casino (Games)
23 - Casual (Games)
24 - News & Magazines
25 - Racing
26 - Music & Audio
27 - Photography
28 - Personalization
29 - Books & Reference
30 - Health & Fitness
31 - Media & Video
32 - Education
33 - Business
34 - Sports Games
35 - Weather
36 - Travel & Local
37 - Transportation
38 - Medical
39 - Libraries & Demo
40 - Personalisation
63 - Transport
1006 - Trivia
1007 - Puzzle
1019 - Arcade Games
1027 - Action Games
1028 - Strategy Games
1029 - Puzzle Games
1030 - Adventure Games
1031 - Word Games
1032 - Casino Games
rating Application age rating (integer value):
1 - All
2 - Pre-Teen (minimal age: 10)
3 - Teen (minimal age: 16)
4 - Mature (minimal age: 18)
apk_phone Application Developer phone number (optional)
apk_email Application Developer email address (optional)
apk_website Application Developer website (optional)
apk_screenshot[] Application screenshots files (optional), '.jpg' and '.png' accepted:
        Content-Type: image/jpeg
        Content-Type: image/png
        Width must be at least 320px. Max files:10
only_user_repo If true, the application gets uploaded only to the repository given in the repo argument. If false or ommited, the application gets uploaded to the official apps repository as well. (optional, boolean [accepted values for TRUE: true, t, 1])
apk_md5sum If set with the application file MD5 hash, the APK is uploaded ignoring the apk argument. (optional)
obb_main Application OBB main file:
main.(apk version code).(apk package).obb
Content-Type: application/
obb_main_md5sum OBB main file MD5 hash, if set the OBB is uploaded ignoring the obb_main argument. (optional)
obb_main_filename OBB main file name. If set, along with obb_main_md5sum as well, Aptoide will ignore obb_main and create a new alias OBB entry in the database with such name if needed (optional).
obb_patch Application OBB patch file:
patch.(apk version code).(apk package).obb
Content-Type: application/
obb_patch_md5sum OBB patch file MD5 hash, if set the OBB is uploaded ignoring the obb_patch argument. (optional)
obb_patch_filename OBB patch file name. If set, along with obb_patch_md5sum as well, Aptoide will ignore obb_patch and create a new alias OBB entry in the database with such name if needed (optional).


status Request result status (OK or FAIL)
errors Errors log from the request (always existent)
icon Icon URL from the uploaded application
url Application web page URL

Error Codes:

Name Description
APK-5 MD5 NOT existent
APK-106 It's not possible to upload the required APK since it is not reliable. If you are the developer/owner of the application, please contact Aptoide Staff.
APK-107 Error uploading your APK file. The APK matched an anti-spam rule. Please contact
AUTH-4 HMAC Authentication failure
QUOTA-1 Daily limit of uploaded apps reached for today. If you need this limit increased please contact support at or upload more apps tomorrow. Trusted apps do not count towards this limit.
FILE-5 The file you sent is missing. Please upload the file again.
FILE-6 Number of uploaded files exceeded. Please contact support at
FILE-100 You need to upload an APK
FILE-101 The OBB format upload is not currently supported.
FILE-102 One or more screenshots failed to be uploaded.
FILE-316 A patch OBB file was detected, but no main OBB file. Please upload a main OBB file with the patch OBB file.
IARG-1 Invalid repo
IARG-2 Invalid token
IARG-202 Invalid upload_from!
IARG-300 Invalid user_categs!
MARG-4 Missing token parameter
MARG-5 Missing apk parameter
OBB-1 OBB main MD5 NOT existent!
OBB-2 OBB patch MD5 NOT existent!
SYS-1 An unknown error occurred, please try again.

Using the Web Service (examples):

Sample Response - XML:

Sample success

        <url> Master</url>

Sample Response - JSON:

Sample success

   "status": "OK",
   "info": {
        "icon": "",
        "url": " Master",