App Review Analysis API


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

Definition

Endpoint:

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

Hits per request:

3

Rate limit:

3 QPS

Required plan:

basic or above.

Parameters

Name Required Description Available Values Default
access_token required Your access token for using this API. You can get it for FREE by signing up .
id required The app ID on the iTunes store - (e.g for Facebook the ID is 284882215). Existing App ID on iTunes Store
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
trackId String Numeric unique identifier for the app assigned by Apple
trackCensoredName String App title
sellerName String Seller company name (developer name)
userRatingCount Integer Number of ratings of the app for all versions
averageUserRating Double The average rating of the app for all versions (from 0 to 5, 5 highest)
artworkUrl512 URL Icon image with 512px square sizes
artworkUrl100 URL Icon image with 100px square sizes
formattedPrice String Price and currency of the app
trackViewUrl URL Link to the app on the Apple App Store
number_topics Integer Number of topics returned
total_reviews Integer 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

Example Response

{
	"artworkUrl512": "https://is2-ssl.mzstatic.com/image/thumb/Purple128/v4/2f/49/52/2f495213-1fc4-a9e4-d6e0-203de6cf137f/source/512x512bb.jpg",
	"bundleId": "com.mojang.minecraftpe",
	"trackId": 479516143,
	"trackCensoredName": "Minecraft",
	"userRatingCount": 631972,
	"formattedPrice": "$6.99",
	"averageUserRating": 4.5,
	"artworkUrl100": "https://is2-ssl.mzstatic.com/image/thumb/Purple128/v4/2f/49/52/2f495213-1fc4-a9e4-d6e0-203de6cf137f/source/100x100bb.jpg",
	"sellerName": "Mojang AB",
	"market_source": "ITUNES",
	"market_status": "PUBLISHED",
	"topics": [
		{
			"positive": 0.66855524079281,
			"topic_name": "Update",
			"negative": 0.33144475920719,
			"reviews": 16241,
			"average_rating": 3.8307370235823,
			"topic_id": "update",
			"reviews_percentage": 0.14563568213203
		},
		{
			"positive": 0.64071168930437,
			"topic_name": "Stability",
			"negative": 0.35928831069563,
			"reviews": 9874,
			"average_rating": 3.2365809195868,
			"topic_id": "stability",
			"reviews_percentage": 0.088541760074607
		},
		{
			"positive": 0.6555727554144,
			"topic_name": "General Feedback",
			"negative": 0.3444272445856,
			"reviews": 6091,
			"average_rating": 4.5339024790675,
			"topic_id": "general_feedback",
			"reviews_percentage": 0.05461898527592
		},
		{
			"positive": 0.71692239792567,
			"topic_name": "Signup & Login",
			"negative": 0.28307760207433,
			"reviews": 3648,
			"average_rating": 3.531798245614,
			"topic_id": "signup_experience",
			"reviews_percentage": 0.03271220789469
		},
		{
			"positive": 0.34793187347841,
			"topic_name": "User Interface & UX",
			"negative": 0.65206812652159,
			"reviews": 3644,
			"average_rating": 3.5834248079034,
			"topic_id": "user_interface",
			"reviews_percentage": 0.032676339245682
		},
		{
			"positive": 0.52837377180527,
			"topic_name": "Pricing & Payments",
			"negative": 0.47162622819473,
			"reviews": 2347,
			"average_rating": 3.2999573924159,
			"topic_id": "pricing_payments",
			"reviews_percentage": 0.021045929805054
		},
		{
			"positive": 0.57230893034813,
			"topic_name": "Audio",
			"negative": 0.42769106965187,
			"reviews": 1838,
			"average_rating": 3.9363438520131,
			"topic_id": "audio",
			"reviews_percentage": 0.01648164421887
		},
		{
			"positive": 0.72687838054836,
			"topic_name": "Video",
			"negative": 0.27312161945164,
			"reviews": 1485,
			"average_rating": 4.1468013468013,
			"topic_id": "video",
			"reviews_percentage": 0.013316235943973
		},
		{
			"positive": 0.71390587609624,
			"topic_name": "Connectivity",
			"negative": 0.28609412390376,
			"reviews": 1332,
			"average_rating": 3.6066066066066,
			"topic_id": "connectivity",
			"reviews_percentage": 0.011944260119443
		},
		{
			"positive": 0.632336655592,
			"topic_name": "Translation & Internationalization",
			"negative": 0.367663344408,
			"reviews": 871,
			"average_rating": 4.2881745120551,
			"topic_id": "translation_internationalization",
			"reviews_percentage": 0.0078103983213472
		},
		{
			"positive": 0.68187289963257,
			"topic_name": "Privacy",
			"negative": 0.31812710036743,
			"reviews": 759,
			"average_rating": 4.1778656126482,
			"topic_id": "privacy",
			"reviews_percentage": 0.0068060761491418
		},
		{
			"positive": 0.66156160673871,
			"topic_name": "Device Compatibility",
			"negative": 0.33843839326129,
			"reviews": 644,
			"average_rating": 3.860248447205,
			"topic_id": "device_compatibility",
			"reviews_percentage": 0.005774852490181
		},
		{
			"positive": 0.54599089047114,
			"topic_name": "Resource Usage",
			"negative": 0.45400910952886,
			"reviews": 601,
			"average_rating": 3.8535773710483,
			"topic_id": "resource_usage",
			"reviews_percentage": 0.0053892645133521
		},
		{
			"positive": 0.77364628371363,
			"topic_name": "Uninstall",
			"negative": 0.22635371628637,
			"reviews": 476,
			"average_rating": 3.4075630252101,
			"topic_id": "uninstall",
			"reviews_percentage": 0.0042683692318729
		},
		{
			"positive": 0.67981961668385,
			"topic_name": "Notifications & Alerts",
			"negative": 0.32018038331615,
			"reviews": 340,
			"average_rating": 3.8117647058824,
			"topic_id": "notification_alerts",
			"reviews_percentage": 0.0030488351656235
		},
		{
			"positive": 0.661202185791,
			"topic_name": "Tutorial",
			"negative": 0.338797814209,
			"reviews": 181,
			"average_rating": 4.2375690607735,
			"topic_id": "tutorial",
			"reviews_percentage": 0.0016230563675819
		},
		{
			"positive": 0.72162386081096,
			"topic_name": "Advertising",
			"negative": 0.27837613918904,
			"reviews": 113,
			"average_rating": 4,
			"topic_id": "advertising",
			"reviews_percentage": 0.0010132893344572
		},
		{
			"positive": 0.69411764705841,
			"topic_name": "Location Services",
			"negative": 0.30588235294159,
			"reviews": 67,
			"average_rating": 4.5373134328358,
			"topic_id": "location_services",
			"reviews_percentage": 0.00060079987087286
		}
	],
	"number_topics": 18,
	"total_reviews": 50552
}

Last Modified: 2018-11-11


Automate your workflow


Bring app data into your existing workflow, dashboards, CRM, messaging platforms and many more services! Here a selection of third-party services we support:



Email

Salesforce

HubSpot

Slack

Intercom

Pipedrive

Zendesk

Gekoboard

Klipfolio

Dynamics


And many more!


GET FREE INTEGRATIONS via Zapier!