Review Analysis API for iOS Apps

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:

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.
id	required	The app ID on the Apple App Store - (e.g for Facebook the ID is 284882215).	Existing App ID on Apple App 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
bundleId	String	Unique identifier for the app assigned by the developer
trackCensoredName	String	App title
sellerName	String	Seller company name (developer name)
userRatingCount	Long	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	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 track id/bundle id 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 Apple App Store:

https://data.42matters.com/api/v3.0/ios/apps/topics.json?id=479516143&access_token=YOUR_ACCESS_TOKEN

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

Example Response

{
  "review_analysis": {
    "artworkUrl100": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/e4/d0/ad/e4d0adb4-b29c-db45-d24f-2e83e253c08c/AppIcon-0-0-1x_U007emarketing-0-10-0-85-220.png/100x100bb.jpg",
    "artworkUrl512": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/e4/d0/ad/e4d0adb4-b29c-db45-d24f-2e83e253c08c/AppIcon-0-0-1x_U007emarketing-0-10-0-85-220.png/512x512bb.jpg",
    "averageUserRating": 4.49913,
    "bundleId": "com.mojang.minecraftpe",
    "formattedPrice": "$6.99",
    "sellerName": "Mojang AB",
    "trackCensoredName": "Minecraft: Dream it, Build it!",
    "trackId": 479516143,
    "userRatingCount": 760130,
    "market_source": "ITUNES",
    "market_status": "PUBLISHED",
    "topics": [
      {
        "topic_id": "general_feedback",
        "topic_name": "General Feedback",
        "reviews": 217722,
        "reviews_percentage": 0.45482595316831453,
        "positive": 0.4608983658170414,
        "negative": 0.5391016341829586,
        "average_rating": 4.190508997712679
      },
      {
        "topic_id": "update",
        "topic_name": "Update",
        "reviews": 132307,
        "reviews_percentage": 0.27639217619643486,
        "positive": 0.775450933547999,
        "negative": 0.224549066452001,
        "average_rating": 4.040534514424785
      },
      {
        "topic_id": "stability",
        "topic_name": "Stability",
        "reviews": 82594,
        "reviews_percentage": 0.1725406471371004,
        "positive": 0.5204326105928293,
        "negative": 0.4795673894071707,
        "average_rating": 3.4636777489890305
      },
      {
        "topic_id": "signup_experience",
        "topic_name": "Signup & Login",
        "reviews": 13745,
        "reviews_percentage": 0.02871360141050736,
        "positive": 0.5932826126184724,
        "negative": 0.40671738738152763,
        "average_rating": 3.1594034194252454
      },
      {
        "topic_id": "user_interface",
        "topic_name": "User Interface & UX",
        "reviews": 11426,
        "reviews_percentage": 0.023869160401342824,
        "positive": 0.22964474362157097,
        "negative": 0.770355256378429,
        "average_rating": 3.746192893401015
      },
      {
        "topic_id": "pricing_payments",
        "topic_name": "Pricing & Payments",
        "reviews": 7227,
        "reviews_percentage": 0.015097358850035408,
        "positive": 0.6646348498626027,
        "negative": 0.3353651501373973,
        "average_rating": 3.8664729486647293
      },
      {
        "topic_id": "connectivity",
        "topic_name": "Connectivity",
        "reviews": 4828,
        "reviews_percentage": 0.010085796115673302,
        "positive": 0.5308955817237613,
        "negative": 0.4691044182762387,
        "average_rating": 3.323529411764706
      },
      {
        "topic_id": "resource_usage",
        "topic_name": "Resource Usage",
        "reviews": 1938,
        "reviews_percentage": 0.004048523792911114,
        "positive": 0.37418728241368765,
        "negative": 0.6258127175863124,
        "average_rating": 3.5933952528379773
      },
      {
        "topic_id": "advertising",
        "topic_name": "Advertising",
        "reviews": 1779,
        "reviews_percentage": 0.0037163693640809453,
        "positive": 0.8782827085951384,
        "negative": 0.12171729140486165,
        "average_rating": 4.374929735806633
      },
      {
        "topic_id": "audio",
        "topic_name": "Audio",
        "reviews": 1453,
        "reviews_percentage": 0.0030353483339008508,
        "positive": 0.29086437270179116,
        "negative": 0.7091356272982088,
        "average_rating": 3.8320715760495525
      },
      {
        "topic_id": "privacy",
        "topic_name": "Privacy & Security",
        "reviews": 1073,
        "reviews_percentage": 0.002241520139212397,
        "positive": 0.369482578861218,
        "negative": 0.6305174211387821,
        "average_rating": 3.4594594594594597
      },
      {
        "topic_id": "device_compatibility",
        "topic_name": "Device Compatibility",
        "reviews": 735,
        "reviews_percentage": 0.001535430850252667,
        "positive": 0.5897937310163883,
        "negative": 0.4102062689836117,
        "average_rating": 3.496598639455782
      },
      {
        "topic_id": "tutorial",
        "topic_name": "Tutorial",
        "reviews": 673,
        "reviews_percentage": 0.001405911513224551,
        "positive": 0.6628341048968591,
        "negative": 0.3371658951031409,
        "average_rating": 4.081723625557206
      },
      {
        "topic_id": "notification_alerts",
        "topic_name": "Notifications & Alerts",
        "reviews": 424,
        "reviews_percentage": 0.0008857451435471169,
        "positive": 0.3472609039262595,
        "negative": 0.6527390960737405,
        "average_rating": 3.5872641509433962
      },
      {
        "topic_id": "translation_internationalization",
        "topic_name": "Translation & Internationalization",
        "reviews": 368,
        "reviews_percentage": 0.0007687599359088184,
        "positive": 0.4372787621348837,
        "negative": 0.5627212378651163,
        "average_rating": 3.6902173913043477
      },
      {
        "topic_id": "uninstall",
        "topic_name": "Uninstall",
        "reviews": 360,
        "reviews_percentage": 0.0007520477633890614,
        "positive": 0.5166101470081113,
        "negative": 0.48338985299188875,
        "average_rating": 2.7305555555555556
      },
      {
        "topic_id": "location_services",
        "topic_name": "Location Services",
        "reviews": 21,
        "reviews_percentage": 4.386945286436192e-5,
        "positive": 0.5692950272733673,
        "negative": 0.43070497272663266,
        "average_rating": 3.619047619047619
      },
      {
        "topic_id": "video",
        "topic_name": "Video",
        "reviews": 20,
        "reviews_percentage": 4.17804312993923e-5,
        "positive": 0.5677808251039376,
        "negative": 0.43221917489606243,
        "average_rating": 3.95
      }
    ],
    "number_topics": 18,
    "total_reviews": 478693
  },
  "review_analysis_6m": {
    "topics": [
      {
        "topic_id": "general_feedback",
        "topic_name": "General Feedback",
        "reviews": 10538,
        "reviews_percentage": 0.5857047576700756,
        "positive": 0.548835213691876,
        "negative": 0.45116478630812396,
        "average_rating": 4.1855190738280506
      },
      {
        "topic_id": "update",
        "topic_name": "Update",
        "reviews": 2559,
        "reviews_percentage": 0.14222987994664296,
        "positive": 0.6633367401821265,
        "negative": 0.3366632598178735,
        "average_rating": 3.4454865181711605
      },
      {
        "topic_id": "stability",
        "topic_name": "Stability",
        "reviews": 2322,
        "reviews_percentage": 0.12905735882614494,
        "positive": 0.5244562518346,
        "negative": 0.4755437481654,
        "average_rating": 3.1218776916451336
      },
      {
        "topic_id": "signup_experience",
        "topic_name": "Signup & Login",
        "reviews": 788,
        "reviews_percentage": 0.04379724321920854,
        "positive": 0.5258384623581446,
        "negative": 0.4741615376418554,
        "average_rating": 2.480964467005076
      },
      {
        "topic_id": "user_interface",
        "topic_name": "User Interface & UX",
        "reviews": 706,
        "reviews_percentage": 0.039239662072032014,
        "positive": 0.17700410022068164,
        "negative": 0.8229958997793183,
        "average_rating": 3.198300283286119
      },
      {
        "topic_id": "pricing_payments",
        "topic_name": "Pricing & Payments",
        "reviews": 422,
        "reviews_percentage": 0.023454868830591374,
        "positive": 0.6630980527165371,
        "negative": 0.3369019472834629,
        "average_rating": 3.7014218009478674
      },
      {
        "topic_id": "connectivity",
        "topic_name": "Connectivity",
        "reviews": 167,
        "reviews_percentage": 0.009281903068030235,
        "positive": 0.43746644308185556,
        "negative": 0.5625335569181444,
        "average_rating": 2.9161676646706587
      },
      {
        "topic_id": "resource_usage",
        "topic_name": "Resource Usage",
        "reviews": 104,
        "reviews_percentage": 0.005780346820809248,
        "positive": 0.4093909981699831,
        "negative": 0.590609001830017,
        "average_rating": 3.0673076923076925
      },
      {
        "topic_id": "advertising",
        "topic_name": "Advertising",
        "reviews": 104,
        "reviews_percentage": 0.005780346820809248,
        "positive": 0.9168595408773514,
        "negative": 0.08314045912264856,
        "average_rating": 4.615384615384615
      },
      {
        "topic_id": "audio",
        "topic_name": "Audio",
        "reviews": 83,
        "reviews_percentage": 0.0046131614050689196,
        "positive": 0.3391291827776505,
        "negative": 0.6608708172223495,
        "average_rating": 3.2289156626506026
      },
      {
        "topic_id": "translation_internationalization",
        "topic_name": "Translation & Internationalization",
        "reviews": 54,
        "reviews_percentage": 0.0030013339261894174,
        "positive": 0.4402584938974985,
        "negative": 0.5597415061025015,
        "average_rating": 3.240740740740741
      },
      {
        "topic_id": "uninstall",
        "topic_name": "Uninstall",
        "reviews": 48,
        "reviews_percentage": 0.0026678523788350376,
        "positive": 0.7590736922855635,
        "negative": 0.24092630771443646,
        "average_rating": 2.5
      },
      {
        "topic_id": "privacy",
        "topic_name": "Privacy & Security",
        "reviews": 47,
        "reviews_percentage": 0.002612272120942641,
        "positive": 0.4769866516566397,
        "negative": 0.5230133483433603,
        "average_rating": 2.9361702127659575
      },
      {
        "topic_id": "tutorial",
        "topic_name": "Tutorial",
        "reviews": 27,
        "reviews_percentage": 0.0015006669630947087,
        "positive": 0.8193066810127433,
        "negative": 0.1806933189872567,
        "average_rating": 4.111111111111111
      },
      {
        "topic_id": "device_compatibility",
        "topic_name": "Device Compatibility",
        "reviews": 23,
        "reviews_percentage": 0.0012783459315251222,
        "positive": 0.5622506514346284,
        "negative": 0.4377493485653716,
        "average_rating": 3.3043478260869565
      }
    ],
    "number_topics": 15,
    "total_reviews": 17992
  }
}

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: