Aptoide - Web Services Documentation

listReviews

URLS:

GET

https://ws75.aptoide.com/api/7/reviews/get

https://ws75.aptoide.com/api/7/listReviews

Supported Formats:

JSON

Supported Methods:

GET

Description:

Get a list of reviews

Arguments:

Name

Description

Input

Details

apk_id

Apk file ID.

+INT31

Default:	null
Example:	2422529

apk_md5sum

Apk file md5sum.

HEXADECIMAL

Default:	null
Properties:	• Length: 32
Example:	"aefde962dae50881d4353089fa8039f1"

app_id

Application ID.

+INT31

Default:	null
Example:	7306243

cdn

CDN type selector.

STRING

Default:	"pool"
Properties:	• Allowed values: "pool", "web", "apw", "cdn9"
Example:	"web"

info

Show API info page.

BOOLEAN

Default:	false
Example:	true

language

Language.

STRING

Default:	"en"
Properties:	• Min length: 2 • Max length: 6
Example:	"pt_PT"

languages_filter_sort

Languages filter sort.

STRING

Default:	null
Example:	"pt_PT,en_GB"

limit

Lists items limit.

+INT31_NULL

Default:	25
Example:	15

offset

Lists items offset.

UINT32

Default:	0
Example:	5

order

List order direction.

STRING

Default:	null
Properties:	• Allowed values: "ASC", "DESC" • Upper case
Example:	"ASC"

package_id

Apk package ID.

+INT31

Default:	null
Example:	240

package_name

Apk package name.

PACKAGE_NAME

Default:	null
Example:	"cm.aptoide.pt"

refresh

Refresh request.

BOOLEAN

Default:	false
Example:	true

review_groups

Review groups.

LIST

Default:	[]
Properties:	• Max length: 4• Input (STRING): › Allowed values: "store_owner", "auto_highlighted", "highlighted", "others"
Example:	["owner"]

review_type

Review type.

STRING

Default:	"STORE_PACKAGE"
Properties:	• Allowed values: "STORE_PACKAGE"
Example:	"STORE_PACKAGE"

sort

List sort type.

STRING

Default:	"latest"
Properties:	• Allowed values: "latest", "points", "rating", "latest_more", "points_more", "rating_more"
Example:	"points"

store_id

Store ID.

+INT31

Default:	null
Example:	15

store_name

Store name.

DOMAIN_LABEL

Default:	null
Example:	"apps"

store_pass_sha1

Store private password SHA1.

HEXADECIMAL

Default:	null
Properties:	• Length: 40
Example:	"85136c79cbf9fe36bb9d05d0639c70c265c18d37"

store_user

Store private username.

STRING

Default:	null
Properties:	• Max length: 128
Example:	"aptuser1000"

sub_limit

Lists items sub limit

+INT31_NULL

Default:	null
Example:	15

tag_name

Tag name.

DOMAIN_LABEL

Default:	null
Example:	"community"

tag_type

Tag type.

STRING

Default:	null
Example:	"custom"

view

View mode of internal responses.

STRING

Default:	"url"
Properties:	• Allowed values: "url", "response"
Example:	"response"

Mandatory arguments:

This endpoint requires 1 of the following possible combinations of arguments:

• app_id

• apk_id

• apk_md5sum

• package_id

• package_name

• store_id

• store_name

• tag_name AND tag_type

Arguments Aliases:

This endpoint has the following possible arguments aliases:

• language : lang

• view : nview

Inputs:

Name	Description	Examples
+INT31	31 bits positive integer: 1 to 2147483647	• 1 • 5024 • 70733
+INT31_NULL	31 bits positive nullable integer: 0 to 2147483647 (0 = NULL)	• 0 • 5024 • 70733
BOOLEAN	Boolean: FALSE (0, f, false, no, off) or TRUE (1, t, true, yes, on)	• 0 • 1 • true • "f"
DOMAIN_LABEL	Web domain label	• "site" • "my-domain-label" • "some-other-domain-label"
HEXADECIMAL	String of hexadecimal characters	• "e602a3" • "ff406b8c63e96a963ce592" • "8843d7f92416211de9ebb963ff4ce28125932878"
LIST	List of items as: String of characters	• "a,foobar,Some text" • ["a", "foobar", "Some text"]
PACKAGE_NAME	Java package name	• "com.package.vendor" • "cm.aptoide.pt" • "com.android.package.sub.foobar"
STRING	String of characters	• "a" • "foobar" • "Some text"
UINT32	32 bits unsigned integer: 0 to 4294967295	• 0 • 5024 • 60422124

Response:

• application/json

Error Codes:

Name	Description	Http Code
API-1	Invalid value ... for argument '...'	400 Bad Request
API-2	Invalid output '...'	400 Bad Request
API-3	Missing mandatory arguments '...'	400 Bad Request
API-4	At least 1 node must be set	400 Bad Request
API-5	Malformed node at ...	400 Bad Request
API-6	Invalid node '...'	400 Bad Request
API-7	Missing mandatory arguments '...' for condition '...'	400 Bad Request
APP-1	Application '...' not found	404 Not Found
APP-2	Application '...' is pending approval	403 Forbidden
APP-3	Application '...' is private: authentication required	401 Unauthorized
APP-4	Application '...' is private: authentication failed (invalid '...')	401 Unauthorized
APP-5	Application '...' is private: access denied	403 Forbidden
APP-6	Application '...' is not available	410 Gone
APP-7	Application '...' was suspended	410 Gone
APP-8	Application '...' was removed	410 Gone
APP-9	Application '...' is infected	410 Gone
APP-10	Application '...' is not available in your country	403 Forbidden
APP-11	Application '...' is currently being deleted	410 Gone
APP-12	Application '...' was deleted	410 Gone
AUTH-1	Authentication required	401 Unauthorized
AUTH-2	Authentication failed: invalid '...'	401 Unauthorized
AUTH-3	Authentication failed: expired '...'	401 Unauthorized
AUTH-4	Authentication error	500 Internal Server Error
AUTH-5	Access denied: access level ... required	403 Forbidden
AUTH-6	Access denied: not in allowed groups	403 Forbidden
AUTH-7	Access denied: not in allowed countries	403 Forbidden
AUTH-8	Access denied: not in allowed IP addresses	403 Forbidden
AUTH-9	Access denied: not in allowed domains	403 Forbidden
AUTH-10	Access denied: not in allowed origins (CORS)	403 Forbidden
AUTH-11	Access denied: unauthorized user	403 Forbidden
AUTH-12	Access denied: unauthorized operation	403 Forbidden
COMMENT-1	Comment '...' not found	404 Not Found
COMMENT-2	Operation not allowed for comment	403 Forbidden
GROUP-1	Group '...' not found	404 Not Found
REVIEW-1	Review '...' not found	404 Not Found
REVIEW-2	Operation not allowed for review	403 Forbidden
STORE-1	Store '...' not found	404 Not Found
STORE-2	Store '...' is pending approval	403 Forbidden
STORE-3	Store '...' is private: authentication required	401 Unauthorized
STORE-4	Store '...' is private: authentication failed (invalid '...')	401 Unauthorized
STORE-5	Store '...' is private: access denied	403 Forbidden
STORE-6	Store '...' was closed	403 Forbidden
STORE-7	Store '...' was suspended	410 Gone
SYS-0	(╯°□°）╯︵ ┻━┻	417 Expectation Failed
SYS-1	An unknown system error occurred, please try again	500 Internal Server Error
SYS-2	The system is down for maintenance, please try again later	503 Service Unavailable
SYS-3	Operation timed out, please try again later	504 Gateway Timeout
USER-0	User not specified	400 Bad Request
USER-1	User '...' not found	404 Not Found
USER-2	User '...' is pending approval	403 Forbidden
USER-3	User '...' is private: authentication required	401 Unauthorized
USER-4	User '...' is private: access denied	403 Forbidden
USER-5	User '...' was suspended	410 Gone

Sample Request URL:

https://ws75.aptoide.com/api/7/reviews/get/package_name=cm.aptoide.pt/store_name=apps/limit=3

Sample Response (json):

{
   "info": {
      "status": "OK",
      "time": {
         "seconds": 0.018617868423462,
         "human": "18 milliseconds"
      }
   },
   "datalist": {
      "total": 3270,
      "count": 3,
      "offset": 0,
      "limit": 3,
      "next": 3,
      "hidden": 0,
      "loaded": true,
      "list": [
         {
            "id": 4984615,
            "title": "Was good before",
            "body": "Ridiculously Slow downloading speed, Tried to switch to faster internet, But its not the internet Its the download manager itself, Cannot downgrade because older version Is not working anymore, I find the app Turned for the worse now",
            "intro": null,
            "outro": null,
            "added": "2018-10-31 14:10:20",
            "modified": "2018-10-31 14:10:20",
            "user": {
               "id": 14327542,
               "name": "Trintity Xyz.janjan",
               "access": "PUBLIC",
               "avatar": "http://pool.img.aptoide.com/apps/87903304c1f5b803337bee93c49c19da_avatar.jpg"
            },
            "items": [],
            "stats": {
               "rating": 1,
               "points": 1
            },
            "comments": {
               "total": 0,
               "view": "https://ws75.aptoide.com/api/7/listComments/review_id=4984615/limit=1/cdn=pool/sort=latest/order=desc"
            },
            "badges": ["auto_highlighted"]
         },
         {
            "id": 4972128,
            "title": "muito ruim",
            "body": "eu tento baixar um jogo pago e n\u00e3o d\u00e1,vcs ficam falando q estou sem espa\u00e7o e estou cheio de mem\u00f3ria e s\u00f3 da q eu n\u00e3o tenho mem\u00f3ria vcs nunca fizeram isso antes para mim agora estou chateado com vcs....por favor ageite esse erro e ficarei alegre com vcs\ud83d\ude1e\ud83d\ude12",
            "intro": null,
            "outro": null,
            "added": "2018-10-26 01:13:30",
            "modified": "2018-10-26 01:13:30",
            "user": {
               "id": 26179648,
               "name": "Elysandro Da Silva",
               "access": "PUBLIC",
               "avatar": "http://pool.img.aptoide.com/apps/ca21e24d2ac91062c72c5fb3fdce546e_avatar.jpg"
            },
            "items": [],
            "stats": {
               "rating": 2,
               "points": 1
            },
            "comments": {
               "total": 0,
               "view": "https://ws75.aptoide.com/api/7/listComments/review_id=4972128/limit=1/cdn=pool/sort=latest/order=desc"
            },
            "badges": ["auto_highlighted"]
         },
         {
            "id": 4967283,
            "title": "L\u1ed7i app",
            "body": "\u1ee8ng d\u1ee5ng ph\u1ea3n h\u1ed3i qu\u00e1 ch\u1eadm b\u1ea5m v\u00e0o \u0111\u1ee3i 2-3s m\u1edbi v\u00f4 \u0111c, khi tho\u00e1t ra v\u00e0o l\u1ea1i ph\u1ea3i \u0111\u0103ng nh\u1eadp l\u1ea1i t\u1eeb \u0111\u1ea7u",
            "intro": null,
            "outro": null,
            "added": "2018-10-23 16:45:35",
            "modified": "2018-10-23 16:45:35",
            "user": {
               "id": 21326823,
               "name": "\u0110inh V\u0103n C\u01a1",
               "access": "UNLISTED",
               "avatar": "http://pool.img.aptoide.com/apps/f082093ebb9658e77e9395d46118ef29_avatar.jpg"
            },
            "items": [],
            "stats": {
               "rating": 1,
               "points": 0
            },
            "comments": {
               "total": 0,
               "view": "https://ws75.aptoide.com/api/7/listComments/review_id=4967283/limit=1/cdn=pool/sort=latest/order=desc"
            },
            "badges": ["auto_highlighted"]
         }
      ]
   }
}