Review Analysis API for Android Apps

Advanced sentiment analysis and clustering into 18+ specific topics optimized for the mobile industry based on app reviews on Google Play Store.

Definition

Endpoint:

GET https://data.42matters.com/api/v3.0/android/apps/topics.json

Hits per request:

Rate limit:

3 QPS

Required plan:

Medium or above.

Parameters

Name	Required	Description	Available Values
access_token	required	Your access token for using this API. You can get it for FREE by signing up.
p	required	The package name identifying an Android application.	Any publicly available Android app package name
callback	optional	If supplied, the response will use the JSONP format with a callback of the given name.

Responses

Status Code

Indication

Content-Type

Body

200

Everything is OK

application/json

Attribute	Type	Description
package_name	String	The app package name (unique identifier)
title	String	App title
developer	String	App developer name
number_ratings	Long	Number of app ratings
rating	Double	App rating (from 0 to 5, 5 highest)
icon	URL	Full-sized icon. Format can be either webp or png. In order to request png format, remove the trailing "-rw" from the url.
icon_72	URL	App icon (72x72 pixels)
price	String	App price with currency (if paid)
market_url	URL	A deep link to the app page on Google Play
number_topics	Long	Number of topics returned
total_reviews	Long	Number of reviews available based on query/filters used
topics	Array of Objects	Sorted list of reviews objects in the response. Each reviews contains: topic_id, topic_name, reviews, reviews_percentage, average_rating, positive and negative fields.

404

The package name is not found

application/json

Error object

402

Your request exceeds what's allowed by your current subscription plan

application/json

Error object

403

Your access token is not valid

application/json

Error object

429

Your request rate is over the limit

application/json

Error object

Example Request

Review Analysis for Minecraft: Dream it, Build it! on Google Play:

https://data.42matters.com/api/v3.0/android/apps/topics.json?p=com.mojang.minecraftpe&access_token=YOUR_ACCESS_TOKEN

This request can also be imported into Postman. Check out our Postman integration guide.

Example Response

{
  "review_analysis": {
    "package_name": "com.mojang.minecraftpe",
    "price": "$6.99",
    "rating": 4.37399435043335,
    "title": "Minecraft: Dream it, Build it!",
    "developer": "Mojang",
    "number_ratings": 5384242,
    "icon": "https://play-lh.googleusercontent.com/27O5tpaYE82W6m30rJ_MX3-UvshlDM6O8oXDxb6GseYW2T7P8UNT19727MGmz-0q3w=s180",
    "icon_72": "https://play-lh.googleusercontent.com/27O5tpaYE82W6m30rJ_MX3-UvshlDM6O8oXDxb6GseYW2T7P8UNT19727MGmz-0q3w=s180-rw",
    "market_source": "GOOGLE",
    "market_status": "PUBLISHED",
    "market_url": "https://play.google.com/store/apps/details?id=com.mojang.minecraftpe&referrer=utm_source%3D42matters.com%26utm_medium%3Dapi",
    "deep_link": "https://play.google.com/store/apps/details?id=com.mojang.minecraftpe&referrer=utm_source%3D42matters.com%26utm_medium%3Dapi",
    "topics": [
      {
        "topic_id": "general_feedback",
        "topic_name": "General Feedback",
        "reviews": 683099,
        "reviews_percentage": 0.6773315220894087,
        "positive": 0.5043719961913469,
        "negative": 0.49562800380865313,
        "average_rating": 4.368185285002613
      },
      {
        "topic_id": "update",
        "topic_name": "Update",
        "reviews": 110719,
        "reviews_percentage": 0.10978418764222644,
        "positive": 0.7306425167703059,
        "negative": 0.2693574832296941,
        "average_rating": 3.877311030627083
      },
      {
        "topic_id": "stability",
        "topic_name": "Stability",
        "reviews": 109769,
        "reviews_percentage": 0.1088422085938236,
        "positive": 0.5799599078874049,
        "negative": 0.4200400921125951,
        "average_rating": 3.3818473339467428
      },
      {
        "topic_id": "signup_experience",
        "topic_name": "Signup & Login",
        "reviews": 28481,
        "reviews_percentage": 0.028240531871117434,
        "positive": 0.5931801559440615,
        "negative": 0.4068198440559385,
        "average_rating": 2.85274393455286
      },
      {
        "topic_id": "user_interface",
        "topic_name": "User Interface & UX",
        "reviews": 25339,
        "reviews_percentage": 0.02512506011313664,
        "positive": 0.29607777707204674,
        "negative": 0.7039222229279533,
        "average_rating": 3.9975137140376495
      },
      {
        "topic_id": "pricing_payments",
        "topic_name": "Pricing & Payments",
        "reviews": 17293,
        "reviews_percentage": 0.01714699335161103,
        "positive": 0.5991291484462646,
        "negative": 0.40087085155373536,
        "average_rating": 3.6754756259758286
      },
      {
        "topic_id": "connectivity",
        "topic_name": "Connectivity",
        "reviews": 7364,
        "reviews_percentage": 0.007301824960461669,
        "positive": 0.5065166185055016,
        "negative": 0.49348338149449844,
        "average_rating": 3.131450298750679
      },
      {
        "topic_id": "translation_internationalization",
        "topic_name": "Translation & Internationalization",
        "reviews": 6286,
        "reviews_percentage": 0.006232926629747698,
        "positive": 0.46962058537507834,
        "negative": 0.5303794146249217,
        "average_rating": 3.8829144129812283
      },
      {
        "topic_id": "resource_usage",
        "topic_name": "Resource Usage",
        "reviews": 4550,
        "reviews_percentage": 0.004511583863403122,
        "positive": 0.3801011987288861,
        "negative": 0.619898801271114,
        "average_rating": 3.132087912087912
      },
      {
        "topic_id": "uninstall",
        "topic_name": "Uninstall",
        "reviews": 4387,
        "reviews_percentage": 0.004349960089835054,
        "positive": 0.6711252588689214,
        "negative": 0.3288747411310786,
        "average_rating": 3.0186915887850465
      },
      {
        "topic_id": "advertising",
        "topic_name": "Advertising",
        "reviews": 3746,
        "reviews_percentage": 0.003714372121386395,
        "positive": 0.8860994266855907,
        "negative": 0.11390057331440928,
        "average_rating": 4.541110517885745
      },
      {
        "topic_id": "device_compatibility",
        "topic_name": "Device Compatibility",
        "reviews": 2819,
        "reviews_percentage": 0.0027951988815238245,
        "positive": 0.5258859724556829,
        "negative": 0.4741140275443171,
        "average_rating": 3.0794608017027314
      },
      {
        "topic_id": "privacy",
        "topic_name": "Privacy & Security",
        "reviews": 1913,
        "reviews_percentage": 0.0018968483364154227,
        "positive": 0.4006786135439301,
        "negative": 0.5993213864560699,
        "average_rating": 3.3214845791949816
      },
      {
        "topic_id": "audio",
        "topic_name": "Audio",
        "reviews": 1527,
        "reviews_percentage": 0.001514107375695949,
        "positive": 0.36136683782019485,
        "negative": 0.6386331621798051,
        "average_rating": 4.003274394237066
      },
      {
        "topic_id": "tutorial",
        "topic_name": "Tutorial",
        "reviews": 740,
        "reviews_percentage": 0.0007337521008611671,
        "positive": 0.6001636331229261,
        "negative": 0.3998363668770739,
        "average_rating": 3.689189189189189
      },
      {
        "topic_id": "notification_alerts",
        "topic_name": "Notifications & Alerts",
        "reviews": 360,
        "reviews_percentage": 0.00035696048150002727,
        "positive": 0.3679361005429175,
        "negative": 0.6320638994570825,
        "average_rating": 2.9305555555555554
      },
      {
        "topic_id": "video",
        "topic_name": "Video",
        "reviews": 100,
        "reviews_percentage": 9.915568930556313e-5,
        "positive": 0.643723171858183,
        "negative": 0.35627682814181705,
        "average_rating": 4.29
      },
      {
        "topic_id": "location_services",
        "topic_name": "Location Services",
        "reviews": 23,
        "reviews_percentage": 2.280580854027952e-5,
        "positive": 0.6519116271504767,
        "negative": 0.3480883728495233,
        "average_rating": 3.739130434782609
      }
    ],
    "number_topics": 18,
    "total_reviews": 1008515
  },
  "review_analysis_6m": {
    "topics": [
      {
        "topic_id": "general_feedback",
        "topic_name": "General Feedback",
        "reviews": 58444,
        "reviews_percentage": 0.6876492805120542,
        "positive": 0.45623256209311364,
        "negative": 0.5437674379068864,
        "average_rating": 4.192252412565875
      },
      {
        "topic_id": "stability",
        "topic_name": "Stability",
        "reviews": 9426,
        "reviews_percentage": 0.1109058606205363,
        "positive": 0.550842754992471,
        "negative": 0.44915724500752896,
        "average_rating": 3.0311903246339913
      },
      {
        "topic_id": "update",
        "topic_name": "Update",
        "reviews": 6378,
        "reviews_percentage": 0.07504323987245709,
        "positive": 0.6320426657210005,
        "negative": 0.36795733427899946,
        "average_rating": 3.416745061147695
      },
      {
        "topic_id": "signup_experience",
        "topic_name": "Signup & Login",
        "reviews": 3156,
        "reviews_percentage": 0.03713334353049146,
        "positive": 0.5072267143722266,
        "negative": 0.49277328562777345,
        "average_rating": 2.349809885931559
      },
      {
        "topic_id": "pricing_payments",
        "topic_name": "Pricing & Payments",
        "reviews": 2152,
        "reviews_percentage": 0.02532032803473309,
        "positive": 0.53172379495738,
        "negative": 0.46827620504262,
        "average_rating": 3.3238847583643123
      },
      {
        "topic_id": "user_interface",
        "topic_name": "User Interface & UX",
        "reviews": 1882,
        "reviews_percentage": 0.02214352107870245,
        "positive": 0.2530520209818662,
        "negative": 0.7469479790181338,
        "average_rating": 3.6546227417640806
      },
      {
        "topic_id": "translation_internationalization",
        "topic_name": "Translation & Internationalization",
        "reviews": 1079,
        "reviews_percentage": 0.012695461872433552,
        "positive": 0.5296008335894655,
        "negative": 0.4703991664105345,
        "average_rating": 4.052826691380909
      },
      {
        "topic_id": "connectivity",
        "topic_name": "Connectivity",
        "reviews": 564,
        "reviews_percentage": 0.006635996752597334,
        "positive": 0.2638866400801173,
        "negative": 0.7361133599198827,
        "average_rating": 2.49822695035461
      },
      {
        "topic_id": "resource_usage",
        "topic_name": "Resource Usage",
        "reviews": 476,
        "reviews_percentage": 0.005600593003965126,
        "positive": 0.31714677106980793,
        "negative": 0.6828532289301921,
        "average_rating": 2.7983193277310923
      },
      {
        "topic_id": "advertising",
        "topic_name": "Advertising",
        "reviews": 364,
        "reviews_percentage": 0.004282806414796861,
        "positive": 0.8835213471855627,
        "negative": 0.11647865281443726,
        "average_rating": 4.478021978021978
      },
      {
        "topic_id": "device_compatibility",
        "topic_name": "Device Compatibility",
        "reviews": 362,
        "reviews_percentage": 0.0042592745114188564,
        "positive": 0.4914595911958064,
        "negative": 0.5085404088041936,
        "average_rating": 2.5718232044198897
      },
      {
        "topic_id": "uninstall",
        "topic_name": "Uninstall",
        "reviews": 340,
        "reviews_percentage": 0.004000423574260804,
        "positive": 0.7238501380107676,
        "negative": 0.2761498619892324,
        "average_rating": 2.697058823529412
      },
      {
        "topic_id": "privacy",
        "topic_name": "Privacy & Security",
        "reviews": 145,
        "reviews_percentage": 0.001706062994905343,
        "positive": 0.3493452144228139,
        "negative": 0.650654785577186,
        "average_rating": 2.8689655172413793
      },
      {
        "topic_id": "tutorial",
        "topic_name": "Tutorial",
        "reviews": 88,
        "reviews_percentage": 0.0010354037486322082,
        "positive": 0.43625606428549474,
        "negative": 0.5637439357145053,
        "average_rating": 3.034090909090909
      },
      {
        "topic_id": "audio",
        "topic_name": "Audio",
        "reviews": 70,
        "reviews_percentage": 0.0008236166182301655,
        "positive": 0.507159737920012,
        "negative": 0.492840262079988,
        "average_rating": 3.742857142857143
      },
      {
        "topic_id": "notification_alerts",
        "topic_name": "Notifications & Alerts",
        "reviews": 58,
        "reviews_percentage": 0.0006824251979621372,
        "positive": 0.18537690846280572,
        "negative": 0.8146230915371943,
        "average_rating": 2.293103448275862
      },
      {
        "topic_id": "video",
        "topic_name": "Video",
        "reviews": 9,
        "reviews_percentage": 0.00010589356520102129,
        "positive": 0.6386332175729169,
        "negative": 0.3613667824270831,
        "average_rating": 3.5555555555555554
      }
    ],
    "number_topics": 17,
    "total_reviews": 84991
  }
}

Last Modified: 03 May 2023

Automate Your Workflow With 42matters’ APIs

Integrate app data and intelligence into your existing workflows, dashboards, CRM platforms, messaging platforms, and more! Below is a selection of the third-party services that are compatible with 42matters’ APIs: